OpenClaw API 密钥申请与配置教程

安装好 OpenClaw 之后，第一个拦住新手的问题通常是：API 密钥从哪里来？怎么填进去？本文把三大主流模型提供商的 API Key 申请流程和配置方法全部整理清楚，跟着做就能搞定。

什么是 API 密钥？为什么 OpenClaw 需要它？

OpenClaw 本身是一个 AI Agent 框架，它不内置任何 AI 模型。每次需要 AI 推理（理解你的消息、生成回复、规划任务步骤），OpenClaw 都要向外部大模型发送请求。

API 密钥（API Key）就是这个连接的”通行证”——它告诉模型提供商”这个请求来自我的账号，请处理并计费”。没有有效的 API Key，OpenClaw 无法运行任何 AI 功能。

三大主流提供商对比

提供商	推荐模型	适合场景	计费方式	国内可直接访问
Anthropic（Claude）	Claude Sonnet 4.6	日常 Agent 任务首选	按 Token 付费	❌（需要特殊网络）
OpenAI（GPT）	GPT-5.2	多模态、语音场景	按 Token 付费	❌（需要特殊网络）
DeepSeek	DeepSeek Chat	中文场景、低成本	按 Token 付费	✅（国内可直接访问）

方案一：申请 Anthropic Claude API Key（推荐）

Claude 是 OpenClaw 社区最推荐的模型，工具调用最稳定。

第一步：注册 Anthropic 账号

访问 console.anthropic.com
点击”Sign up”，使用邮箱注册（支持 Gmail、企业邮箱等）
完成邮箱验证
根据提示完成账号信息填写（姓名、使用用途等）

第二步：添加付款方式

Anthropic API 需要绑定信用卡才能使用（支持 Visa、Mastercard 等国际信用卡，不接受中国大陆的银联卡）：

登录后点击右上角账号 → Billing
点击”Add payment method”，填写信用卡信息
建议设置用量限制（Spending Limit）避免意外超支：在 Billing 页面找到”Usage limits”，设置月度上限

第三步：创建 API Key

在左侧菜单点击 Settings → API Keys（或直接访问 console.anthropic.com/settings/keys）
点击 “Create Key”
为 Key 命名（如”openclaw-main”，方便日后识别）
点击”Create API Key”，系统显示密钥（格式：sk-ant-api03-...）
立即复制并保存到安全位置——密钥只显示一次，关闭弹窗后无法再查看原始值

💡 建议：为 OpenClaw 创建一个专用的 API Key，不要和其他应用共用。这样一旦密钥泄露，只需撤销这一个 Key，不影响其他服务。

方案二：申请 OpenAI API Key

第一步：注册 OpenAI 账号

访问 platform.openai.com
点击”Sign up”注册，支持 Google 账号、微软账号或邮箱注册
完成手机号验证（需要境外手机号）

第二步：充值账户

登录后进入 Settings → Billing
点击”Add to credit balance”，填写信用卡信息并充值（最低 $5）
注意：OpenAI API 与 ChatGPT Plus 订阅是两套独立的计费系统，ChatGPT 订阅费不能用于 API 调用

第三步：创建 API Key

在左侧菜单点击 API Keys（或访问 platform.openai.com/api-keys）
点击 “Create new secret key”
命名并创建，密钥格式：sk-proj-...
立即复制保存

方案三：申请 DeepSeek API Key（国内首选）

DeepSeek 是国产大模型，国内可直接访问，价格大幅低于 Claude 和 GPT，中文理解能力出色，非常适合国内用户作为主力或补充模型。

第一步：注册 DeepSeek 开放平台账号

访问 DeepSeek 开放平台（搜索”DeepSeek 开放平台”或访问 platform.deepseek.com）
点击”注册”，使用手机号注册（支持国内手机号）
完成短信验证码验证

第二步：充值

DeepSeek API 支持支付宝和微信支付，按量付费，充值门槛低。在账户页面充值适量金额即可开始使用。

第三步：创建 API Key

登录后进入 API Keys 页面
点击”创建 API Key”，命名后生成
密钥格式：sk-...
复制保存

在 OpenClaw 中配置 API Key

API Key 申请好之后，有三种方式配置到 OpenClaw 中，安全性从高到低排列：

方式一：环境变量（最推荐，最安全）

将 API Key 存储在环境变量中，OpenClaw 配置文件中只引用变量名，不包含实际密钥值。即使配置文件意外泄露，密钥也是安全的。

在 ~/.zshrc（macOS/zsh）或 ~/.bashrc（Linux/bash）中添加：

# Anthropic Claude
export ANTHROPIC_API_KEY="sk-ant-api03-你的密钥"

# OpenAI GPT（可选）
export OPENAI_API_KEY="sk-proj-你的密钥"

# DeepSeek（可选）
export DEEPSEEK_API_KEY="sk-你的密钥"

保存后执行 source ~/.zshrc（或 source ~/.bashrc）使其立即生效。

然后在 ~/.openclaw/openclaw.json 中用变量引用：

{
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "${ANTHROPIC_API_KEY}"
      },
      "openai": {
        "apiKey": "${OPENAI_API_KEY}"
      },
      "deepseek": {
        "apiKey": "${DEEPSEEK_API_KEY}"
      }
    }
  }
}

方式二：通过引导向导配置（最简单）

如果你还没有运行过 openclaw onboard，引导向导会在配置过程中直接提示你输入 API Key，自动写入配置文件：

openclaw onboard

选择大模型提供商后，在提示处粘贴你的 API Key 并按回车。

方式三：通过 CLI 命令直接写入

如果已经配置过 OpenClaw，想添加新的 API Key：

# 配置 Anthropic API Key
openclaw config set models.providers.anthropic.apiKey "sk-ant-api03-你的密钥"

# 配置 DeepSeek API Key
openclaw config set models.providers.deepseek.apiKey "sk-你的密钥"

# 重启 Gateway 使配置生效
openclaw gateway restart

⚠️ 安全提示：CLI 命令会将密钥以明文写入 ~/.openclaw/openclaw.json。建议写入后检查文件权限，并考虑改用环境变量方案。

方式四：通过控制面板配置

打开浏览器访问 http://127.0.0.1:18789，进入控制面板的 Settings → Providers，在图形界面中填写 API Key，无需手动编辑文件。

验证 API Key 是否配置成功

# 检查模型连接状态
openclaw models status

# 查看可用模型列表
openclaw models list

# 完整健康检查
openclaw doctor

如果 openclaw models status 输出显示模型状态为 available，说明 API Key 配置正确且可以正常调用。

也可以直接发送一条测试消息：

openclaw agent --message "你好，请用一句话介绍自己"

收到 AI 回复即表示配置完全成功。

API Key 的安全管理

保护好你的 API Key

永远不要分享 API Key：API Key 等同于账号密码，泄露后他人可用你的账号调用 AI，消耗你的额度
不要上传到 GitHub：将 .openclaw 目录添加到 .gitignore，避免意外提交
设置文件权限：

chmod 600 ~/.openclaw/openclaw.json
chmod 700 ~/.openclaw/credentials/

定期检查密钥是否泄露：

grep -r "sk-ant" ~/.openclaw/   # 检查明文 Anthropic Key
grep -r "sk-proj" ~/.openclaw/  # 检查明文 OpenAI Key

如果有输出，说明密钥以明文存储在文件中，建议改用环境变量方案。

密钥泄露了怎么办？

立即行动：

登录对应提供商的控制台，找到泄露的 API Key，立即撤销（Revoke）
检查 API 使用记录，确认是否有异常调用
创建新的 API Key，更新 OpenClaw 配置
如果账单异常，联系提供商客服说明情况

设置用量限制防止超支

各提供商都提供用量限制功能，强烈建议设置：

Anthropic：Billing → Usage limits → 设置月度支出上限
OpenAI：Settings → Limits → Hard limit（硬上限）和 Soft limit（软预警）
DeepSeek：账户页面设置消费限额

建议初次使用时将月度限额设为 $10～$20，熟悉使用量后再调整。

完整配置示例

以下是同时配置 Claude、GPT 和 DeepSeek 三个提供商，并设置智能备用的完整示例：

{
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "${ANTHROPIC_API_KEY}"
      },
      "openai": {
        "apiKey": "${OPENAI_API_KEY}"
      },
      "deepseek": {
        "apiKey": "${DEEPSEEK_API_KEY}"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": [
          "openai/gpt-5.2",
          "deepseek/deepseek-chat"
        ]
      },
      "heartbeat": {
        "model": "deepseek/deepseek-chat"
      }
    }
  }
}

这个配置实现了：主对话用 Claude Sonnet（最稳定），Claude 限流时自动切换 GPT（备用），GPT 也不可用时切换 DeepSeek（最终保底），Heartbeat 心跳任务统一用 DeepSeek（最省钱）。

常见问题

Q：API Key 输入后提示 401 Invalid API Key 怎么办？
检查密钥是否完整复制（没有多余空格或缺失字符），以及账户是否已激活付款方式。

Q：API Key 没有问题但调用时报 429 Rate Limit 怎么办？
账户余额不足或调用频率超过限制。检查账户余额，或在配置中降低并发调用数量：

openclaw config set agents.defaults.maxConcurrent 2

Q：国内无法访问 Anthropic/OpenAI 接口怎么办？
这两个提供商在中国大陆需要特殊网络配置才能访问。如果无法解决网络问题，建议优先使用 DeepSeek（国内可直接访问），或使用 Ollama 本地模型（零网络依赖）。

更多配置细节，访问 OpenClaw官网中文版（通过浏览器翻译访问 openclaw.ai）或官方配置文档。

本文内容基于各大模型提供商官方文档整理，信息截至2026年3月28日。具体界面和流程以各平台最新版本为准。