本文依据2026-11-11核对的官方文档整理,未做本地安装实测;命令与界面以对应版本为准。本文以 OpenClaw 的 DeepSeek 服务商插件为例,说明从获取参数到检查模型状态的流程。

开始前:先准备好运行环境和账号

先完成 OpenClaw 安装与启动,并准备 DeepSeek API 账号与 API Key。这里配置的是模型服务,不是飞书、Telegram 等消息渠道;模型接通后,渠道仍需单独配置。

先分清下面四个概念,避免把服务商名称、接口地址和模型名称填在同一处:

项目 本例中的含义 核对位置
Provider OpenClaw 用来识别服务商的 deepseek OpenClaw 官方 DeepSeek 文档
API Key 对模型服务发起请求的凭证 DeepSeek 官方控制台
Base URL 模型请求的接口入口,官方文档列为 https://api.deepseek.com 当前服务商文档
模型引用 包含服务商的模型标识,例如 deepseek/… 当前插件提供的模型列表

DEEPSEEK_API_KEY 是环境变量名称,不是密钥本身。下文中的 YOUR_API_KEY 也是占位符,实际配置时需在自己的可信环境中替换。

第一步:安装官方服务商插件

在运行 OpenClaw 的机器上执行:

openclaw plugins install @openclaw/deepseek-provider

插件安装后的生效方式应按自己使用的 OpenClaw 版本检查:官方英文与部分本地化文档对是否需要重启的说明存在差异。安装完成后先检查当前状态,并按对应版本的插件管理说明操作,不把“安装命令结束”等同于“运行中的 Gateway 已完成加载”。若命令不能识别,先核对版本,不反复安装未知插件。

第二步:使用引导保存密钥与模型配置

执行官方交互配置命令:

openclaw onboard --auth-choice deepseek-api-key

按提示输入自己的 API Key。所参考的文档版本说明,这个引导会设置默认模型;模型名称会随版本变化,以引导结果和下一步查询到的列表为准,不从其他教程复制旧模型名。

如果此前已经配置过其他服务商,应检查引导结束后的模型状态,确认当前选择符合预期。本文采用官方插件与交互引导路线,不需要再粘贴一份来源不明的完整 JSON 配置。

第三步:区分“列出模型”与“调用成功”

查看 DeepSeek 服务商的模型列表:

openclaw models list --provider deepseek

如果 Gateway 尚未运行,只想查看插件的静态目录,官方提供:

openclaw models list --all --provider deepseek

预期结果:能检查到该插件提供的模型条目。静态目录里有模型,不等于账号已通过认证,也不证明实际调用成功。 继续检查当前模型状态:

openclaw models status

然后在已经配置好的聊天入口发送一条简短消息,例如“只回复:连接检查”。收到回复后,再用一个公开文本整理任务检查实际输出;一次普通对话也不能代替对工具任务的验证。

常见问题:终端里有密钥,后台却读不到

在当前终端设置环境变量,不代表 systemd 或 launchd 启动的后台 Gateway 能读取同一环境。若手动管理凭证,官方认证文档给出的保存位置包括 Gateway 主机上的 ~/.openclaw/.env。

例如文件中的变量形式为:

DEEPSEEK_API_KEY=YOUR_API_KEY

编辑时保留文件中已有的其他配置,不要把整个文件覆盖成这一行;也不要把真实密钥提交到代码仓库。若选择前面的交互引导,则由引导处理相应保存步骤,不必重复使用多条不一致的配置路线。

官方认证文档要求手动修改后台进程使用的凭证后,重启相应 Gateway 进程,再检查:

openclaw models status
openclaw doctor

出错后怎样验证修复

出现认证错误时,先核对密钥是否属于这个服务商、是否有效,以及后台进程实际读取的位置。出现模型相关错误时,对照当前插件列表检查模型标识;不要把其他产品页面上的展示名称直接当作 API 模型名。

每次只调整一项,再检查模型状态并发送一次简短消息。最终验收包括:服务商选择正确、状态检查没有相关阻断问题、实际消息能够返回结果。涉及 401 或 403 时,再按 认证错误排查 区分模型服务与 Gateway。

继续阅读

参考资料与核对日期

资料核对:2026-11-11。以下为对应的官方文档入口;本文为文档整理,未作本地安装实测。