Skip to content

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 即可。