OpenClaw 接入 LongCat-2.0 配置（官方文档）

一句话结论

在 OpenClaw（原 Clawdbot）的 ~/.openclaw/openclaw.json 里注册一个自定义 provider，即可把默认模型切到 LongCat-2.0，官方给出的上下文窗口/最大输出配置（1048576 / 131072）可直接照抄。

适用场景

• 适合的任务：在 OpenClaw 多 Agent 框架中使用 LongCat-2.0；把 LongCat 设为默认模型跑日常 Agent 任务

• 不适合的任务：无 OpenClaw 环境的场景（配置只作用于该框架）

• 适用的模型版本：LongCat-2.0

• 适用的客户端、Agent 或 API：OpenClaw（npm/pnpm/curl 安装，macOS/Windows；Web 控制台 http://127.0.0.1:18789）

• 推荐的推理档位和参数：官方配置示例 "reasoning": false（在 OpenClaw 模型中关闭 reasoning 标记）；contextWindow: 1048576（1M）、maxTokens: 131072（128K）；计费字段用 max_tokens

可直接使用的内容

1. 安装 OpenClaw

# macOS
npm install -g openclaw@latest
# 或 pnpm add -g openclaw@latest
# 或 curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell: iwr -useb https://openclaw.ai/install.ps1 | iex

2. 首次引导

openclaw onboard --install-daemon

引导建议（官方）：Onboarding Mode 选 QuickStart；Model/Auth Provider 选 Skip for now；Default model 保持当前；无合适 Channel 就 Skip for now 稍后配置；Gateway Service 选 Install/Reinstall。完成后 Web 控制台默认地址 http://127.0.0.1:18789，配置文件在 ~/.openclaw/openclaw.json。

3. 注册 LongCat provider（openclaw.json）

{
   "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.0",
                  "name": "LongCat-2.0",
                  "reasoning": false,
                  "input": ["text"],
                  "contextWindow": 1048576,
                  "maxTokens": 131072,
                  "compat": {
                     "maxTokensField": "max_tokens"
                  }
               }
            ]
         }
      }
   }
}

4. 设为默认模型

{
   "agents": {
      "defaults": {
         "model": {
            "primary": "longCat/LongCat-2.0"
         }
      }
   }
}

保存后立即生效。也可以走 GUI：Web 控制台 → Config → Models → Providers，Api 选 openai-completions，填入 API Key 与 baseUrl。

原始数据与复核说明

• 所有配置项逐字抄录自官方文档（2026-08-18 采集）。

• 官方模型卡把 OpenClaw 列为 LongCat-2.0 深度适配的三大 Harness 之一（与 Claude Code、Hermes 并列），README 明示"deeply integrated with mainstream harnesses such as Claude Code, OpenClaw, and Hermes"。

• 官方文档同一目录下还有 OpenCode、Codex、ZCode、Cline、Kilo Code、Cherry Studio、CodeBuddy、WorkBuddy、CC Switch 等工具的接入页，配置范式相同（OpenAI 兼容端点 + 模型 ID）。

适用边界

• "reasoning": false 是 OpenClaw 侧对模型是否输出 reasoning 字段的声明，不代表关闭 LongCat 的思考模式；LongCat 思考模式由请求体 thinking 字段控制（官方 API 参考）。

• 官方文档的 contextWindow: 1048576 是 provider 声明值，实际 1M 上下文能否稳定使用取决于任务与部署渠道（OpenRouter 渠道同样标注 1M context）。