3.1 飞书配置全攻略（深度版）

概述

一、本章定位

第二章的 2.5 节已经详细介绍了飞书渠道的配置步骤，本章在此基础上补充进阶配置和安全设置，帮助深度使用飞书渠道。

建议先阅读 2.5 节，再阅读本章进阶内容。

二、飞书渠道配置进阶项

2.1 dmPolicy：私聊权限模式

dmPolicy（Direct Message Policy）决定谁能私聊 AI。

"channels": {
  "feishu": {
    "dmPolicy": "allowlist",
    "allowFrom": [
      "ou_ad46e84e3a350383501abd6297e89988",
      "ou_8e84452b9ef004b1ae39b546ceca0901"
    ]
  }
}

2.2 allowFrom：白名单用户列表

只有 dmPolicy 为 allowlist 时，allowFrom 数组才生效。

如何获取飞书用户的 Open ID：

2.3 groupPolicy：群聊权限模式

"channels": {
  "feishu": {
    "groupPolicy": "mention"
  }
}

推荐设置：mention，避免群里任何人说什么 AI 都响应。

2.4 多机器人配置

OpenClaw 支持配置多个飞书机器人：

"channels": {
  "feishu": {
    "accounts": {
      "default": {
        "appId": "cli_第一个机器人的AppId",
        "appSecret": "*"
      },
      "assistant": {
        "appId": "cli_第二个机器人的AppId",
        "appSecret": "*"
      }
    }
  }
}

使用场景：

• 不同的机器人服务不同的用户群
• 一个做客服，一个做数据分析

三、安全设置

3.1 防止陌生人滥用

如果 dmPolicy 设置为 open，必须设置每日消息限制：

"channels": {
  "feishu": {
    "dmPolicy": "open",
    "rateLimit": {
      "maxPerDay": 100,
      "maxPerUser": 10
    }
  }
}

3.2 内容过滤

开启敏感词过滤：

"channels": {
  "feishu": {
    "contentFilter": {
      "enabled": true,
      "blockedPatterns": ["敏感词1", "敏感词2"]
    }
  }
}

3.3 日志审计

记录所有消息以便排查问题：

"channels": {
  "feishu": {
    "auditLog": {
      "enabled": true,
      "path": "/var/log/openclaw/feishu-audit.log"
    }
  }
}

四、消息处理进阶

4.1 消息预处理

在消息到达 AI 之前，可以进行预处理：

4.2 消息分流

根据消息内容，分流到不同的处理逻辑：

五、常见飞书配置问题排查

六、完整配置示例

"channels": {
  "feishu": {
    "appId": "cli_xxxxxxxxxx",
    "appSecret": "*",
    "dmPolicy": "allowlist",
    "allowFrom": [
      "ou_ad46e84e3a350383501abd6297e89988",
      "ou_8e84452b9ef004b1ae39b546ceca0901"
    ],
    "groupPolicy": "mention",
    "streaming": true,
    "enabled": true
  }
}

七、下一步学什么

• 3.2 钉钉配置全攻略（深度版） → 钉钉的进阶配置
• 3.7 渠道权限管理 → 精细化控制谁能访问什么
• 3.8 常见渠道问题排查 → 遇到问题时快速定位

飞书配置复杂是正常的，多配置几次就熟练了！有问题群里问 💪

常见问题