OpenClaw的配置文件位于 ~/.openclaw/openclaw.json（Windows上通常在 C:\Users\你的用户名\.openclaw\openclaw.json）。这篇教程将详细讲解配置文件的各个部分，让你能够根据自己的需求进行定制。
💡 提示
修改配置文件后，需要重启OpenClaw才能生效。使用 openclaw restart 命令重启。
配置文件结构概览
配置文件包含以下主要部分：
- meta - 元信息
- env - 环境变量
- models - 模型配置
- agents - 代理配置
- channels - 通讯频道
- gateway - 网关设置
- plugins - 插件管理
1. 模型配置 (models)
模型配置决定了AI使用哪个大语言模型。
models.providers
配置AI模型供应商，目前支持：
- huoyuanqudao - 资源渠道（MiniMax等）
- openai - OpenAI GPT系列
- anthropic - Claude系列
配置示例
"models": {
"mode": "merge",
"providers": {
"huoyuanqudao": {
"baseUrl": "https://mydmx.huoyuanqudao.cn/",
"apiKey": "你的API密钥",
"api": "anthropic-messages",
"models": [
{
"id": "MiniMax-M2.5-highspeed",
"name": "MiniMax-M2.5高速版",
"reasoning": false,
"contextWindow": 128000,
"maxTokens": 4096
}
]
}
}
}💡 如何修改
更换模型时，只需修改 apiKey 和 models[].id 即可。不同的模型供应商有不同的API密钥获取方式。
2. 代理配置 (agents)
代理配置定义了你的AI助手的行为。
agents.defaults
默认代理设置：
- model - 默认使用的模型
- workspace - 工作目录
- maxConcurrent - 最大并发数
配置示例
"agents": {
"defaults": {
"model": {
"primary": "huoyuanqudao/MiniMax-M2.5-highspeed",
"fallbacks": []
},
"workspace": "D:\\openclaw-workspace",
"maxConcurrent": 4
},
"list": [
{
"id": "main",
"model": "huoyuanqudao/MiniMax-M2.5-highspeed",
"heartbeat": {
"every": "1h"
}
}
]
}💡 代理ID的作用
id 是代理的唯一标识符。你可以创建多个代理（subagents）来处理不同任务，通过agents.list添加。
3. 通讯频道配置 (channels)
频道配置让你的AI可以在不同的通讯平台上运行。
支持的频道
- qqbot - QQ机器人
- dingtalk - 钉钉
- feishu - 飞书
- wecom - 企业微信
- telegram - Telegram
QQ机器人配置示例
"channels": {
"qqbot": {
"enabled": true,
"appId": "你的AppID",
"clientSecret": "你的ClientSecret",
"markdownSupport": true,
"allowFrom": ["*"]
}
}钉钉配置示例
"channels": {
"dingtalk": {
"enabled": true,
"clientId": "你的ClientID",
"clientSecret": "你的ClientSecret",
"dmPolicy": "open",
"groupPolicy": "open",
"debug": true
}
}💡 启用/禁用频道
将 enabled 改为 false 即可禁用某个频道，改为 true 启用。
4. 网关配置 (gateway)
网关配置控制OpenClaw服务器的运行方式。
gateway
- port - 服务端口（默认18789）
- mode - 运行模式（local/remote）
- bind - 绑定地址（loopback/all）
- auth - 认证设置
配置示例
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"auth": {
"mode": "token",
"token": "你的认证token"
}
}5. 插件配置 (plugins)
插件用于扩展OpenClaw的功能。
plugins.entries
控制每个插件的启用状态：
"plugins": {
"entries": {
"dingtalk": { "enabled": true },
"feishu": { "enabled": true },
"qqbot": { "enabled": true },
"wecom-openclaw-plugin": { "enabled": true }
}
}6. 环境变量 (env)
用于存储API密钥等敏感信息。
"env": {
"OPENROUTER_API_KEY": "sk-or-..."
}⚠️ 安全建议
不要将配置文件分享给他人，里面包含你的API密钥。如果密钥泄露，请及时在供应商后台重置。
常用配置修改示例
1. 更换AI模型
# 修改默认模型
"defaults": {
"model": {
"primary": "huoyuanqudao/其他模型ID"
}
}2. 更改工作目录
"defaults": {
"workspace": "D:\\你的工作目录"
}3. 更改服务端口
"gateway": {
"port": 20000
}4. 禁用某个频道
"channels": {
"dingtalk": {
"enabled": false
}
}总结
OpenClaw的配置文件非常灵活，通过不同的配置组合可以实现：
- 切换不同的AI模型
- 接入多个通讯平台
- 配置多个子代理
- 自定义插件功能
希望这篇教程能帮助你更好地配置OpenClaw！有问题欢迎在留言板交流～