飞书渠道配置

创建飞书应用

1. 访问开放平台

访问：https://open.feishu.cn/app

2. 创建应用

1. 点击「创建企业自建应用」
2. 填写应用名称和描述
3. 记录 App ID 和 App Secret

配置权限

必要权限

在应用管理后台 → 权限管理，添加：

• im:message - 获取与发送消息
• im:message:send_as_bot - 以应用身份发消息
• im:chat - 获取群组信息
• contact:user.employee_id:readonly - 获取用户信息

可选权限（文档/多维表格）

• docx:document - 文档读写
• bitable:app - 多维表格读写
• drive:drive - 云空间访问
• wiki:wiki - 知识库访问

配置事件订阅

1. 设置请求网址

https://你的域名/openclaw/feishu/webhook

2. 添加事件

• im.message.receive_v1 - 接收消息

配置 OpenClaw

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxxxxxxxx",
      "appSecret": "你的_APP_SECRET",
      "domain": "feishu",
      "groupPolicy": "open",
      "dmPolicy": "open",
      "allowFrom": ["*"]
    }
  }
}

参数说明

参数	说明
enabled	是否启用
appId	飞书应用 ID
appSecret	飞书应用密钥
domain	域名（通常为 feishu）
groupPolicy	群聊策略
dmPolicy	私聊策略
allowFrom	允许的用户列表，["*"] 表示全部

发布应用

1. 创建版本

在飞书开放平台 → 版本管理与发布 → 创建版本

2. 提交审核

填写版本说明，提交审核

3. 发布上线

审核通过后点击发布

4. 添加到会话

在飞书客户端搜索应用名称，添加到群聊或私聊

重启服务

openclaw gateway restart

验证配置

检查权限

openclaw feishu:scopes

测试对话

在飞书中向机器人发送消息测试

飞书特性

富文本消息

飞书支持富文本格式，OpenClaw 会自动转换 Markdown。

卡片消息

可以通过自定义系统提示让 AI 生成卡片消息格式。

多维表格

配置 bitable:app 权限后，可以读写飞书多维表格。

常见问题

Webhook 验证失败

1. 确认域名解析正确
2. 确认 HTTPS 证书有效
3. 确认 OpenClaw 服务正常运行

权限不足

检查应用权限配置，确保已添加必要权限并发布新版本。

消息无响应

1. 检查事件订阅是否正确
2. 查看日志：openclaw logs --follow

---

相关文档：

• OpenClaw 安装指南
• Telegram 渠道配置
• Notion 集成配置