OpenClaw 渠道配置(Discord / 飞书 / 钉钉)¶
OpenClaw 的渠道配置在 ~/.openclaw/openclaw.json 的 channels 段。openclaw.json.example 里的渠道段默认 enabled: false、凭证为 __OPENCLAW_*__ 占位符 —— start.sh 首次启动时会从 .env 注入实际凭据;enabled 开关不在脚本改动范围内(示例里是 false,需手动改成 true)。
实际支持的渠道取决于已安装的插件。钉钉通过第三方 dingtalk-connector 插件接入;Discord / 飞书走官方外部插件 @openclaw/discord / @openclaw/feishu(不在核心包内,需 openclaw plugins install 装进数据目录)。官方插件与核心同版本号配套发布,升核心时必须一并升 —— 守卫 tests/test-openclaw-plugin-versions.sh。
Discord Bot¶
- 在 Discord Developer Portal 创建 Bot,获取 Token
- 编辑
~/.openclaw/openclaw.json,在channels下添加:
{
"channels": {
"discord": {
"enabled": true,
"token": "YOUR_DISCORD_BOT_TOKEN",
"dmPolicy": "allowlist",
"groupPolicy": "open",
"allowFrom": ["YOUR_DISCORD_USER_ID"],
"streaming": { "mode": "partial" }
}
}
}
飞书 Bot¶
- 在飞书开发者后台创建应用,获取 App ID 和 App Secret
- 在「事件与回调」→「订阅方式」中选择「使用长连接接收事件/回调」
- 编辑
~/.openclaw/openclaw.json,在channels下添加:
{
"channels": {
"feishu": {
"enabled": true,
"appId": "YOUR_FEISHU_APP_ID",
"appSecret": "YOUR_FEISHU_APP_SECRET",
"domain": "feishu",
"connectionMode": "websocket",
"dmPolicy": "open",
"groupPolicy": "allowlist",
"groupAllowFrom": ["YOUR_FEISHU_GROUP_ID"],
"allowFrom": ["*"]
}
}
}
钉钉¶
通过 dingtalk-connector 插件接入。配置在 ~/.openclaw/openclaw.json 的 channels.dingtalk-connector,凭据放在其 accounts.__default__(clientId / clientSecret,由 start.sh 从 .env 注入)。
注意区分:
extensions/是数据目录下的插件安装目录(见docs/backup.md),不是配置键 —— 配置里没有extensions这一段。
配置完成后重启 OpenClaw:
验证:
docker compose logs --tail=20 openclaw-gateway
# 看到 [discord] [default] starting provider / [feishu] feishu[default]: WebSocket client started 即成功
默认模型¶
deepseek-flash(主)→ kimi-k2.6(备份)。可在 ~/.openclaw/openclaw.json 的 agents.defaults.model 中修改。