OpenClaw 飞书机器人权限配置与安全指南

为了保障 OpenClaw 飞书机器人稳定运行且避免权限过大带来的安全隐患，建议在飞书开发者后台的权限管理中按以下清单勾选。

权限配置清单

基础必备权限

无论个人还是团队场景，以下权限是机器人正常交互的基础：

• im:message:p2p_msg:readonly：接收单聊消息，允许与你一对一沟通。
• im:message:group_at_msg:readonly：接收群聊@消息，仅在被提及时响应，保护群隐私。
• im:message.p2p_msg:send：发送单聊回复。
• im:message.group_msg:send：在群聊中回复大家。

进阶功能权限

如需处理文档、查看成员或发送富媒体，请按需开启：

• 文档/表格处理：
  • drive:file:readonly：读取云文档或 Excel 进行分析。
  • sheet:spreadsheet:readonly：专门用于自动化报表读取。
• 身份识别（团队推荐）：
  • contact:user.id:readonly：辅助区分指令来源，实现权限隔离。
• 富媒体发送：
  • im:resource:upload：若需 AI 绘图或生成文件发回，必须勾选。

⚠️ 安全红线：如无特殊需求，保持关闭。

• im:message:everything:readonly：极度危险，会监听所有闲聊，易触发合规风险。
• contact:contact:readonly：除非需要基于职位的复杂审批流，否则勿开。

部署与密钥安全

发布生效

权限勾选后，务必在飞书后台点击'版本管理与发布'，创建新版本申请上线，权限才会正式生效。

IP 白名单

在'安全设置'中，强烈建议填入部署机器的固定公网 IP，防止 App Secret 泄露后被冒用。

密钥管理方案

将 App ID 和 App Secret 明文写在配置文件（如 config.yaml）中存在极大风险。为兼顾安全与可用，推荐以下三种方案：

方案一：环境变量（推荐）

通过操作系统环境变量注入，而非写死在代码中。

修改配置文件引用变量：

lark:
  app_id: ${LARK_APP_ID}
  app_secret: ${LARK_APP_SECRET}

服务器设置环境：

• Linux/Mac：终端执行 export LARK_APP_ID="你的 ID"。
• Docker：在 docker-compose.yml 中配置：

environment:
  - LARK_APP_ID=cli_xxxxxxxx
  - LARK_APP_SECRET=xxxxxxxxxxxx

方案二：.env 文件（本地开发）

配合 .gitignore 防止泄露。

1. 在项目根目录新建 .env：

LARK_APP_ID=cli_a1b2c3d4
LARK_APP_SECRET=secret_e5f6g7h8

2. 确保 .gitignore 包含 .env。
3. OpenClaw 启动时自动加载。

方案三：文件权限锁定

若必须写入文件，需加固权限：

1. 限制访问：Linux 下执行 chmod 600 config.yaml，仅运行用户可读。
2. 加密存储：进阶用户可使用 sops 或 ansible-vault 加密，启动时输入口令解密。

避坑指南

• 严禁硬编码：不要在 main.py 或源码中直接写 app_id = "xxx"。
• 定期轮换：每 3-6 个月重置 App Secret 并同步更新。
• 日志屏蔽：检查日志输出，确保不打印 Secret 到控制台或 log 文件。