OpenClaw 接入自定义模型并通过 WebUI 实现智能操作

OpenClaw 接入自定义模型并通过 WebUI 实现智能操作

背景与架构

OpenClaw（原 Clawdbot）是一个开源 AI 代理框架，支持通过配置文件或 GUI 界面进行灵活配置。安装完成后，用户只需修改工作目录下的 openclaw.json 即可接入不同的 LLM 模型提供商。

框架本身支持众多主流服务商，如 OpenAI、Anthropic、Moonshot AI（Kimi）、OpenRouter 等。如果想接入官方列表之外的兼容服务，只需在 models.providers 字段中补充配置即可。

核心配置逻辑

OpenClaw 的模型配置主要涉及两个部分：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"}]}}}}

关键参数说明

参数	位置	说明
primary	agents.defaults.model	必填。格式为 提供商/模型 ID，必须与 providers 中的名称对应
mode	models	配置模式，merge 表示合并现有配置，replace 表示完全替换
providers	models	定义模型提供商的配置集合

注意：配置完 providers 后，务必同步设置 agents.defaults.model.primary，否则系统无法识别默认主模型。

providers 内部参数详解

参数	说明
baseUrl	模型 API 的基础 URL 地址
apiKey	认证密钥，支持环境变量引用 ${ENV_NAME} 或直接填写
api	API 类型，通常为 openai-completions
models	该提供商支持的模型列表，包含 id 和 name

接入 LongCat 模型实战

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

账号准备

1. 访问 LongCat 开放平台注册账号，新用户通常有免费 Token 额度。
2. 进入 API Keys 页面创建并获取密钥。
3. 在用量页面监控 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 替换为实际申请的 Key。
• contextWindow 设为 200000 表示支持 20 万 Token 上下文。
• 修改保存后配置立即生效，无需重启 Gateway 服务。

WebUI 可视化配置

除了编辑文件，也可以通过 Web 控制页面进行图形化配置：

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

配置项	值
Api	openai-completions
Api Key	你的 LongCat API Key
Base Url	https://api.longcat.chat/openai
models - id	LongCat-Flash-Chat
models - name	LongCat-Flash-Chat

效果验证

启动后，AgentModel 应显示为我们配置的 LongCat-Flash。

询问模型能力及使用情况时，系统会返回对应的模型信息。

完成本地桌面文件查找等操作时，可观察到模型的实际推理表现。

注意事项

1. 配置文件路径：默认位于 ~/.openclaw/openclaw.json。
2. WebUI 端口：默认监听 18789，访问地址为 http://127.0.0.1:18789。
3. 调试接口：OpenClaw 使用 WebSocket 通信，Chrome 开发者工具可连接 ws://127.0.0.1:18789/ 查看日志。
4. 生效机制：修改 openclaw.json 保存即生效，无需重启服务。

参考资料

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