使用 DeepSeek 的 OpenClaw：设置、模型 ID 和 API 成本

OpenClaw 通过单独安装的官方提供商插件连接 DeepSeek——openclaw plugins install @openclaw/deepseek-provider——其提供商 ID 为 deepseek，密钥为 DEEPSEEK_API_KEY，API 与 OpenAI 兼容，基础 URL 为 https://api.deepseek.com，且不包含 /v1。有两个事实决定首次运行是否成功。DeepSeek 的实时目录中有两个 ID：deepseek-flash 和 deepseek-v4-pro；旧教程使用的 deepseek-chat 和 deepseek-reasoner 名称已于 2026 年 7 月 24 日停止服务。OpenClaw 的引导流程会将 deepseek/deepseek-v4-pro 设置为默认模型，而这正是当前计费信息在 DeepSeek 自己的页面之间存在分歧的模型。

在配置之前先澄清一个容易混淆之处，因为搜索结果会将它们混在一起。另一个 GitHub 上的 OpenClaw 自称是“原版 Captain Claw（1997）平台游戏的跨平台 C++ 重实现”；它的任何内容都不适用于这里。这里的代理是位于 openclaw.ai 的项目，文档位于 docs.openclaw.ai——请链接该主机，因为 documentation.openclaw.ai 只会将其重定向到那里。

按照两个项目文档中的方式安装和配置

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

安装插件后无需提供基础 URL：插件会发布自己的目录和兼容性行为。最小配置是在 JSON5 中设置密钥和模型。

{
  env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-pro" },
    },
  },
}

OpenClaw 按记录的优先级顺序，从四种环境变量形式中解析提供商密钥：首先是作为优先级最高的单个实时覆盖值的 OPENCLAW_LIVE_DEEPSEEK_KEY，然后是逗号或分号分隔列表 DEEPSEEK_API_KEYS，接着是主密钥 DEEPSEEK_API_KEY，最后是编号条目 DEEPSEEK_API_KEY_*（控制界面和密钥，核查日期：2026 年 9 月 21 日）。控制界面中的 Settings，然后是 Models，可以添加或替换密钥而无需编辑文件，密钥材料会保留在身份验证存储中。服务器安装的陷阱在于作用域而非拼写：OpenClaw 自己的页面警告，如果 Gateway 作为 launchd 或 systemd 下的守护进程运行，密钥必须对该进程可见，例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供。

哪些 DeepSeek 模型 ID 实际仍然可用

下表包含三种不同状态，而不是一种。DeepSeek 的 list-models 参考中的示例响应准确显示了两个 ID：deepseek-flash 和 deepseek-v4-pro，而 OpenClaw 随附的目录仍提供四个引用。

请将这两项停用声明分开理解，因为它们读起来似乎矛盾，但实际上并不矛盾。OpenClaw 表示 DeepSeek 已停用 deepseek-chat 和 deepseek-reasoner，并且“这些模型 ID 已无法访问”。DeepSeek 则单独表示，“旧名称 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 仍然可以接受，但对应模型已停止服务”。两组名称不同，结果也不同。DeepSeek 的 Models & Pricing 页面为两个仍在线的 ID 都给出了 1M 上下文长度和 384K 最大输出，OpenClaw 的目录表也在其四个引用上都记录了相同的 1,000,000 / 384,000 数值对。

尚未解决的一个问题。DeepSeek 的2026 年 9 月 10 日公告称“我们正在逐步停止 V4-Pro”，并表示“从 2026 年 9 月 14 日 04:00 UTC 开始，所有 deepseek-v4-pro 请求都将按 V4.1-Flash 费率路由到 V4.1-Flash”。但同一版本的更新日志却称相反的内容：“应用户要求，我们决定在 2026 年 9 月 14 日之后继续提供 DeepSeek V4 Pro 的 API 服务，计费方式保持不变”。Models & Pricing 页面仍列出 V4 Pro 及其更高的独立费率，也没有停用通知。两者都于 2026 年 9 月 21 日读取，即相关日期一周之后。本页不会告诉你实际按哪一种方式计费——在保留引导默认值之前，请在自己的 DeepSeek 账户中确认，并注意默认值恰恰就是存在争议的模型。

令牌费用是多少，以及为什么时间是价格的一部分

DeepSeek 公布高峰和非高峰费率，非高峰费率为高峰费率的一半。时间窗口很窄：“高峰时段为周一至周五 UTC 时间 01:00 - 04:00 和 06:00 - 10:00，不包括中国法定节假日。其他所有时间均为非高峰时段，包括周末以及完整的中国法定节假日。”工作日每天有七个高峰小时，其余时间都不是高峰，因此默认为高峰时段的估算会高估典型账单。

内容读取自 DeepSeek 的 Models & Pricing 页面，日期为 2026 年 9 月 21 日。OpenClaw 的提供商页面独立佐证了 Flash 行，该页面列出“每百万输入令牌 $0.30、每百万输出令牌 $1.20、每百万缓存输入令牌 $0.006”。V4 Pro 各行仅依据 Models & Pricing 页面，并处于上述矛盾之下，因此请将其视为引用值，而不是已确定的值。

缓存列是影响代理账单的关键，其比例也很不寻常。deepseek-flash的缓存命中价格为每百万 $0.006，而未命中价格为 $0.30——大约是未命中费率的五十分之一，远低于其他地方常见的十分之一比例，因此不要照搬其他供应商的假设。DeepSeek 的缓存指南称，该功能“默认对所有用户启用，无需修改代码”，命中要求前缀完全匹配，未使用的缓存“通常会在几小时到几天内”清除。命中和未命中会返回在 prompt_cache_hit_tokens 和 prompt_cache_miss_tokens 使用字段中。DeepSeek 没有公布缓存写入价格，其定价表也没有缓存写入列；这表示没有公布相关费用，并不表示写入是免费的。

deepseek-flash上的说明性会话，使用 DeepSeek 公布的费率。假设一次 OpenClaw 运行发送 600,000 个输入令牌，其中 450,000 个命中前缀缓存，150,000 个未命中，并接收 40,000 个输出令牌。在高峰时段，费用为 $0.045 加 $0.0027 加 $0.048，即 $0.096；同一会话在非高峰时段为 $0.048。完全没有缓存命中的同一运行在高峰时段将为 $0.228。这些是基于明确假设的令牌算术，不是实测任务成本，也不是支出上限——最重要的变量是你自己的缓存命中比例；OpenClaw 的应用内数字无法解决这一问题，因为 OpenClaw 表示其本地费用是估算值，并将 DeepSeek 的定价页面作为计费权威依据。

模型能力与客户端工具支持是两个不同的问题

这是价格表无法告诉你的部分，也是应使用该插件而不是手工编写提供商条目的实际原因。DeepSeek V4 思考会话要求在后续请求中，从启用思考的轮次重放的 assistant 消息携带 reasoning_content。OpenClaw 的 DeepSeek 插件会自动补齐该字段，因此多轮工具使用“即使历史记录来自另一个 OpenAI 兼容提供商（没有原生 reasoning_content），或来自普通的 assistant 消息，也能正常工作”，在会话中途切换提供商后无需 /new。关闭思考时，包括界面中的 None 选择，OpenClaw 会发送 thinking: { type: "disabled" }，并从传出的历史记录中删除重放的 reasoning_content。OpenClaw 还会将 /think xhigh 和 /think max 都映射到 DeepSeek 的最大 reasoning_effort。

指向 DeepSeek 兼容端点的通用 openai-completions 自定义提供商不会获得上述任何自动补齐，也不会获得 DeepSeek 思考格式，除非你自行声明兼容性区块——OpenClaw 的 ds4 页面展示了该结构，其中包括 thinkingFormat: "deepseek" 和 supportsReasoningEffort。这通常就是工具轮次第一次成功、随后在后续轮次失败的原因。

两个 DeepSeek 侧的限制应在同一决策中考虑。严格模式工具调用位于不同的基础 URL https://api.deepseek.com/beta上，并且要求每个函数都包含 "strict": true 以及 "additionalProperties": false；插件默认并不指向这里。DeepSeek 的工具调用指南还说明：“Chat Completion API 不支持在对话中途插入工具调用，但支持在对话中途插入 system 消息；如需插入工具调用，请使用 Anthropic API 或 Responses API。”这是 OpenClaw 插件所使用端点的限制，并非模型限制；文档提供了两种替代方案。

在模型支持方面，两个来源的说法一致。DeepSeek 的 Models & Pricing 页面的 FEATURES 列将 Tool Calls、JSON Output、Responses API 和 Anthropic API 标记为 deepseek-flash 和 deepseek-v4-pro 均支持，并在视觉能力上将两者区分开来——deepseek-flash 支持，deepseek-v4-pro 不支持。OpenClaw 表示其四个引用都支持多轮工具使用。双方都没有记录并行工具调用，因此这一点确实仍未解决，不能据此回答支持或不支持。

分三步验证，然后检查值得说明的故障

按顺序检查各层，因为每一层的失败方式都不同。第一是目录：运行 openclaw models list --provider deepseek，或运行 openclaw models list --all --provider deepseek，以便在没有运行中的 Gateway 时检查插件的静态目录；如果你想使用没有争议的模型而不是引导默认值，则运行 openclaw models set deepseek/deepseek-flash。第二，先发送一个简短的非流式提示，再发送一个流式提示；身份验证或基础 URL 问题会在这里清晰暴露。第三——也只有第三步——在同一会话中执行一次工具调用，然后进行第二轮，这是唯一会执行上文所述 reasoning_content 重放的步骤。

404 行值得单独说明，因为这是文档无法替您解释的状态。DeepSeek 的 错误代码表列出了 400、401、402、422、429、500 和 503，但不包含 404，因此这里的 404 说明的是您的路由问题，而不是 DeepSeek 的问题。对于未知模型 ID，DeepSeek 实际返回的内容没有文档记录，本文也未进行测试。错误参考涵盖了 Kunavo 自有端点上的等效状态码。

直连、Gateway、本地：哪个路由优先

Kunavo 不提供任何 DeepSeek 模型。 Kunavo 的文本模型属于 Claude 和 OpenAI 系列，因此不存在 Kunavo 到 DeepSeek 模型的路由，本页面也没有提供此类路由。可以迁移的是机制：如果您阅读 DeepSeek 设置页面的原因，是希望在不同模型系列之间使用一个密钥，而不是专门使用 DeepSeek，那么了解这一点很有价值。

对于 Gateway 这一行，配置使用相同的两个控制项。您可以使用 models.providers.<id> 声明 baseUrl、apiKey、api: "openai-completions" 和一个 models[] 数组，其中至少列出每个 id；也可以使用 --auth-choice custom-api-key、--custom-base-url 和 --custom-model-id 针对该端点完成设置。模型引用始终采用 provider/model 格式；一种静默失败情况是：在 agents.defaults.models 下为模型设置别名，却没有在 models.providers.<provider>.models[] 中注册它——OpenClaw 的 自定义提供商参考指出，该别名“既不会限制覆盖设置，也不会自行注册新的运行时模型”。该路由在 Kunavo 中的基础 URL 是 https://api.kunavo.com/v1，且恰好带有一个 /v1——这与 DeepSeek 不带后缀的约定相反，也是有人将一页中的值复制到另一页字段后最可能出现 404 的原因。

为了了解该替代方案的规模，下面按照相同的假定会话形态计算——600,000 个输入令牌和 40,000 个输出令牌，不假定使用缓存——并采用实时的 Kunavo 目录费率。这些是不同端点上的不同模型，因此这里只是形态比较，不是与上方 DeepSeek 数据进行的同任务成本比较；列出的最低费率与完成任务的最低成本是两个不同的说法，只有您自己的运行结果才能确定后者。

基于所述假设的示例性令牌计算，不代表实际任务成本，也不是账单上限。Kunavo 的目录金额是计费下限而非上限：当上游报告其费用时，账单金额取目录成本与上游成本乘以适用加价两者中的较高者。缓存费用和外部工具不包含在此示例中。最低充值金额为预付额度 $10——这是资金充值最低额，不是任务费用或订阅费用。请参阅 计费详情和缓存。

如果您实际想要的是相邻的那条路由，请先从集成概览开始，了解基础 URL 和密钥设置，然后查看快速入门以发起第一次调用；准备为密钥充值时，再创建 Kunavo 账户。请将其视为已发布的配置参考，而不是兼容性结果：OpenClaw 尚未针对 Kunavo 的端点进行运行时测试。您打算继续使用 OpenClaw 并选择模型？OpenClaw 定价将免费软件与按量计费分开，适用于 OpenClaw 的最佳 API按任务比较各路由，OpenAI 兼容 API介绍本页面反复提醒的基础 URL 约定。

常见问题

上文关于 OpenClaw 和 DeepSeek 的所有陈述，均来自这些项目自己的文档和软件包注册表，并于 2026 年 9 月 21 日以 OpenClaw v2026.9.5 为基准读取；提供商页面、定价页面、变更日志、9 月 10 日公告、模型列表参考、错误代码表、速率限制页面和自定义提供商规则，均已为本页面直接重新获取。未进行任何安装、引导配置或调用：没有运行 OpenClaw，没有向 api.deepseek.com 发出请求，也没有针对 Kunavo 进行运行时测试。Kunavo 的令牌费率来自实时目录，所有美元数值均为示例性令牌计算，而非实测成本。