文章目录前言一、安装飞书官方插件二、创建企业自建机器人三、Openclaw配置文件修改四、用户OU和群oc查询方式1、群oc查询2. 用户ou查询五、常见问题前言先准备好已经安装好的 OpenClaw如果没有安装的可以移步进行安装OpenClaw【Windows版】安装、配置、API接入、卸载全流程小白指南其实飞书官方也出了部署openclaw的安装教程也可以作为参考OpenClaw 飞书官方插件使用指南公开版一、安装飞书官方插件在命令行终端中执行以下安装指令。npx-ylarksuite/openclaw-larkinstall执行过程中可通过飞书客户端扫描二维码在客户端选择一键创建飞书机器人或选择已有机器人。windows版本可能会因为终端分辨率问题导致扫码不上可以下载Cmder进行安装。其实安装完成这一步骤飞书私人版助手已经搭建成功但存在无法开启外部共享也就是只能自己用不能和外部用户拉群使用。如果有群需求的话可以将外部群转换为内部群然后再创建企业自建应用移步下面章节。二、创建企业自建机器人首先登录飞书开放平台进入开发者后台点击「创建企业自建应用」。填写应用名称和描述按照自己意愿随便填写即可。创建完成后进入应用详情页在「添加应用能力」中点击添加机器人能力之后进行权限开通这里可以按照给出来的json直接选择批量导入可以根据个人习惯进行调整将不想开通的权限进行限制即可在这里我是根据飞书默认权限进行导入的。查看每个字段含义可参考官网OpenClaw 飞书官方插件使用指南公开版{scopes:{tenant:[application:application:self_manage,cardkit:card:read,cardkit:card:write,contact:contact.base:readonly,contact:user.basic_profile:readonly,docs:document.comment:create,docs:document.comment:delete,docs:document.comment:read,docs:document.comment:update,docs:document.comment:write_only,docx:document.block:convert,docx:document:create,docx:document:readonly,docx:document:write_only,drive:drive.metadata:readonly,im:chat,im:chat.members:bot_access,im:chat:read,im:chat:readonly,im:chat:update,im:message,im:message.group_at_msg:readonly,im:message.group_msg,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: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: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.basic_profile: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: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复制保存好下一步要用。三、Openclaw配置文件修改我们打开openclaw.json文件将appId、aapSecret进行填写以及用户和群组信息下面修改的是只有在群里艾特机器人才进行回复。如果想修改策略可参考官方说明文档。{channels:{feishu:{// [开关] 是否启用飞书渠道。enabled:true,// [凭证] 飞书开放平台应用的 App ID用于标识你的应用身份通常以 cli_ 开头。appId:cli_XXXX,// [凭证] 飞书开放平台应用的 App Secret用于验证身份。appSecret:XXXX,// [标识] 域名或渠道标识。domain:feishu,// [连接] 连接模式。websocket 表示使用长连接接收消息无需公网服务器回调地址。connectionMode:websocket,// [全局策略] 群聊消息触发规则。true 表示在群聊中必须 机器人 才会响应。requireMention:true,// [私聊策略] 访问控制模式。allowlist 表示白名单模式仅允许指定用户私聊。dmPolicy:allowlist,// [私聊白名单] 允许私聊的用户 ID 列表 (Open ID)。// 只有这里的 ID 对应的用户私聊机器人时消息才会被处理。allowFrom:[ou_XXXX,ou_XXXX],// [群聊策略] 群聊访问控制模式。allowlist 表示仅允许指定的群组使用机器人。groupPolicy:allowlist,// [群聊白名单] 允许机器人响应的群组 ID 列表 (Chat ID)。groupAllowFrom:[ou_XXXX,ou_XXXX],// [高级配置] 针对特定群组的细粒度配置对象。groups:{// 通配符 * 代表所有群组。*:{// 是否允许所有群组的消息通常配合 groupPolicy 使用作为默认规则。enabled:true},// 指定特定群组 ID 的配置例如oc_39d1...。oc_XXXX:{// [覆盖规则] 针对该特定群组强制设置是否需要 机器人。// 即使全局 requireMention 为 false这里设为 true 也会强制要求 。requireMention:true}}}}}四、用户OU和群oc查询方式1、群oc查询在群最下面有一个会话IDoc_XXXX2. 用户ou查询登录API 调试台找到发送消息接口。在 查询参数 页签将 user_id_type 设置为 open_id然后点击 快速复制 open_id。在弹窗中搜索或选择指定用户并点击 复制成员 ID获取用户的 open_id。五、常见问题1、艾特机器人无响应首先在发送消息时看下openclaw的网关终端是否有消息滚动无滚动大概率是飞书控制台配置存在问题可查看后台日志无日志输出的话大概率是事件回调出了问题