OpenClaw使用DeepSeek官方API_KEY配置超详细教程

目录

• 前言
• 系统要求
• 安装 OpenClaw
• 1. 全局安装 OpenClaw
• 2. 验证安装
• 初始化配置
• 1. 运行配置向导
• 2. 检查服务状态
• 配置 DeepSeek 官方 API
• 1. 获取 DeepSeek API Key
• 2. 配置 DeepSeek 提供商
• 3. 设置默认模型
• 4. 创建模型别名（可选）
• 5. 重启 Gateway 服务
• 测试与使用
• 1. 命令行测试
• 2. 打开 Web 控制面板
• 3. 查看配置状态
• 常用命令
• 服务管理
• 模型管理
• 对话交互
• 配置管理
• 故障排除
• 问题 1: Gateway Token 错误
• 问题 2: 模型不可用
• 问题 3: API Key 无效
• 问题 4: 连接超时
• 问题 5: Gateway 无法启动
• 高级配置
• 配置备用模型
• 配置环境变量
• 配置工作空间
• 相关资源

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

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

npm install -g openclaw@latest

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

openclaw --version

应该显示类似：🦞 OpenClaw 2026.2.9

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

说明:

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

openclaw status

确认 Gateway 服务正在运行。

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

API Key 格式类似：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

执行以下命令（将 你的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)"
    }
  ]
}'

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

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

openclaw gateway restart

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

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

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

openclaw dashboard

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

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

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

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

解决方法:

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

或手动获取 token：

openclaw config get gateway.auth.token

错误信息: Unknown model: xxx

解决方法:

1. 检查模型配置：

   openclaw models status

2. 确认模型 ID 正确：

   openclaw models list --all | grep deepseek

3. 重启 Gateway：

   openclaw gateway restart

错误信息: HTTP 401 或 Unauthorized

解决方法:

1. 验证 API Key 是否正确
2. 检查 API Key 是否过期
3. 重新配置提供商：

   openclaw config set models.providers.deepseek.apiKey "新的API_KEY"
   openclaw gateway restart

错误信息: 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

解决方法:

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

到此这篇关于OpenClaw使用DeepSeek官方API_KEY配置超详细教程的文章就介绍到这了,更多相关OpenClaw配置DeepSeek官方API_KEY内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！