OpenClaw 接入自定义模型与 WebUI 智能操作指南

OpenClaw 接入自定义模型与 WebUI 智能操作指南

概述

OpenClaw（前身为 Clawdbot）是一个开源的 AI 代理框架，允许用户通过配置文件或图形界面灵活调整行为。安装完成后，核心配置位于工作目录下的 openclaw.json。该框架兼容主流大模型提供商，如 OpenAI、Anthropic、Moonshot AI 等，完整列表可查阅官方文档。若需接入非官方支持的兼容服务，只需在 models.providers 中定义即可。

配置核心逻辑

配置主要涉及两个层级：models 用于声明提供商和模型元数据，agents.defaults 则指定默认运行的模型。

以接入 Kimi 为例，完整的 JSON 结构如下：

{"agents":{"defaults":{"model":{"primary":"moonshot/kimi-k2.5"}}},"models":{"mode":"merge","providers":{"moonshot":{"baseUrl":"https://api.moonshot.ai/v1","apiKey":"${MOONSHOT_API_KEY}","api":"openai-completions","models":[{"id":"kimi-k2.5","name":"Kimi K2.5"}]}}}}

这里的关键在于 agents.defaults.model.primary，它必须指向 providers 中已定义的 提供商名称/模型ID，否则系统无法识别默认模型。mode 设为 merge 表示合并现有配置，replace 则是完全覆盖。

接入 LongCat 模型实战

平台简介

LongCat 是美团开发的大语言模型平台，提供高性能通用对话及深度思考能力。目前支持 Flash-Chat、Flash-Thinking 等模型，均兼容 OpenAI 或 Anthropic 接口格式。

获取凭证

访问 LongCat 开放平台注册账号，新用户通常享有免费 Token 额度。随后在 API Keys 页面创建密钥，即可在用量中心监控消耗。

配置文件编写

以下是接入 LongCat 的完整配置示例，重点在于 baseUrl 和 apiKey 的填写：

{"agents":{"defaults":{"model":{"primary":"longCat/LongCat-Flash-Chat"},"models":{"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 替换为实际密钥。修改保存后配置即刻生效，无需重启 Gateway。上下文窗口设为 200,000 Token，单次响应最大 8,192 Token。

可视化配置

如果不习惯直接编辑 JSON，也可以通过 WebUI 操作：

1. 打开浏览器访问 http://127.0.0.1:18789。
2. 导航至 Config → Models → Providers。
3. 填入对应参数：
   • Api: openai-completions
   • Api Key: 你的 LongCat 密钥
   • Base Url: https://api.longcat.chat/openai
   • models id/name: LongCat-Flash-Chat

效果验证

启动服务后，确认 AgentModel 显示为自定义的 LongCat-Flash 模型。

询问模型能力及使用情况，确认无误。

最后测试本地文件查找功能，观察执行结果。

常见问题与提示

• 配置文件路径：默认为 ~/.openclaw/openclaw.json。
• WebUI 地址：本地访问 http://127.0.0.1:18789。
• 调试通信：使用 WebSocket 全双工通信，Chrome DevTools 可连接 ws://127.0.0.1:18789/ 查看日志。
• 生效机制：修改 JSON 后保存即生效，无需重启服务。

参考资料

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