概述
OpenClaw(原Clawdbot)是一款开源的本地优先AI 代理与自动化平台。您可以通过OpenClaw将多渠道通信能力与大语言模型深度集成,创建拥有持久记忆与主动执行能力的定制化 AI 助理。本文介绍通过OpenClaw集成飞书。
重要:OpenClaw 为开源 AI 助手,请在使用前充分评估其安全性与稳定性并严格遵循许可协议,以切实保障您的系统环境与数据安全。
1. 请避免在 OpenClaw 中绑定生产级敏感账号。如需使用 API 服务,建议使用受限的 API Key 或临时 Token,并建立定期轮换机制,以降低密钥泄露带来的风险。
2. 建议优先使用天翼云官方提供的skills与插件,避免安装来源不明的第三方技能,防止恶意代码注入。
3. 请通过密码或 Token 对 OpenClaw 服务进行访问授权,严格限制访问 IP 范围,避免公网暴露,拦截非授权访问请求。
4. 建议启用详细的日志记录与行为监控,对操作行为和数据处理过程进行持续审计,及时发现并处置异常行为。
步骤一:部署OpenClaw
在应用托管部署OpenClaw,详见 通过应用托管部署OpenClaw 。
步骤二:集成飞书
说明:应用托管的OpenClaw应用最新版本默认已内置飞书插件,无需额外安装。
前提条件
已注册飞书账号。
创建飞书应用
创建应用
飞书开发者平台申请应用。点击【创建企业自建应用】。
在弹窗中填写应用名称和描述,选择应用图标,点击【创建】按钮提交表单。
查看应用 APP ID 和 APP Secret
点击创建完成的应用名称,进入应用详情,在左侧菜单选择【凭证与基础信息】,在应用凭证页面,复制APP ID和APP Secret,用于下一步配置OpenClaw。
配置飞书机器人
添加机器人
在应用能力中,选择添加“机器人”。
应用权限开通
在应用详情页,左侧菜单选择【权限管理】,点击【批量导入/导出权限 】按钮,粘贴以下 JSON 配置,单击【下一步】,确认新增权限,单击【申请开通】。
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"]
}
}事件与回调配置
进入OpenClaw使用界面,选择左侧的【频道】菜单,Feishu中分别配置在飞书获取的APP ID和APP Secret并启用Enabled。点击页面的【Save】按钮保存配置,再点击【Reload】按钮,使配置生效。
在飞书开放平台点击左侧菜单【事件与回调】,在【回调配置】页签订阅方式选择“长连接”;在【事件配置】页签中点击订阅方式,选择使用 “长连接” 接收事件,单击保存。
3. 在【事件配置】页签添加事件订阅如下:im.message.receive_v1(接收消息),点击【确认添加】。
发布应用
在应用详情页,左侧菜单选择【版本管理与发布】,点击右上角【创建版本】,新建版本并发布。
步骤三:测试机器人
进入飞书应用,找到OpenClaw机器人,发送消息。如果使用2.26及以上版本,获取OpenClaw回复的配对命令。
2. 在OpenClaw对话页面输入openclaw pairing approve feishu {配对码} 完成配对。
3. 配对完成后即可与OpenClaw机器人交互。