OpenClaw 接入 | Jerry API 文档

文档智能体OpenClaw

1. 安装 OpenClaw

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version

已经完成 OpenClaw 初始化时，可以直接修改模型配置。

2. 设置 API Key

macOS / Linux

export JERRY_API_KEY="YOUR_JERRY_API_KEY"

确保启动 OpenClaw Gateway 的进程也能读取该环境变量。常驻服务不要只在临时终端中设置。

3. 添加 Jerry Provider

编辑 OpenClaw 主配置文件 ~/.openclaw/openclaw.json。如果已有其他配置，请合并下面的 agents 和 models，不要覆盖原文件。

~/.openclaw/openclaw.json

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "jerryapi/gpt-5.4"
      },
      "models": {
        "jerryapi/gpt-5.4": { "alias": "Jerry GPT-5.4" },
        "jerryapi/gpt-5.4-mini": { "alias": "Jerry GPT-5.4 mini" },
        "jerryapi/gpt-5.5": { "alias": "Jerry GPT-5.5" }
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "jerryapi": {
        "baseUrl": "https://www.jerryapi.com/v1",
        "apiKey": "${JERRY_API_KEY}",
        "api": "openai-responses",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4", "reasoning": true, "input": ["text"] },
          { "id": "gpt-5.4-mini", "name": "GPT-5.4 mini", "reasoning": true, "input": ["text"] },
          { "id": "gpt-5.5", "name": "GPT-5.5", "reasoning": true, "input": ["text"] }
        ]
      }
    }
  }
}

合并现有配置

OpenClaw 配置通常还包含 Gateway、渠道和工具权限。请只添加 Jerry API 相关字段，避免删除已有的 Telegram、Discord、QQ 或其他渠道配置。

4. 重启并验证

Terminal

openclaw gateway restart
openclaw models list
openclaw models status

模型列表中应出现三个 jerryapi/... 模型。随后通过你已经配置的会话渠道发一条简单消息，并在 Jerry API 后台核对请求。

Chat Completions 兼容模式

如果当前 OpenClaw 版本或任务链路在 Responses 模式下报协议错误，可以将 Provider 的适配器改为 Chat Completions 后重新启动：

仅修改这一行

"api": "openai-completions"

不要同时修改 Base URL。切换后使用一个包含工具调用的任务进行验证，确认流式输出和工具参数均正常。

常见问题

现象	处理
配置读取不到密钥	确认 Gateway 服务的环境中存在 `JERRY_API_KEY`，然后重启服务
模型列表没有 Jerry	检查 JSON 语法、Provider ID 和 `models.mode`，再重启 Gateway
普通对话正常，工具调用失败	在 `openai-responses` 与 `openai-completions` 间切换测试，并保留报错信息
配置后原有渠道消失	说明保存时覆盖了原配置，从备份恢复并改为合并字段

核对使用记录用 CC Switch 管理