openclaw 配置飞书详细步骤
在Docker-Compose项目目录中执行配置(特定于OpenClaw的Compose部署):
进入项目根目录,运行以下命令启动交互式配置流程:
docker-compose run --rm openclaw-cli config
配置消息通道(Channels)
在交互式菜单中选择需要配置的消息通道类型。
此处以飞书(Feishu)为例。注意:飞书开放平台支持个人开发者申请应用权限,相比其他通常要求企业资质的平台,其准入门槛更低,更适合独立开发者或小团队进行测试与集成。
系统会提示你安装必要的服务端依赖组件,请根据屏幕指引完成安装。
依赖安装成功后,命令行界面会显示确认信息。
在飞书开放平台创建应用并获取密钥
访问飞书开放平台,点击“创建企业自建应用”。
为你的AI助手应用设定一个明确的名称。
在“功能”选项卡中,为该应用添加“机器人”能力。
进入“权限管理”页面,开始配置应用权限。
选择“批量导入权限”。我们建议采用最小权限原则进行配置,仅勾选实现核心功能所必需的权限,以降低安全风险并提升应用审核通过率。以下是建议的权限JSON模板:
{"scopes": {"tenant": ["application:application:self_manage","cardkit:card:read","cardkit:card:write","contact:contact.base:readonly","docx:document:readonly","im:chat:read","im:chat:update","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message.pins:read","im:message.pins:write_only","im:message.reactions:read","im:message.reactions:write_only","im:message:readonly","im:message:recall","im:message:send_as_bot","im:message:send_multi_users","im:message:send_sys_msg","im:message:update","im:resource"],"user": ["base:app:copy","base:app:create","base:app:read","base:app:update","base:field:create","base:field:delete","base:field:read","base:field:update","base:record:create","base:record:delete","base:record:retrieve","base:record:update","base:table:create","base:table:delete","base:table:read","base:table:update","base:view:read","base:view:write_only","board:whiteboard:node:create","board:whiteboard:node:read","calendar:calendar.event:create","calendar:calendar.event:delete","calendar:calendar.event:read","calendar:calendar.event:reply","calendar:calendar.event:update","calendar:calendar.free_busy:read","calendar:calendar:read","contact:contact.base:readonly","contact:user.base:readonly","contact:user.employee_id:readonly","contact:user:search","docs:document.comment:create","docs:document.comment:read","docs:document.comment:update","docs:document.media:download","docs:document.media:upload","docs:document:copy","docs:document:export","docx:document:create","docx:document:readonly","docx:document:write_only","drive:drive.metadata:readonly","drive:file:download","drive:file:upload","im:chat.members:read","im:chat:read","im:message","im:message.group_msg:get_as_user","im:message.p2p_msg:get_as_user","im:message:readonly","offline_access","search:docs:read","search:message","sheets:spreadsheet.meta:read","sheets:spreadsheet:create","sheets:spreadsheet:read","sheets:spreadsheet:write_only","space:document:delete","space:document:move","space:document:retrieve","task:comment:read","task:comment:write","task:task:read","task:task:write","task:task:writeonly","task:tasklist:read","task:tasklist:write","wiki:node:copy","wiki:node:create","wiki:node:move","wiki:node:read","wiki:node:retrieve","wiki:space:read","wiki:space:retrieve","wiki:space:write_only"]}}
返回服务器终端配置应用凭证
完成平台端权限配置后,切换回服务器终端界面,继续输入应用凭证信息。
关键注意点:填写飞书应用的App ID与App Secret时,请确保位置准确对应,避免常见的填反错误,这会导致后续鉴权失败。
在事件订阅配置环节,选择“WebSocket”模式以获得更稳定的实时消息连接。
核心凭证配置至此基本完成。
添加事件订阅权限时,为确保机器人能处理各类交互,建议将列表中与消息、会话相关的事件全部勾选。
必须包含“接收消息v2.0”权限。缺少此权限,你的飞书机器人将处于“聋哑”状态,无法接收和响应用户的任何指令。
最后,在飞书开放平台完成应用的“版本管理与发布”流程,提交审核或发布。
在飞书移动端启用应用
通过手机飞书APP,在工作台中找到你刚创建并发布的应用,点击启用。
执行服务器端绑定命令
回到服务器命令行,运行最终的配对绑定指令。将示例中的“JK****”占位符替换为你飞书应用的实际App ID。
docker-compose run --rm openclaw-cli pairing approve feishu JK****
若所有步骤正确无误,你的飞书会话将立即收到一条来自OpenClaw Agent的问候消息。图中示例“虾总理”是预先为该Agent配置的个性化身份与对话风格。


























