在 OpenClaw 中配置 LongCat-2.5

一句话结论

LongCat 官方文档列出 OpenClaw 对 LongCat-2.5 的支持，并提供 OpenAI 兼容接口的模型配置及验证步骤。

适用场景

• 适合的任务：在 OpenClaw 中接入 LongCat-2.5 作为默认模型。

• 不适合的任务：据此判断模型效果或其他客户端的配置兼容性。

• 适用的模型版本：LongCat-2.5。

• 适用的客户端、Agent 或 API：OpenClaw，使用 LongCat OpenAI 兼容 API。

• 推荐的推理档位和参数：示例设置 reasoning: false、contextWindow: 1048576、maxTokens: 262144；文档未提供其他推理档位建议。

可直接使用的内容

将以下字段合并到 ~/.openclaw/openclaw.json，保留已有配置。把占位符替换为自己的 LongCat API Key，勿将真实密钥提交到仓库。

{
  "models": {
    "mode": "merge",
    "providers": {
      "longCat": {
        "baseUrl": "https://api.longcat.chat/openai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "LongCat-2.5",
            "name": "LongCat-2.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1048576,
            "maxTokens": 262144,
            "compat": { "maxTokensField": "max_tokens" }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "longCat/LongCat-2.5" }
    }
  }
}

也可在 Web 控制页的 Config → Models → Providers 添加 provider：API 选 openai-completions，Base URL 填 https://api.longcat.chat/openai/v1，模型 ID 和名称填 LongCat-2.5，并填写自己的 API Key。

测试或工作流步骤

1. 安装 OpenClaw，准备 LongCat API Key，并确认账户有足够余额。

2. 运行 openclaw onboard --install-daemon 完成初始化；官方建议初始模型提供方暂选 Skip for now。

3. 合并上述配置并保存。官方称保存后立即生效。

4. 运行 openclaw tui，使用 /status 检查 Gateway；或运行 openclaw dashboard 打开 Web UI，在 Chat 页面发送测试消息，确认模型有响应。

原始证据与数据

• 官方支持模型表将 LongCat-2.5 列为支持的模型，API 格式为 OpenAI / Anthropic；本文配置使用文档给出的 OpenAI 兼容接口。

• 文档列出的配置文件位置为 ~/.openclaw/openclaw.json，默认 Web 地址为 http://127.0.0.1:18789。

• 文档单独的默认模型配置使用 longCat/LongCat-2.5；其完整配置示例的 primary 却仍为旧模型 longCat/LongCat-Flash-Thinking-2601。本文采用与目标模型一致的前者。

适用边界

这是官方配置说明，不是模型效果测试；未独立运行验证。参数和 OpenClaw 界面可能随版本变化，以原文及实际安装版本为准。reasoning: false 是示例配置，不能据此推断模型没有推理能力。

复现说明

打开原文，依次查看 Supported Models、LongCat Model Configuration 和 Getting Started。配置时使用自己的密钥，保存后用测试消息确认实际调用成功。