OpenClaw连接飞书(机器人)配置及相关参数说明

飞书企业自创应用机器人飞书开发者后台https://open.feishu.cn/app?langzh-CN1、创建企业自建应用填写应用名称和描述。2、添加应用能力机器人3、权限管理应用身份权限开通聊天基础如下权限其他权限视需求开放读取用户发给机器人的单聊消息im:message.p2p_msg:readonly以应用的身份发消息im:message:send_as_bot接收群聊中机器人消息事件im:message.group_at_msg:readonly获取与发送单聊、群组消息im:message发送、删除消息表情回复im:message.reactions:write_only4、事件与回调事件配置-订阅方式长连接添加事件-应用身份事件接收消息im.message.receive_v1添加后列表有一列所需权限可查看需要的权限是否都开通了缺得话点击去开通下即可。5、填写完后创建版本发布。注此时还不能飞书和自建应用(机器人)私聊或者群聊这里有两种解决方法方法一跳过验证直接在后面的OpenClaw配置时验证。方法二运行官方代码可实现给应用发消息并收到同样消息的回复。文档链接https://open.feishu.cn/document/develop-an-echo-bot/introduction下载自己熟悉的语言官方代码示例复制运行启动指令(命令里面包含应用的App ID和App Secret切换应用测试时要替换)在本地启动程序此时才能在飞书中与应用(机器人)发消息应用回复了同样的消息表示配置好了。OpenClaw源码及配置文件路径官方脚本安装后文件路径 源码安装路径 C:\Users\xxxx\AppData\Roaming\npm\node_modules\openclaw 配置文件/工作区等路径C:\Users\xxxx\.openclaw 源码目录里面有帮助文档。OpenClaw配置飞书1、OpenClaw创建Agent# 注飞书单机器人与多机器人配置文件格式不一样多机器人必须在配置文件中用accounts包裹。 # 单飞书机器人在命令行执行时顺便就能配置方便。 # 多飞书机器人在配置消息渠道时跳过需要再配置文件中手动配置。 # 这里一般只需要命令行帮创建文件和配置文件格式后面auth、model可以选择nochannels可以跳过。 openclaw agents add zhuguan openclaw agents add yuangong01 检查配置是否成功 openclaw agents list // 显示现有所有agent 配置文件的agents下会多一个list显示现有所有agent openclaw目录下生成每个agent对应的workspace的工作区。2、创建消息渠道飞书# 使用代码时删除 // 的注释信息JSON中不允许有注释。 # account_id_01accountID根据自己业务命名尽量用小写字母因为有些逻辑生成的配置文件会转成全小写的。 # defaultAccount 用于控制当出站 API 未显式指定 accountId 时使用哪个飞书账户。 channels: { feishu: { defaultAccount: main, accounts: { zhuguan: { enabled: true, name: 机器人-主管, appId: cli_xxxx, appSecret: xxxxxxxxxxxxxxx, // 私信策略 Starrt dmPolicy: pairing, // 私信策略 End // 群组策略 Starrt groupPolicy: open // 群组策略 // 群组策略 End }, yuangong01: { enabled: true, name: 机器人-员工01, appId: cli_xxxx, appSecret: xxxxxxxxxxxxx, // 私信策略 Starrt dmPolicy: open, allowFrom: [ * ], // 私信策略 End // 群组策略 Starrt groupPolicy: open // 群组策略 // 群组策略 End } } } } # 编辑完上述内容后执行openclaw doctor --fix openclaw会补充一些默认的配置OpenClaw配置文件执行子继承父配置并在子配置中可以重复配置进行覆盖。 # allowFrom 有两种配置方式 # 方法一openclaw.json文件直接配置如上配置。 # 方法二未授权的用户在飞书与机器人对话会返回一个命令管理员在openclaw中执行后会在.openclaw/creadentials下生成一个对应channels/feishu/accounts下accountId的*-allowFrom.json文件记录授权用户飞书ID。 # allowFrom 群聊授权策略同理。3.1飞书机器人-正在输入状态-开/关参数配置feishu.typingIndicator: true/false # 默认 true 参数说明 true正在输入过程。 false跳过“正在输入”反应调用。3.2、群组及私信策略了解即可OpenClaw飞书配置说明文档https://docs.openclaw.ai/zh-CN/channels/feishu 1、私信策略参考dmPolicy Value Behavior pairing 默认值未知用户会收到配对码需要管理员批准配对才能私聊机器人 allowlist 仅允许指定用户私聊机器人需配合私信 allowlistopen_id 列表参数使用 open 允许所有用户要求 allowFrom 参数中有 * disabled 禁用私信 2、群组策略groupPolicy open 允许群组中的所有人默认 allowlist 仅允许机器人在指定群组工作需配合allowedGroups参数使用 disabled 禁止机器人在任何群组工作 2. 提及要求channels.feishu.groups.chat_id.requireMention true 需要 提及默认 false 无需提及也会回复 3、飞书渠道配置参考 Setting Description Default channels.feishu.enabled 启用/禁用渠道 true channels.feishu.domain API 域名feishu 或 lark feishu channels.feishu.connectionMode 事件传输模式 websocket channels.feishu.defaultAccount 出站路由的默认账户 ID default channels.feishu.verificationToken webhook 模式必填 - channels.feishu.encryptKey webhook 模式必填 - channels.feishu.webhookPath webhook 路由路径 /feishu/events channels.feishu.webhookHost webhook 绑定主机 127.0.0.1 channels.feishu.webhookPort webhook 绑定端口 3000 channels.feishu.accounts.id.appId App ID - channels.feishu.accounts.id.appSecret App Secret - channels.feishu.accounts.id.domain 按账户覆盖 API 域名 feishu channels.feishu.dmPolicy 私信策略 pairing channels.feishu.allowFrom 私信 allowlistopen_id 列表 - channels.feishu.groupPolicy 群组策略 open channels.feishu.groupAllowFrom 群组 allowlist - channels.feishu.groups.chat_id.requireMention 要求 提及 true channels.feishu.groups.chat_id.enabled 启用群组 true channels.feishu.textChunkLimit 消息分块大小 2000 channels.feishu.mediaMaxMb 媒体大小限制 30 channels.feishu.streaming 启用流式卡片输出 true channels.feishu.blockStreaming 启用分块流式传输 true4、绑定agent与消息渠道channels# agentId在openclaw.json配置文件或者在openclaw agents list里面找。 # accountIdchannels.feishu.accounts.xxxxxxxx即为accountId。 bindings: [ { agentId: zhuguan, match: { channel: feishu, accountId: zhuguan } }, { agentId: yuangong01, match: { channel: feishu, accountId: yuangong01 } } ],5、检查绑定信息openclaw agents bindings 或 openclaw agents list --bindings6、验证openclaw与飞书配置是否生产在飞书中分别与机器人单独或拉入群中对话看是否有大模型返回的信息如果没回消息看下openclaw窗口的日志有需要开通权限的ctrl鼠标左键直接跳转开通即可。取决于单聊和群聊的策略群聊策略配置open时在群里即可聊天。私聊策略配置“dmPolicy”: pairing时默认值会返回一段授权命令执行下命令后即可聊天。执行命令后会在.openclaw/creadentials下生成一个对应channels/feishu/accounts下accountId的*-allowFrom.json文件记录授权用户飞书ID。“dmPolicy”: “open”且allowFrom中有*时则所有用户可以直接访问聊天。7、在飞书中验证配置完人设后可以在飞书中对不同的机器人通过你是谁“你能做什么”如何完成这项任务等问题测试回复效果。8、飞书调用OpenClaw日志解读09:29:3908:00 [feishu] feishu[yuangong01]: received message from ou_779089c2eca41f420101574bae2a0460 in oc_310884827e242fad8bab129831807793 (p2p) 09:29:3908:00 [feishu] feishu[yuangong01]: Feishu[yuangong01] DM from ou_779089c2eca41f420101574bae2a0460: 你用什么模型算的 09:29:3908:00 [feishu] feishu[yuangong01]: dispatching to agent (sessionagent:yuangong01:feishu:direct:ou_779089c2eca41f420101574bae2a0460) 09:30:3408:00 [feishu] feishu[yuangong01]: dispatch complete (queuedFinaltrue, replies1) 参数解释 received OpenClaw接收到飞书机器人消息 Feishu[xxx] DM from接收到的消息内容 dispatching to agent xxx消息分发给指定的agent dispatch completeOpenClaw处理完成并返回给飞书。 - queuedFinal false 未结束还在思考、还在调用工具、还在重试 true 彻底结束不会再输出了 - replies回复的消息条数。