OpenClaw 飞书群消息配置：requireMention 详解

什么是 requireMention？

requireMention 控制群聊中是否需要 @机器人 才能触发回复：

• requireMention: true（默认）- 只有 @机器人 时才会响应
• requireMention: false - 所有消息都会触发机器人

配置方法

在 openclaw.json 中配置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "groupPolicy": "open",
      "groups": {
        "oc_xxx": {
          "requireMention": false,
          "enabled": true
        }
      }
    }
  }
}

配置层级

requireMention 可以在多个层级设置：

1. 群级别（最优先）：groups.oc_xxx.requireMention
2. 账号级别：accounts.main.requireMention
3. 全局默认：requireMention: true（默认）

使用场景

requireMention: true（推荐）

• 适合大多数群聊
• 只有被 @ 时才回复
• 避免刷屏，不会打扰群友

requireMention: false

• 需要机器人监听所有消息
• 可以用于记录群聊上下文
• ⚠️ 注意：每条消息都会触发，API 调用量会增加

修改配置后

修改配置后需要重启 Gateway：

openclaw gateway restart

常见问题

能不能让机器人只监听但不回复？

目前 OpenClaw 不支持这个功能。requireMention: false 会触发回复，requireMention: true 则不会处理未被 @ 的消息。

DM 私聊需要 @ 吗？

不需要。私聊默认直接发消息就会触发。

获取群 ID

首先需要知道目标群的 chat_id（格式：oc_xxx）。

1. 启动 OpenClaw 网关：

   openclaw gateway

2. 在目标群里 @ 机器人发送任意消息
3. 查看日志：

   openclaw logs --follow

4. 找到 chat_id 字段

进阶配置

限制可发言的用户

{
  "channels": {
    "feishu": {
      "groups": {
        "oc_xxx": {
          "requireMention": false,
          "allowFrom": ["ou_user1", "ou_user2"]
        }
      }
    }
  }
}

只允许特定群

{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["oc_xxx", "oc_yyy"]
    }
  }
}