OpenClaw 使用 DeepSeek 官方 API Key 配置教程

本文介绍如何在 OpenClaw 中接入 DeepSeek 官方 API，并完成模型配置与默认模型设置。

一、环境准备

• 操作系统：macOS / Linux / Windows（WSL）
• Node.js：22 及以上版本
• 可访问 https://api.deepseek.com

检查 Node 版本：

node -v

二、安装 OpenClaw

npm install -g openclaw@latest

验证安装：

openclaw --version

三、初始化 OpenClaw

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

查看运行状态：

openclaw status

四、获取 DeepSeek API Key

1. 登录 DeepSeek 官方平台
2. 创建 API Key
3. 复制形如：

sk-xxxxxxxxxxxxxxxxxxxxxxxx

五、配置 DeepSeek 提供商

执行：

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)" }
  ]
}'

说明：

• baseUrl：DeepSeek API 地址
• apiKey：替换为你的真实 Key
• api：兼容 OpenAI 接口
• 定义了两个模型

六、设置默认模型

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

九、测试是否成功

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

如果返回 DeepSeek 模型响应内容，则配置成功。

十、常用命令

查看模型状态：

openclaw models status

查看所有模型：

openclaw models list --all

切换模型（会话中）：

/model deepseek-v3

查看实时日志：

openclaw logs --follow

十一、常见问题

1. 401 错误

• 检查 API Key 是否正确
• 确认已重启 gateway

2. 模型不可用

openclaw models list --all | grep deepseek

十二、推荐做法（环境变量）

在 ~/.bashrc 或 ~/.zshrc 中添加：

export DEEPSEEK_API_KEY="你的API_KEY"

重新加载：

source ~/.bashrc

结语

完成以上步骤后，即可在 OpenClaw 中使用 DeepSeek 官方模型进行对话与推理任务。