OpenClaw 接入自定义模型并基于 WebUI 完成智能操作

关键参数说明

注意：配置完 providers 后，必须同步设置 agents.defaults.model.primary，否则 OpenClaw 不知道默认该用哪个模型。

providers 内部参数说明

接入模型 LongCat

LongCat 平台介绍

LongCat 是美团开发的大语言模型，提供高性能的通用对话和深度思考模型。目前平台支持的模型如下：

账号注册与 API Key 获取

1. 访问 LongCat 开放平台注册账号
2. 新用户注册后可获得 500 万 Token 的免费额度
3. 进入 API Keys 页面创建并获取 Key
4. 在用量信息页面可随时查看 Token 消耗情况

完整配置示例

以下配置展示了如何完整接入 LongCat 模型：

{"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"}}]}}}}

配置说明：

• 将 YOUR_API_KEY_HERE 替换为实际申请的 API Key
• contextWindow: 200000 表示支持 20 万 Token 的上下文窗口
• maxTokens: 8192 表示单次响应最大 Token 数
• 修改保存后配置立即生效，无需重启服务

GUI 界面配置方式

除了直接改配置文件，也可以通过 Web 控制页面可视化配置：

1. 访问 http://127.0.0.1:18789 打开 OpenClaw Web 控制页面
2. 进入 Config → Models → Providers
3. 添加以下配置项：

效果演示

启动后 AgentModel 会显示为我们自定义的 LongCat-Flash。

询问具备的能力与使用的模型时，可以看到正确识别。

完成本地桌面文件查找任务。

注意事项

1. 配置文件位置：OpenClaw 的配置文件位于 ~/.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 配置指南
• LongCat API Keys 管理页面