扫码即连需四步：一、飞书开放平台创建企业自建应用并启用机器人及交互式卡片；二、配置im:message:send_as_bot等权限及im.message.receive_v1事件订阅，url填https://你的服务器ip:3000/webhook/feishu；三、执行hermes gateway setup→选飞书→扫码创建；四、飞书中搜索机器人并发送消息，验证终端日志与富文本回复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试将Hermes Agent接入飞书平台，但无法完成快速连接或机器人未响应，则可能是由于飞书应用凭证未正确绑定或扫码流程中断。以下是实现“扫码即连”的具体操作步骤：
一、飞书开放平台创建并启用机器人
该步骤用于在飞书侧注册合法应用身份，并赋予基础通信权限，确保 Hermes 能被飞书识别为可信服务端点。
1、访问 https://open.feishu.cn，使用企业管理员账号登录。
2、点击「创建应用」→ 选择「企业自建应用」→ 填写应用名称（如“Hermes AI 助手”）与描述 → 完成创建。
3、进入应用详情页，点击「应用功能」→「机器人」→ 开启机器人开关。
4、务必勾选「开启交互式卡片」选项，否则后续扫码配对将无法触发完整交互流程。
二、配置必要权限与事件订阅
该步骤赋予 Hermes 读取消息、发送消息及处理用户行为的最小必要权限，并建立飞书向 Hermes 推送事件的通道。
1、进入「权限管理」→「申请权限」→ 批量添加以下权限标识：
im:message:send_as_bot
im:message:read
im:message.p2p_msg:readonly
im:message.group_at_msg:readonly
contact:user.id:readonly
2、进入「事件订阅」→ 点击「添加事件」→ 搜索并启用 im.message.receive_v1。
飞书任务管理工具，支持任务的创建、查询、更新、删除及清单的管理。适用场景：创建/管理任务与清单、查看任务列表或清单中的任务、用户提及任务、待办、to‑do、清单、task时、设置负责人和关注等。
3、在「请求网址（URL）」栏填写：https://你的服务器IP:3000/webhook/feishu（需确保 Hermes 正在运行且端口可达）。
4、保存后，飞书将发起验证请求；若 Hermes 已就绪，页面会显示“验证成功”。
三、本地执行扫码启动命令
该步骤调用 Hermes 内置网关初始化逻辑，自动拉取飞书配置模板并触发二维码生成，实现免手动填参的直连模式。
1、在已安装 Hermes 的终端中执行：hermes gateway setup。
2、在交互式菜单中，使用方向键选择 飞书 并回车确认。
3、系统将提示「请选择创建方式」→ 选择 扫码创建。
4、终端将输出一个动态二维码（若环境不支持渲染，则显示等效 URL）。
5、使用飞书 App 扫描该二维码，跳转至授权页面 → 点击「同意授权」→ 完成机器人身份绑定。
四、验证扫码连接结果
该步骤通过真实消息流确认飞书与 Hermes 之间的双向通信链路已激活，且无需人工干预即可持续响应。
1、在飞书中搜索已创建的机器人名称（如“Hermes AI 助手”）。
2、点击进入私聊窗口，发送任意文本（例如“你好”）。
3、观察 Hermes 终端日志是否出现 [feishu] received message from 字样。
4、等待约3–5秒，检查飞书对话窗口是否收到结构化回复（含代码块、列表等富文本格式）。
5、若回复内容为空或延迟超10秒，检查终端是否提示 verification_token mismatch 或 app_id not found 错误。
