OpenClaw 接入老张 API：模型配置、密钥与调用验证

将 OpenClaw 接入老张 API（laozhang.ai），可以从一条明确的配置开始：在 models.providers 中添加 laozhang，把 baseUrl 设为 https://api.laozhang.ai/v1，把 api 设为 openai-completions，再填写密钥引用和完整模型 ID。已有 OpenClaw 的读者无需为了这条接入重新安装或重配聊天渠道。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

先确认你有可用的老张 API 令牌。 截至 2026 年 10 月 7 日，老张 API 公开入口要求企业白名单审核；不能再按旧教程假定注册后立即获得免费额度。Claude 模型目前因资源短缺暂时下线。对希望先接通文字与工具调用的用户，gpt-5.4-mini 是一个有当前文档依据的起点：它列在默认分组，并出现在服务商的工具接入说明中，但你的令牌权限仍须匹配。服务入口、模型目录和工具接入说明共同限定了这条方案的适用范围。

下文针对已经运行 OpenClaw 的环境，提供配置片段、切换方法和成功判断。示例依据当前公开文档整理，并做离线语法检查；没有进行真实 OpenClaw 接入或付费模型调用。

接入前，核对令牌、模型和协议

老张 API 是预充值、按实际用量扣费的 API 服务。这里使用的是 API Key，不是账户 AccessToken，也不是 ChatGPT 或其他产品的订阅登录凭证。新用户应先从当前服务入口确认申请资格；已有用户则核对令牌状态、令牌分组和计费模式。本文不假定你能立即注册，也不提供未经核实的控制台按钮路径。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

接入时，以下三个名称不能混用：

“默认分组”等令牌分组名称决定访问权限，不能写进模型 ID。公开模型目录也不是你这枚令牌的授权清单。2026 年 10 月 7 日目录显示的 222 个在线模型涵盖文本、图片、音频等类别，不能据此认为 OpenClaw 能用一个聊天配置调用全部模型。目录与分组说明应在你更换模型时重新核对。

本文选择 Chat Completions：OpenClaw 的 openai-completions 适配器对应老张 API 的 /v1/chat/completions。配置填的是基础地址 https://api.laozhang.ai/v1，不要把完整请求路径写进去，也不要再追加一遍 /v1。老张 API 另有 Responses 和 Messages 接口；它们的请求和返回结构不同，更换协议需要同时核对客户端适配器与目标模型，不能只替换模型名。API 手册列出了这些接口的区别。

在现有配置中添加 laozhang 提供商

先备份你实际使用的配置文件。OpenClaw 默认读取 ~/.openclaw/openclaw.json，支持 JSON5；若环境设置了 OPENCLAW_CONFIG_PATH，应编辑它指向的文件。不要仅因默认路径存在，就认定正在运行的 Gateway 读取的是这一份。配置文档说明了路径与严格校验规则。

下面是需要并入现有配置的片段，不要用它覆盖整个文件。已有 models 或 agents 对象时，合并相应字段，保留其他提供商、agent、渠道及访问策略：

{
  "models": {
    "mode": "merge",
    "providers": {
      "laozhang": {
        "baseUrl": "https://api.laozhang.ai/v1",
        "apiKey": "${LAOZHANG_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.4-mini",
            "name": "老张 API · GPT-5.4 Mini"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "laozhang/gpt-5.4-mini"
      }
    }
  }
}

这里的 name 方便识别，真正发给上游的是 id。示例只声明一个模型，让你先验证一条清楚的接入链路；以后添加其他模型时，每个 ID、分组权限和工具能力都应单独确认。

mode: "merge" 用于明确保留并合并模型目录。当前文档中 merge 是默认行为，省略它不会自动删掉内置提供商。 replace 才是有意替换目录的选择。此外，特定 agent 的 models.json 可能保留同名提供商的非空 baseUrl，影响最终使用的地址；SecretRef 密钥也有专门的合并优先规则。修改后仍走旧地址时，应核对这个 agent 的配置来源，而不是不断改全局文件。自定义提供商文档给出了这些规则。

让 Gateway 进程能读取密钥

配置中的 ${LAOZHANG_API_KEY} 只引用变量，不会替你创建变量。可以在 OpenClaw 支持的 ~/.openclaw/.env 中保存如下形式的条目，将占位文字换成你自己的 API Key，并保护文件权限：

LAOZHANG_API_KEY=替换为你的老张API密钥

不要提交这个文件，也不要通过 echo、截图或聊天消息公开完整密钥。查问题时只确认变量是否存在、凭证来源是否正确，不需要输出密钥内容。

OpenClaw 会读取父进程环境、当前工作目录的 .env 和 ~/.openclaw/.env；环境文件不会覆盖进程已经拥有的值。如果服务进程原来带着一枚旧密钥，修改 .env 并不保证它覆盖旧值。反过来，在另一个终端执行 export，也不会自动把变量传给已经运行的 launchd、systemd 或容器服务。缺失或空变量会保持未解析状态并产生警告。环境变量文档是排查这类 401 或凭证未解析问题的依据。

保留已有模型限制

设置 primary 是选择默认模型，不等于授予使用权限。当前 OpenClaw 自 v2026.8.1 起使用显式的 agents.defaults.modelPolicy.allow 管理默认模型覆盖限制，agents.defaults.models 用于别名和模型设置；尚未迁移的旧配置仍可能保留历史限制。

如果你的环境已经限制可用模型，在现有 agents.defaults.modelPolicy.allow 字符串数组中明确加入 "laozhang/gpt-5.4-mini"，保留原来的允许项和约束。特定 agent 的 agents.entries.*.modelPolicy.allow 会替代默认策略，应同时核对目标 agent。省略允许范围或设为空数组表示不限制，因此不能用清空数组来修复权限错误。不要为了消除 Model not allowed 删除整套限制，也不要把旧教程里的模型映射一律当作当前白名单。涉及旧配置迁移时，按当前模型策略文档处理；doctor --fix 会执行修复，不是通用的只读检查命令。

保存后，确认正在使用的会话确实切换了

配置文件保存成功，只证明文件已写入。你可以先运行以下文档命令检查配置与模型目录：

openclaw config validate
openclaw models list --provider laozhang

第一步应通过当前版本的配置校验；未知字段和错误类型会导致失败。JSON5 允许的尾随逗号不应一概判成语法错误。第二步应能找到 laozhang/gpt-5.4-mini；它证明模型已进入 OpenClaw 的目录，尚未证明令牌有效或模型能响应。配置说明和models 命令说明区分了这些检查的用途。

当前 OpenClaw 支持对提供商、默认模型和 fallback 等变更热加载。默认 hybrid 模式会应用相应变更；若 reload 设为 off，则需要手动重启后才应用。外部写入的配置无效时，运行中的 Gateway 可能继续使用最后一份有效配置。因此，应查看变更是否被接受，再决定是否需要重启，不能把“磁盘内容已改”当作“运行配置已改”。热加载文档说明了具体行为。

在你准备测试的那一个会话中，用完整模型引用明确选择：

/model laozhang/gpt-5.4-mini

如果只是希望会话跟随新的默认模型，可用 /model default 清除它原来固定的模型选择。已有会话曾被手动固定在其他模型时，改全局 primary 不代表它立即跟随。还要核对目标 agent 是否有自己的覆盖配置。模型选择与会话固定规则解释了这一差别。

怎样判断文字回复和工具调用都接通了

按“配置可识别 → 目标会话选择 → 实际模型回复 → 工具执行”的顺序验证，能避免把不同结果混在一起。

先在刚选好模型的会话里发送一条简短文字问题。收到回复后，结合该次运行显示的提供商和模型、对应时间的请求记录，确认使用的是 laozhang/gpt-5.4-mini。仅看到一段答案，无法排除旧会话模型或 fallback 在回答。需要核对服务端记录时，可以对照自己的老张 API 用量记录，但不要公开密钥或包含私人内容的日志。

随后验证你实际需要的工具。比如，环境已有文件读取工具且你允许读取某个无敏感内容的测试文件，就要求它读取该文件并概括内容。成功应包含可辨认的工具调用、实际返回结果和基于该结果的答复；模型仅说“我读取了”或给出看似正确的概括，不足以证明工具执行成功。没有工具调用时，先核对 agent 是否提供了该工具及相关权限，再检查模型、协议和参数。

老张 API 的工具接入文档报告了 gpt-5.4-mini、gpt-5.6-sol 等模型的流式工具测试，适用条件涉及默认分组及按量优先设置。这是服务商对自身接口的测试说明，不能替代你的 OpenClaw 验收。当前文档还列出 GPT6 在 Chat 路线下的 tools、reasoning effort、max_tokens 参数限制；因此，不建议只因模型更新就把上面的示例 ID 改成 GPT6，保留全部旧参数。工具接入说明应与实际请求错误一起检查。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

Chat Completions 返回 tool_calls 时，文本内容可能为空。应看客户端是否接收并执行了工具调用，而不是立即把空文本归为断网。max_completion_tokens 与 max_tokens 的支持也与模型有关，不能把某个模型的参数修复照搬到所有模型。Chat Completions 参考提供了字段和响应结构。

openclaw models status 或 status --check 的结果不是实际模型成功证据，状态查询还可能解析密钥来源。models scan 面向 OpenRouter 免费模型目录，默认会进行在线检查并写入配置，不能用它扫描老张 API。若选择直接 --probe，它会发出真实模型请求，可能产生费用，并要求独占相关状态、停止 Gateway 和完成清理；日常接入不必为了查看目录就贸然执行它。models 命令文档明确区分了目录、状态和探测。

按错误定位应改哪一处

下面的处理顺序针对 laozhang 自定义提供商。先保留错误正文和时间，去掉密钥等敏感信息；不要凭一个 HTTP 状态码反复充值或替换全部配置。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

HTTP 错误与计费方面依据老张 API 手册，模型权限与配置优先规则依据 OpenClaw 模型文档。同一状态码可能对应不同原因，错误正文应优先于笼统解释。

接通后，再增加模型和控制费用

先保留一个完成过文字及所需工具验证的主模型，再按实际任务添加候选。gpt-4o-mini 当前仍在老张 API 目录中；其他候选也应按完整 ID、令牌权限和所需能力逐个验证。Claude 目前暂时下线，不应沿用旧文的 Sonnet 或 Opus 主模型、回退模型配置。当前模型目录决定候选的供应状态。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

若要增加 fallback，将经过验证、允许使用的模型引用放进 agents.defaults.model.fallbacks。OpenClaw 会在符合条件的失败及同模型恢复尝试后按顺序回退；它不是按任务难度自动选“更强模型”的分类器。用户明确选择的会话模型有严格选择规则，不能承诺它也按默认回退链处理。上下文溢出或最终拒绝也不是万能的回退触发条件。两个模型都经由同一老张 API 令牌时，还可能共享余额不足或网关故障。模型故障转移文档说明了适用条件。

费用按实际输入、输出、缓存用量及分组倍率计算，而不是按模型目录数量或 OpenClaw 配置中的 cost 值计算。把本地 cost 写成 0，不会让上游免费。

以 2026 年 10 月 7 日目录中 gpt-5.4-mini 的普通价格为例：输入每百万 token 0.75 美元、输出 4.5 美元、缓存读取 0.075 美元。假设一次请求输入 1,000 token、输出 200 token，无缓存读取，分组倍率为 1，则估算为：

输入：1,000 ÷ 1,000,000 × 0.75 = 0.00075 美元
输出：  200 ÷ 1,000,000 × 4.50 = 0.00090 美元
合计：0.00165 美元

这只是给定用量的演算，不是一次 agent 任务的实际账单。工具往返会增加请求，历史对话和文件内容会增加输入；实际扣费以你的分组、计费模式及控制台用量为准。价格依据模型目录，计费口径依据定价说明。没有自己的用量数据时，不应把这个小请求推成固定月费或节省比例。

如果下一步需要比较其他云端提供商与本地推理，继续阅读OpenClaw 模型配置指南：云端 API、Ollama 与 LM Studio 接入。这条老张 API 接入完成后，值得保留的是实际使用的模型、令牌分组、配置来源和验收结果，而不是一份未经验证的长模型清单。

常见问题

新用户现在还能直接注册，领取免费额度吗？

不能据旧教程保证。2026 年 10 月 7 日的老张 API 服务入口要求企业白名单审核；本文没有把历史免费额度、免绑卡或立即开通当作现行权益。先确认使用资格，再配置 OpenClaw。

不写 mode: "merge"，其他模型会消失吗？

按当前自定义提供商文档，merge 是默认行为，省略该字段不会自动删除内置目录。replace 才会有意替换。示例明确写出 merge，是为了让合并意图清楚。

老张 API 的模型显示在列表里，算接入成功吗？

还不算。目录项只证明 OpenClaw 识别了配置。应在目标 agent 和会话中选择完整引用，取得可对应到该模型的实际回复；需要工具时，再确认真实工具调用及结果。status --check 也不能替代真实调用。models 命令说明区分了这些结果。

可以把 Claude 或 GPT6 直接填进同一个配置吗？

不能仅换名字就假定可用。Claude 在当前老张 API 目录中暂时下线；GPT6 的 Chat 参数和工具限制见工具接入文档。模型供应、完整 ID、令牌分组、协议和参数都要匹配，OpenClaw 的模型声明不会改变上游能力。