OpenClaw v2.7.9 接入 DeepSeek 大模型图文配置教程
部署资源地址
Windows 整合安装包:https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
MacOS 整合安装包:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
安装包体积:45.8MB
前期所需准备条件
- 本地设备已完整部署 OpenClaw v2.7.9,程序可正常启动运行;
- OpenClaw 界面顶部 Gateway 服务保持在线状态,保障模型连通;
- 电脑网络通畅,能够正常访问 DeepSeek 开放平台网页;
- 准备可接收短信验证码的手机号或微信账号,用于平台登录;
- DeepSeek 平台账号完成实名核验,账户内留存充足可用额度。
完整图文操作流程
步骤 1:访问 DeepSeek 开放平台完成账号登录
打开 DeepSeek 开放平台网页:https://platform.deepseek.com/ 页面加载完毕后,可选用手机短信验证码登录,或是微信扫码两种方式完成账号登入。
步骤 2:完成账号实名认证流程
登录成功跳转个人信息页面,先查看实名核验状态。 若账号尚未完成实名认证,需要先提交资料完成核验,再进行后续 API 相关配置操作。
步骤 3:核对账户可用额度,按需充值
切换至用量统计页面查看账户剩余额度,若余额不足以支撑模型调用,点击充值入口完成额度补充,避免配置完成后无法正常发起对话请求。
步骤 4:进入密钥管理页面新建 API 凭证
在页面左侧导航栏选中 API keys 功能分区,若当前无可用访问密钥,点击创建 API key 按钮开启生成流程。
步骤 5:自定义密钥标识并确认生成
弹出创建弹窗后,在名称输入框填写便于区分的标识文字,例如 OpenClaw、日常测试等自定义名称,填写完成点击创建按钮生成密钥。
步骤 6:即时复制并妥善存储 API 密钥
密钥生成后会弹出完整凭证弹窗,此时立即点击复制按钮保存密钥文本。 平台仅在创建弹窗完整展示密钥内容,页面刷新后无法查看完整字符,务必第一时间备份。
步骤 7:回到 OpenClaw 填写密钥并连通校验
切换至 OpenClaw v2.7.9 客户端执行配置:
- 点击界面右上角设置按钮;
- 左侧菜单栏选择模型配置板块;
- 在列表中找到 DeepSeek 配置项;
- 将复制的 API 密钥粘贴至输入框;
- 点击测试按钮校验连通状态;
- 校验无报错后,点击右上角保存全部配置。 校验通过后客户端会自动识别平台内可用 DeepSeek 系列模型。
步骤 8:对话页面切换 DeepSeek 模型交互
进入 OpenClaw 左侧对话分区,在模型下拉筛选框检索 deepseek 关键词,可选用下述模型开展对话: deepseek-chat、deepseek-v4-flash、deepseek-v4-pro 选定对应模型后,即可下发指令体验大模型推理能力。
接入完成自检核对清单
配置结束后可对照以下条目逐项检查,规避隐性连通故障:
- 成功登录 DeepSeek 开放平台个人账户;
- 账号已完成平台实名认证操作;
- 账户留存充足可用调用额度;
- 新建专属 API 访问密钥并完整备份;
- OpenClaw 模型栏准确粘贴密钥文本;
- 密钥连通测试显示正常无报错;
- 全部模型配置参数已保存生效;
- 对话页面成功选中 DeepSeek 系列模型。
高频异常问题处理方案
1. 配置前为何必须完成实名认证?
DeepSeek 开放平台绝大多数 API 调用能力均绑定实名账号,未完成核验的账号无法创建密钥、充值额度、发起模型请求,会导致整套配置流程中断。
2. 密钥测试正常,但对话无法发起是什么原因?
按照顺序逐项排查对应问题:
- 核查账户剩余调用额度是否充足;
- 核对粘贴的 API 密钥是否存在多余空格、字符缺失;
- 确认配置修改后点击保存全部配置;
- 检查对话页面是否选中 deepseek 标识的模型; 排查完毕仍异常,可重启 OpenClaw 或 Gateway 服务重试。
3. 密钥创建后能否再次查看完整字符?
平台设计仅在创建弹窗展示完整密钥,关闭弹窗后无法调取完整凭证,建议生成时立刻复制备份,遗失只能重新创建新密钥。
4. OpenClaw 内优先选择哪款 DeepSeek 模型?
日常轻量对话可选用 deepseek-v4-flash,响应速度更快;复杂逻辑推理、长文本创作可选用 deepseek-v4-pro;通用基础问答选用 deepseek-chat 即可。
平台参考访问链接
DeepSeek 开放平台官网:https://platform.deepseek.com/