OpenClaw 使用 DeepSeek 官方 API_KEY 配置教程

找遍全网也没找到如何在openclaw配置deepseek官方apikey，那我自己整一个，以下内容为Claude Code根据我的聊天记录总结生成，希望对想在openclaw使用deepseek官方apikey的人提供帮助。

目录

1. 系统要求
2. 安装 OpenClaw
3. 初始化配置
4. 配置 DeepSeek 官方 API
5. 测试与使用
6. 常用命令
7. 故障排除

---

系统要求

• 操作系统: macOS / Linux / Windows (WSL)
• Node.js: 版本 22+ (推荐使用 nvm 管理)
• 网络: 需要访问 DeepSeek API (api.deepseek.com)

---

安装 OpenClaw

1. 全局安装 OpenClaw

npm install -g openclaw@latest

安装过程可能需要 3-5 分钟，会下载约 674 个依赖包。

2. 验证安装

openclaw --version

应该显示类似：🦞 OpenClaw 2026.2.9

---

初始化配置

1. 运行配置向导

openclaw onboard --install-daemon --non-interactive --accept-risk

说明:

• --install-daemon: 安装后台服务
• --non-interactive: 非交互模式
• --accept-risk: 接受安全风险声明

2. 检查服务状态

openclaw status

确认 Gateway 服务正在运行。

---

配置 DeepSeek 官方 API

1. 获取 DeepSeek API Key

访问 DeepSeek 官网 注册并获取 API Key。

API Key 格式类似：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. 配置 DeepSeek 提供商

执行以下命令（将 你的API_KEY 替换为实际的 API Key）：

openclaw config set models.providers.deepseek '{ "baseUrl": "https://api.deepseek.com/v1", "apiKey": "你的API_KEY", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat (V3)" }, { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner (R1)" } ] }'

3. 设置默认模型

openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"

配置方法二：

找到配置文件

安装完成后，我们需要配置自己的 AI 模型。配置文件位于：

C:\Users\你的用户名\.openclaw\openclaw.json

{
  "auth": {
    "profiles": {
      "deepseek:default": {
        "provider": "deepseek",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "修改为自己的 API KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      },
      "models": {
        "deepseek/deepseek-chat": {
          "alias": "DeepSeek Chat"
        }
      }
    }
  }
}

4. 创建模型别名（可选）

openclaw models aliases add deepseek-v3 "deepseek/deepseek-chat" openclaw models aliases add deepseek-r1 "deepseek/deepseek-reasoner"

5. 重启 Gateway 服务

openclaw gateway restart

等待 3-5 秒让服务完全启动。

---

测试与使用

1. 命令行测试

openclaw agent --session-id test --message "你好，请介绍一下你自己"

如果配置成功，DeepSeek 会用中文回复。

2. 打开 Web 控制面板

openclaw dashboard

浏览器会自动打开控制面板，URL 格式：

http://127.0.0.1:18789/#token=你的gateway_token

3. 查看配置状态

openclaw models status

应该显示：

• Default: deepseek/deepseek-chat
• Configured models: 包含 deepseek 模型

---

常用命令

服务管理

# 启动 Gateway openclaw gateway # 重启 Gateway openclaw gateway restart # 停止 Gateway openclaw gateway stop # 查看服务状态 openclaw status # 查看详细状态 openclaw status --all # 查看实时日志 openclaw logs --follow

模型管理

# 列出所有可用模型 openclaw models list --all # 查看当前模型配置 openclaw models status # 切换模型（在聊天中使用） /model deepseek-v3 # 设置默认模型 openclaw config set agents.defaults.model.primary "模型ID" # 添加模型别名 openclaw models aliases add 别名 "模型ID" # 查看所有别名 openclaw models aliases list

对话交互

# 发送单条消息 openclaw agent --session-id 会话ID --message "你的问题" # 指定超时时间（秒） openclaw agent --session-id test --message "问题" --timeout 60 # 使用本地模式（不通过 Gateway） openclaw agent --local --session-id test --message "问题"

配置管理

# 查看配置 openclaw config get 配置路径 # 设置配置 openclaw config set 配置路径 "值" # 删除配置 openclaw config unset 配置路径 # 运行配置向导 openclaw configure

---

故障排除

问题 1: Gateway Token 错误

错误信息: disconnected (1008): unauthorized: gateway token missing

解决方法:

# 打开带 token 的控制面板 openclaw dashboard

或手动获取 token：

openclaw config get gateway.auth.token

问题 2: 模型不可用

错误信息: Unknown model: xxx

解决方法:

1. 检查模型配置：

   openclaw models status

2. 确认模型 ID 正确：

   openclaw models list --all | grep deepseek

3. 重启 Gateway：

   openclaw gateway restart

问题 3: API Key 无效

错误信息: HTTP 401 或 Unauthorized

解决方法:

1. 验证 API Key 是否正确
2. 检查 API Key 是否过期
3. 重新配置提供商：
   openclaw config set models.providers.deepseek.apiKey "新的API_KEY" openclaw gateway restart

问题 4: 连接超时

错误信息: Request timed out 或 No reply from agent

解决方法:

1. 检查网络连接
2. 测试 DeepSeek API 可达性：
   curl -I https://api.deepseek.com/v1/models
3. 增加超时时间：
   openclaw agent --session-id test --message "测试" --timeout 120

问题 5: Gateway 无法启动

解决方法:

1. 检查端口占用：

   lsof -i :18789

2. 强制重启：

   openclaw gateway --force

3. 查看日志：

   openclaw logs

4. 运行诊断：

   openclaw doctor openclaw doctor --fix

---

高级配置

配置备用模型

当主模型不可用时，自动切换到备用模型：

openclaw config set agents.defaults.model.fallbacks '["deepseek/deepseek-reasoner"]'

配置环境变量

将以下内容添加到 ~/.zshrc 或 ~/.bashrc：

# DeepSeek API Key (可选，如果已在配置文件中设置) export DEEPSEEK_API_KEY="你的API_KEY" # OpenClaw Gateway Token (可选) export OPENCLAW_TOKEN="你的gateway_token"

然后重新加载配置：

source ~/.zshrc # 或 source ~/.bashrc

配置工作空间

openclaw config set agents.defaults.workspace "/自定义/工作空间/路径"

---

相关资源

• OpenClaw 官方文档: docs.openclaw.ai/
• DeepSeek 官网: platform.deepseek.com/
• DeepSeek API 文档: platform.deepseek.com/api-docs/
• OpenClaw GitHub: github.com/anthropics/…

提示: 如果遇到其他问题，可以运行 openclaw doctor --deep 进行深度诊断，或访问官方文档获取更多帮助。