周红伟：OpenClaw企业级部署，OpenClaw 使用 DeepSeek 官方 API_KEY 配置教程

OpenClaw 使用 DeepSeek 官方 API_KEY 配置教程

说来也巧，找遍全网都没发现如何在OpenClaw里配置DeepSeek官方API_KEY的详细指南。既然找不到现成的，那就自己动手整理一份。以下内容基于实际操作记录整理而成，希望能帮到那些想在OpenClaw中使用DeepSeek官方API的朋友们。

目录

系统要求

安装 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

参数说明：

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

正常情况下会显示：

常用命令

服务管理

# 启动 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

解决步骤：

先检查模型配置：

openclaw models status

确认模型ID是否正确：

openclaw models list --all | grep deepseek

重启Gateway服务：

openclaw gateway restart

问题 3: API Key 无效

错误信息: HTTP 401 或 Unauthorized

排查方法：

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

问题 4: 连接超时

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

处理方案：

curl -I https://api.deepseek.com/v1/models 增加超时时间：

openclaw agent --session-id test --message "测试" --timeout 120

问题 5: Gateway 无法启动

解决方案：

检查端口占用情况：

lsof -i :18789

强制重启服务：

openclaw gateway --force

查看详细日志：

openclaw logs

运行系统诊断：

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 进行深度诊断，或者访问官方文档获取更多技术支持。