实战背景
在 2026 年的 AI 浪潮中,DeepSeek-R1 (Reasoner) 已成为逻辑推理的标配。然而,在 OpenClaw 正式版中接入 DeepSeek 并非"填个 Key"那么简单。本文将复盘从 CLI 配置 到解决 API 欠费锁定的全过程。
🛠️ 第一步:开启交互式配置
在阿里云终端执行 OpenClaw 的核心配置指令。2026 版采用了更加模块化的菜单:
Bash
openclaw configure
配置路径图:
- Sections: 移动光标至
Model,按空格选中,移至Continue回车。 - Action: 选择
Add a new provider。 - Type: 选择
OpenAI Compatible(DeepSeek 完美兼容该协议)。 - Name: 输入
DeepSeek。
🎯 第二步:模型点兵 (V3 与 R1 的抉择)
在模型选择界面,OpenClaw 2026 支持多选。建议"双持"以应对不同场景:
deepseek-chat(V3):日常对话、文案生成,响应极快。deepseek-reasoner(R1):复杂逻辑、代码审计,支持"深度思考"过程展示。
💡 避坑笔记:
在列表里使用
↑/↓切换,按Tab或空格勾选(确保方框变为实心◼),最后按Enter确认。
🔑 第三步:关键参数录入
请务必确保以下信息准确无误,不要带多余空格:
- Base URL:
https://api.deepseek.com - API Key: 填入你的
sk-xxx。 - Default Model: 建议设为
deepseek-chat以节省 Token。
保存后必须执行:
Bash
# 重启网关以加载新模型
sudo systemctl restart openclaw-gateway
⚠️ 第四步:解决"最后的阻碍"
1. 账单错误 (Billing Error)
如果界面弹出:returned a billing error --- insufficient balance。
- 原因: DeepSeek 账户余额不足或体验额度过期。
- 对策: 登录 DeepSeek 平台 充值(建议 10 元起步,2026 年的 DeepSeek 依然极具性价比)。
- 注意: 充值后无需重启 OpenClaw,等待 1 分钟同步即可恢复正常。
2. 设备配对 (Pairing Required)
如果是第一次从新设备(浏览器)登录,系统会强制要求配对。
Bash
# 1. 查看待审批 Request ID
openclaw devices list
# 2. 授权你的设备
openclaw devices approve <REQUEST_ID>
🚀 成果展示:开启"深度思考"
配置成功后,刷新 OpenClaw Dashboard。
- 在对话框左下角切换至
DeepSeek Reasoner。 - 输入一个逻辑难题,例如:"如何优化 2026 年的高并发架构?"
- 2026 版特效: 你将看到 OpenClaw 界面展示出 R1 模型的思维链(Thought Chain),这是本地化部署最解压的时刻。
🛠️ 常见配置清单 (Quick Fix)
| 场景 | 命令 / 操作 |
|---|---|
| 忘记 Token | `cat ~/.openclaw/openclaw.json |
| 更换 API Key | openclaw configure -> Model -> Update provider |
| 强制重新配对 | openclaw gateway secret --reset |
| 检查连通性 | openclaw health |
结语: 至此,你已在阿里云上拥有了一个完全私有、性能顶级的 AI 工作台。2026 年,算力虽贵,但开源与私有化部署让我们依然拥有掌控感!