OpenClaw 接入自定义模型及 WebUI 智能操作实战

这里有几个关键点需要注意：

• primary：位于 agents.defaults.model，这是必填项。格式必须是 提供商/模型 ID，且必须与下方 providers 中定义的键名和模型 ID 严格对应。如果配错了，程序会找不到模型。
• mode：控制合并策略。merge 表示追加到现有配置，replace 则是完全覆盖。
• providers：这里是核心，每个键值对代表一个服务商。你需要填入 baseUrl（API 地址）、apiKey（支持环境变量引用如 ${ENV_NAME}）、以及该服务商支持的模型列表。

有个常见的坑：配置完 providers 后，一定要记得同步更新 agents.defaults.model.primary，否则 OpenClaw 不知道默认该调用哪个模型。

实战：接入 LongCat 模型

LongCat 是美团开发的大语言模型平台，提供高性能的通用对话和深度思考模型。下面演示如何将其接入 OpenClaw。

准备阶段

1. 访问 LongCat 开放平台注册账号。
2. 新用户通常有免费 Token 额度，建议先查看用量页面确认。
3. 在 API Keys 管理页面创建并复制你的密钥。

完整配置示例

参考官方文档，以下是接入 LongCat 的完整配置片段。注意替换其中的 YOUR_API_KEY_HERE 为你实际申请的 Key：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "longCat/LongCat-Flash-Chat"
      },
      "workspace": "/Users/user/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "longCat": {
        "baseUrl": "https://api.longcat.chat/openai",
        "apiKey": "YOUR_API_KEY_HERE",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "LongCat-Flash-Chat",
            "name": "LongCat-Flash-Chat",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "compat": {
              "maxTokensField": "max_tokens"
            }
          }
        ]
      }
    }
  }
}

配置说明：

• contextWindow: 200000 表示支持 20 万 Token 上下文。
• maxTokens: 8192 限制单次响应长度。
• 修改保存后配置立即生效，无需重启 Gateway 服务。

GUI 可视化配置

如果不习惯直接改文件，也可以通过 Web 界面操作。启动服务后访问 http://127.0.0.1:18789，进入 Config → Models → Providers 添加以下参数：

效果验证

配置完成后，可以通过以下方式验证接入是否成功：

1. 启动 Agent，观察控制台输出，确认加载的模型名称为自定义的 LongCat-Flash。
2. 询问 Agent 当前具备的能力及使用的模型版本。
3. 尝试执行本地桌面文件查找任务，测试 Agent 的实际推理与操作能力。

注意事项

• 配置文件路径：通常位于 ~/.openclaw/openclaw.json，不同系统可能略有差异。
• WebUI 端口：默认监听 18789，如果冲突需修改。
• 通信协议：OpenClaw 使用 WebSocket 进行全双工通信。调试接口时可连接 ws://127.0.0.1:18789/ 查看实时数据。
• 配置生效：修改 openclaw.json 后保存即可，无需重启服务。

参考资料

• OpenClaw 模型提供商快速入门
• OpenClaw 模型提供商配置文档
• LongCat 开放平台
• LongCat OpenClaw 配置指南