夜雨聆风
npm install -g openclaw@latest --registry=https://registry.npmmirror.comopenclaw -vnpx -y @larksuite/openclaw-lark install执行过程中，可选择新建机器人或关联已有机器人。
选择关联已有机器人时，若提示无效的AppID或AppSecret，可手动输入正确的应用凭证信息。
若选择新建机器人，可通过飞书客户端扫描二维码，选择一键创建飞书机器人。
如果Windows 设备中无法扫码成功，可能是因为终端的分辨率问题导致，建议更换终端使用Cmder。
创建完成后，点击打开机器人，在飞书中向机器人发送任意消息，即可开始对话。
若希望快速完成用户授权，便于后续OpenClaw通过你的身份完成消息、文档、多维表格、日历等任务，可以在飞书对话中发送/feishu auth来完成批量授权。
为了让OpenClaw能学会这些新技能并正确使用，建议在飞书对话中发送学习一下我安装的新飞书插件，列出有哪些能力。
验证是否安装成功：在飞书对话中发送/feishu start。若返回了版本号信息，则代表安装成功。
npx -y @larksuite/openclaw-lark@2026.4.1 install --version 2026.4.1 --tools-version 1.0.37openclaw config set channels.feishu.streaming trueopenclaw config set channels.feishu.streaming falseopenclaw config set channels.feishu.footer.elapsed true # 开启耗时openclaw config set channels.feishu.footer.status true # 开启状态展示
（2）设置多任务并行及独立上下文
机器人可在话题群/消息群话题模式中，针对每个话题拥有独立上下文以及多任务并行。
如需开启该能力，可运行指令：
openclaw config set channels.feishu.threadSession trueopenclaw config set channels.feishu.threadSession false（3）修改飞书机器人在群内的回复方式
目前插件支持的默认方式是机器人被拉进群后，只有at机器人时才可回复。
模式1：在群内机器人仅响应应用所有者（主人）@机器人的消息，不响应其他人发给机器人的消息（已作为3.17及以上版本安装时的默认策略，推荐配置）
配置方法
{"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","requireMention": true"groupPolicy": "allowlist","groupAllowFrom": ["ou_XXXX"]，"groups": { "*": { enabled: true } }}}}
将groupPolicy 设置为"allowlist"(白名单)，并通过groupAllowFrom指定允许触发机器人的用户，配置你本人openid信息。你可以直接咨询小龙虾你的openid。
再在groups中设置requireMention:true，要求消息必须@到机器人后才会回复。
模式2：只有@机器人才回复，可响应群内任何人发送的消息
配置方法
# 设置需要 @ 才回复openclaw config set channels.feishu.requireMention true --json# 重启生效sh /workspace/projects/scripts/restart.sh
{"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","requireMention": true,"groupPolicy": "open"}}}模式3：不用@，所有消息都回复
注意：这个模式在大群里容易刷屏，谨慎使用！需要额外在开发者后台申请应用身份权限：获取群组中所有消息（敏感权限）
im:message.group_msg
配置方法
# 设置不需要 @ 也回复openclaw config set channels.feishu.requireMention false --json# 重启生效sh /workspace/projects/scripts/restart.sh
{"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","requireMention": false,"groupPolicy": "open"}}}模式4：只有指定群@机器人才回复(高级)
效果
•大部分群：不用@也能回复(或者完全不回复》
•特定群：必须@才回复
•适合：不同群不同规则，比如工作群严格一点，闲聊群随意一点
配置方法
第一步：获取群ID
可通过以下任意方式获取目标群ID：
•让机器人加入群后，发送任意消息，然后在日志里找群ID，或让机器人回复群ID。
# 先设置默认所有群都不需要 @openclaw config set channels.feishu.requireMention open --json# 然后给特定群设置需要 @（这里群ID只是示例，你要替换成真实的）openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json# 重启生效sh /workspace/projects/scripts/restart.sh
{"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","requireMention": "open","groupPolicy": "open","groups": {"oc_532044075a61d112f04fa63109c75e9b": {"requireMention": true},"oc_另一个群ID": {"requireMention": true}}}}}（4）如何在飞书插件中配置OpenClaw关联多个飞书机器人，对应不同Agent
快捷方法:
1.创建新的飞书机器人，用于关联到新的账号上一键创建一个OpenClaw机器人
2.告诉AI你想创建一个怎样的新Agent，以及这个Agent关联的飞书账号是什么，并将操作指南发给OpenClaw 请他自己完成对应配置
（5）常用诊断命令与问题修复方法
可以在与OpenClaw的对话中发送以下命令：
•/feishu start:确认是否安装成功
•/feishu doctor:检查配置是否正常
•工具配置检查异常，可根据提示的命令在命令行中运行并配置
openclaw config set tools.profile "full"openclaw gateway restart
•应用身份权限未通过，可点击链接申请权限并发布应用。
•用户身份权限未通过
○如果涉及到应用权限未开通，则点击链接申请权限并发布
○如果是用户暂无授权，则在对话框输入/feishuauth批量完成用户授权
•/feishu auth:批量完成用户授权
插件中也内置了常见问题的解决方案，遇到问题都可以先问问小龙虾。如果不行，则运行以下指令查看问题，并自主修复：
npx @larksuite/openclaw-lark doctor运行 fix 尝试自动修复：
npx @larksuite/openclaw-lark doctor --fix•运行 info 查看版本信息，反馈问题时带上辅助排查。
npx @larksuite/openclaw-lark info •--all 查看详细配置信息
npx @larksuite/openclaw-lark info --all信息来源：信息来源于网络，如有侵权请联系删除
