OpenClaw 连接 DeepSeek 完整图文实操教程
一、前置准备
在开始接入配置前，请提前核对并完成所有前置条件，避免出现配置成功但无法调用模型的问题：
- 已安装并可正常启动、运行 OpenClaw Windows 客户端。
- OpenClaw 顶部 Gateway 状态保持在线，无离线、异常报错。
- 电脑网络正常，可稳定访问 DeepSeek 开放平台官网。
- 拥有可正常接收验证码的手机号或可扫码登录的微信账号。
- DeepSeek 开放平台账号已完成实名认证。
- DeepSeek 账户内拥有可用余额，保证模型可正常调用。
二、详细图文接入步骤
步骤 1：打开 DeepSeek 开放平台并登录账号
打开浏览器，进入 DeepSeek 开放平台官方地址：https://platform.deepseek.com/
进入官网后，可选择手机号验证码登录或微信扫码登录，完成账号登录。
步骤 2：完成账号实名认证（必做）
登录成功后，进入个人信息页面，查看账号实名认证状态。
若账号未完成实名认证，必须先完成认证，否则将无法正常创建密钥、充值及调用 AI 模型接口，是接入的核心前置条件。
）
步骤 3：检查账户余额，按需充值
进入平台用量信息页面，查看当前账户可用余额。
若余额不足，点击去充值完成余额充值。避免出现 OpenClaw 测试连接成功，但实际无法对话、调用模型的情况。
步骤 4：进入 API Keys 页面，创建密钥
在 DeepSeek 开放平台左侧菜单栏中，点击 API keys 选项。
若无历史密钥，点击页面对应按钮 创建 API key，进入密钥创建流程。
步骤 5：填写名称并确认创建密钥
在弹出的创建窗口中，在名称输入框填写自定义名称，方便后续识别密钥用途。
推荐填写：OpenClaw、OpenClaw测试使用 等自定义备注名称，便于后期管理区分。
填写完成后，点击创建即可生成专属密钥。
步骤 6：立即复制并保存 API Key（关键步骤）
密钥创建成功后，页面会弹出密钥详情窗口，请立即点击复制，完整保存密钥。
重要提醒：DeepSeek API Key 创建后仅首次弹窗展示完整内容，关闭窗口后无法再次查看完整密钥，未保存只能重新创建。
步骤 7：OpenClaw 配置密钥并测试连通性
返回 OpenClaw 客户端，按以下步骤完成配置：
- 点击客户端右上角 设置
- 在左侧菜单栏选择 模型配置
- 找到 DeepSeek 配置卡片
- 粘贴刚刚复制的完整 DeepSeek API Key
- 点击 测试，等待提示测试成功
- 最后点击右上角 保存全部配置
测试成功后，软件将自动识别平台可用的 DeepSeek 系列模型。
步骤 8：选择 DeepSeek 模型并开始对话
配置保存完成后，进入 OpenClaw 左侧 聊天页面。
在顶部模型选择框中搜索 deepseek，选择带有 deepseek 官方标签的模型即可使用，推荐常用模型：
- deepseek-chat（通用对话模型，适配绝大多数场景）
- deepseek-v4-flash（极速响应，轻量对话首选）
- deepseek-v4-pro（高阶推理，复杂问题、深度分析首选）
选中模型后，发送消息即可正常 AI 对话测试。
三、接入完成自检清单
逐项核对，确保配置无遗漏、可稳定使用：
- ✅ 成功登录 DeepSeek 开放平台，账号状态正常
- ✅ 账号已完成实名认证，无认证缺失问题
- ✅ 账户余额充足，已完成充值或本身有可用额度
- ✅ 成功创建专属 DeepSeek API Key
- ✅ 已完整复制、妥善保存密钥
- ✅ OpenClaw 中正确粘贴 DeepSeek 密钥
- ✅ 密钥测试通过，客户端成功识别可用模型
- ✅ 已保存全部配置参数
- ✅ 聊天页面成功选中 DeepSeek 系列模型
四、常见问题解答
- 为什么必须完成实名认证？
DeepSeek 开放平台的密钥创建、接口调用、余额充值等核心功能，均依赖实名认证账号。未完成实名认证的账号会被限制权限，无法正常创建密钥和调用 AI 模型，是接入的硬性要求。 - 测试成功但无法正常使用模型怎么办？
优先排查以下高频问题：
- 检查 DeepSeek 账户余额是否充足，无欠费、无额度耗尽
- 核对 API Key 是否完整复制，无截断、无多余空格、无字符缺失
- 确认修改配置后已点击「保存全部配置」
- 确认聊天页面选中的是带 deepseek 官方标签的有效模型
- API Key 关闭弹窗后还能查看完整密钥吗？
无法查看。DeepSeek 为保障账号安全，仅在创建密钥的弹窗中展示一次完整密钥。若未及时复制保存，只能删除旧密钥，重新创建新的 API Key 进行配置。 - OpenClaw 优先选择哪个 DeepSeek 模型？
日常闲聊、简单问答优先选择 deepseek-v4-flash，响应速度快、性价比高；文案创作、逻辑推理、数据分析等复杂场景，优先选择 deepseek-v4-pro；通用场景可直接使用 deepseek-chat。
五、官方参考地址
DeepSeek 开放平台官网：https://platform.deepseek.com/
openclaw一键安装包如下图获取：
