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

> OpenClaw 接入老张 API，需要添加 laozhang 自定义提供商、选择令牌有权调用的模型，并让实际会话使用它。当前新用户须先通过企业白名单审核；模型出现在列表里后，还要分别确认真实回复和工具执行。

- URL: https://blog.laozhang.ai/zh/posts/openclaw-laozhang-ai-setup-guide
- Published: 2026-03-07
- Updated: 2026-10-08
- Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about)
- Topic: 开发工具与智能体
- Tags: OpenClaw, laozhang.ai, API 配置, 自定义模型, 工具调用

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

*说明：[laozhang.ai 是我们自己的服务](https://blog.laozhang.ai/zh/about#laozhang)，其价格是平台报价，不是独立比较的结论。*

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

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

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

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

*说明：[laozhang.ai 是我们自己的服务](https://blog.laozhang.ai/zh/about#laozhang)，其价格是平台报价，不是独立比较的结论。*

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

| 对象 | 本文示例 | 用在哪里 |
|---|---|---|
| OpenClaw 提供商名称 | `laozhang` | 配置中自行定义的名称，组成模型引用的前半部分 |
| 上游完整模型 ID | `gpt-5.4-mini` | 提供商的 `models` 数组中的 `id`，须与老张 API 当前支持的 ID 一致 |
| OpenClaw 模型引用 | `laozhang/gpt-5.4-mini` | 默认模型、会话选择和允许使用的模型范围 |

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

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

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

![备份实际配置、合并提供商、保留模型限制并验证目标会话与工具的接入流程示意](https://blog.laozhang.ai/posts/zh/openclaw-laozhang-ai-setup-guide/img/setup-flow.webp)

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

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

```json
{
  "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 的配置来源，而不是不断改全局文件。[自定义提供商文档](https://docs.openclaw.ai/gateway/config-tools/custom-providers)给出了这些规则。

### 让 Gateway 进程能读取密钥

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

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

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

OpenClaw 会读取父进程环境、当前工作目录的 `.env` 和 `~/.openclaw/.env`；环境文件不会覆盖进程已经拥有的值。如果服务进程原来带着一枚旧密钥，修改 `.env` 并不保证它覆盖旧值。反过来，在另一个终端执行 `export`，也不会自动把变量传给已经运行的 launchd、systemd 或容器服务。缺失或空变量会保持未解析状态并产生警告。[环境变量文档](https://docs.openclaw.ai/gateway/configuration/environment-variables)是排查这类 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` 删除整套限制，也不要把旧教程里的模型映射一律当作当前白名单。涉及旧配置迁移时，按[当前模型策略文档](https://docs.openclaw.ai/concepts/models)处理；`doctor --fix` 会执行修复，不是通用的只读检查命令。

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

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

```bash
openclaw config validate
openclaw models list --provider laozhang
```

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

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

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

```text
/model laozhang/gpt-5.4-mini
```

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

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

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

先在刚选好模型的会话里发送一条简短文字问题。收到回复后，结合该次运行显示的提供商和模型、对应时间的请求记录，确认使用的是 `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，保留全部旧参数。[工具接入说明](https://docs.laozhang.ai/scenarios)应与实际请求错误一起检查。

*说明：[laozhang.ai 是我们自己的服务](https://blog.laozhang.ai/zh/about#laozhang)，其价格是平台报价，不是独立比较的结论。*

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

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

## 按错误定位应改哪一处

![按配置识别、模型允许范围、认证地址和实际工具结果定位老张 API 接入问题的示意](https://blog.laozhang.ai/posts/zh/openclaw-laozhang-ai-setup-guide/img/troubleshooting.webp)

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

| 现象 | 先检查什么 | 对应处理 |
|---|---|---|
| 配置校验失败，目录里没有模型 | 实际配置路径、字段类型、提供商名和 `models` 数组 | 修复指出的配置问题，再确认变更被运行中的 Gateway 接受 |
| `Model not allowed` | 当前 `agents.defaults.modelPolicy.allow`、agent 策略及旧配置限制 | 在已有允许范围中添加精确模型引用；保留其他访问限制 |
| 401 或凭证未解析 | API Key 与 AccessToken 是否混用；Gateway 进程能否读到正确变量 | 修正凭证来源；核对旧进程环境是否盖过 `.env`，不用输出完整密钥 |
| 403 | 令牌分组、模型授权、服务资格 | 核对这枚令牌是否有目标模型权限；本地添加模型不会改变上游授权 |
| 404 | 基础地址与完整模型 ID | 使用 `https://api.laozhang.ai/v1`，排除重复路径；核对当前目录及令牌权限 |
| 400、参数不支持或上下文过长 | 具体报错字段、适配器、模型参数和输入长度 | 按目标模型支持的参数调整；不要靠随意声明能力来绕过接口限制 |
| 429 | 错误正文、余额、频率与服务容量 | 余额问题查实际账户；频率或容量问题按提示控制重试，避免并发放大 |
| 5xx 或超时 | 同一时段的服务状态、网络与重试结果 | 有界重试并保留错误；仍失败时向服务方提供脱敏记录 |
| 新默认模型没影响旧会话 | 会话固定模型、agent 覆盖、热加载结果 | 在目标会话明确选择模型，或用 `/model default` 返回默认选择 |
| 能回复但不能使用工具 | agent 工具可用性、模型与协议、工具返回结构 | 分别确认工具已提供、请求参数受支持、客户端执行了调用 |

*说明：[laozhang.ai 是我们自己的服务](https://blog.laozhang.ai/zh/about#laozhang)，其价格是平台报价，不是独立比较的结论。*

HTTP 错误与计费方面依据[老张 API 手册](https://docs.laozhang.ai/api-manual)，模型权限与配置优先规则依据 [OpenClaw 模型文档](https://docs.openclaw.ai/concepts/models)。同一状态码可能对应不同原因，错误正文应优先于笼统解释。

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

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

*说明：[laozhang.ai 是我们自己的服务](https://blog.laozhang.ai/zh/about#laozhang)，其价格是平台报价，不是独立比较的结论。*

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

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

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

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

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

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

## 常见问题

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

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

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

按当前[自定义提供商文档](https://docs.openclaw.ai/gateway/config-tools/custom-providers)，merge 是默认行为，省略该字段不会自动删除内置目录。`replace` 才会有意替换。示例明确写出 merge，是为了让合并意图清楚。

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

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

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

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

## 参考来源

本文引用的外部页面，按正文出现顺序排列。最后更新于 2026-10-08。

- [配置文档](https://docs.openclaw.ai/gateway/configuration) (docs.openclaw.ai)
- [自定义提供商文档](https://docs.openclaw.ai/gateway/config-tools/custom-providers) (docs.openclaw.ai)
- [环境变量文档](https://docs.openclaw.ai/gateway/configuration/environment-variables) (docs.openclaw.ai)
- [当前模型策略文档](https://docs.openclaw.ai/concepts/models) (docs.openclaw.ai)
- [models 命令说明](https://docs.openclaw.ai/cli/models) (docs.openclaw.ai)
- [热加载文档](https://docs.openclaw.ai/gateway/configuration/hot-reload) (docs.openclaw.ai)
- [模型故障转移文档](https://docs.openclaw.ai/concepts/model-failover) (docs.openclaw.ai)