OpenClaw 接入自定义模型与 WebUI 操作实战

参数详解

注意：配置完 providers 后，务必同步更新 agents.defaults.model.primary，否则框架无法识别默认模型。

providers 内部参数

• baseUrl: API 的基础地址。
• apiKey: 认证密钥，支持环境变量引用（如 ${ENV_NAME}）或直接明文填写。
• api: 接口类型，通常为 openai-completions 表示兼容 OpenAI 格式。
• models: 该提供商支持的模型列表，包含 id 和 name。

接入 LongCat 模型实战

LongCat 是美团开发的大语言模型平台，提供高性能通用对话及深度思考模型。目前支持 Flash-Chat、Flash-Thinking 等多种规格。

准备工作

1. 访问 LongCat 开放平台注册账号。
2. 新用户通常享有免费 Token 额度。
3. 在后台创建并获取 API Key。
4. 确认用量情况。

完整配置示例

以下配置展示了如何完整接入 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 服务。

WebUI 可视化配置

如果不习惯直接编辑 JSON，也可以通过 Web 控制页面进行设置：

1. 访问 http://127.0.0.1:18789 打开 OpenClaw Web 控制台。
2. 导航至 Config → Models → Providers。
3. 添加以下配置项：

效果验证

启动服务后，可在 Agent 界面确认模型已切换成功。

询问模型能力及状态时，应返回正确的模型信息。

完成本地桌面文件查找等任务时，观察日志输出是否符合预期。

注意事项

1. 配置文件路径：默认位于 ~/.openclaw/openclaw.json，请根据实际安装路径调整。
2. WebUI 地址：默认监听 http://127.0.0.1:18789。
3. 通信协议：OpenClaw 使用 WebSocket 进行全双工通信。如需调试接口，可连接 ws://127.0.0.1:18789/ 查看实时数据流。
4. 配置热加载：修改 openclaw.json 后保存即可生效，无需重启 Gateway 服务。

参考资源

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