OpenClaw 使用 DeepSeek 官方 API_KEY 配置教程

华生我发现了盲点
127 阅读4分钟

前言

找遍全网也没找到如何在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"

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 doctor --deep 进行深度诊断，或访问官方文档获取更多帮助。

avatar
文章
阅读
粉丝