Appearance
channels.feishu 报错:invalid config: must NOT have additional properties
来源:GitHub #56883
问题
将 OpenClaw 从 3.24 升级到 3.28 后,Gateway 无法启动。运行 openclaw doctor --fix 时提示:
Invalid config: channels.feishu: invalid config: must NOT have additional properties解决方案
这是因为在 2026.3.28 版本的更新中,OpenClaw 收紧了飞书(Feishu)配置的 JSON Schema 校验规则,旧版本中的某些多余或废弃字段不再被允许。
修改 openclaw.json 中的 feishu 块,确保 channels.feishu 配置严格遵循以下结构,移除所有未在下面列出的多余字段:
json5
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"groupPolicy": "open",
"accounts": {
"main": {
"appId": "你的_APP_ID",
"appSecret": "你的_APP_SECRET"
// 可选字段:
// "encryptKey": "...",
// "verificationToken": "...",
// "name": "...", // 注意:新版用 name 替代了旧版的 botName
// "enabled": true
}
}
}特别是如果你在旧版本中使用了 botName 字段,请将其修改为 name,并删除任何其他非法属性。修改完成后重启 Gateway 即可。