飞书配置OpenClaw
飞书是字节跳动旗下的一站式AI工作平台与协作办公套件,最初是字节跳动在2016年为保障其全球数万员工高效协作而自主研发的内部工具，于2020年2月24日正式向全国所有企业和组织免费开放。
飞书功能主要有如下三部分：
- 协同办公：即时沟通、云文档、日历、音视频会议。
- 业务提效：多维表格、审批、合同、报销等。
- 组织管理：招聘、绩效、人事等功能。
OpenClaw通过飞书开放平台的WebSocket事件订阅与飞书机器人连接，无需暴露公网Webhook URL。当用户在飞书中@机器人或发送私聊消息时，事件通过长连接推送给OpenClaw网关，再由相应的AI智能体处理并回复。
本小节将介绍如何将OpenClaw集成到飞书机器人，配置过程具体参考：https://docs.openclaw.ai/zh-CN/channels/feishu#快速开始 。 使用效果如下：
第一步-创建飞书应用
访问飞书开发平台 https://open.feishu.cn/app ，使用飞书账号登录。
1) 创建应用
点击“创建企业自建应用”，填写应用名称和描述，选择图标：
在应用的“凭证与基础信息”页面可以查看应用凭证 APPID 和 AppSecret ，如下：
2) 配置应用权限
在权限管理页面，点击“批量导入”按钮，粘贴以下 json 配置，一键导入所需权限：
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource",
"sheets:spreadsheet",
"wiki:wiki:readonly"
],
"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
}
}
3) 启动机器人能力（可选）
在“应用能力”部分找到“机器人”，开启机器人能力，配置名称。
4)配置事件订阅
5) 发布应用
在“版本管理与发布”页面创建版本，提交审核并发布，等待审批（企业自建应用通常自动通过）。
然后登录飞书电脑客户端（需要提前安装），可以看到“开发者小助手”中会有提示，审核通过。
以上配对码，后续需要用到。
第二步-配置OpenClaw
在OpenClaw中添加飞书聊天渠道。直接在Ubuntu客户端运行向导，添加飞书：
openclaw onboard
如果出出现问题 Plugin install failed: feishu is disabled (blocked by allowlist) ，如下图所示
则需要在 ~/.openclaw/openclaw.json 中 plugins 中的 allow 中添加 feishu ，如下所示配置
第三步-启动并测试
在飞书中找到创建的机器人进行对话进行测试，默认情况对话首次，会返回一个配对码：
你需要在Ubuntu终端执行如下命令与OpenClaw进行配对：
openclaw pairing approve feishu <配对码>
对话如下：
可以在 Ubuntu 中看到对应的文件和内容：
