准备账号与主机
使用准备持有应用的飞书身份和租户。该身份需要能访问开放平台并创建、发布企业自建应用；部分租户需要管理员审核发布或权限，配置前先确认审核方式。
保持执行主机上的 Rovai 桌面应用与队员智能体可用，先在本地完成一条简单会话。本教程先用已发布队员机器人测试所有者私聊，再建立仅含所有者和该机器人的专用演示群。
飞书与 Lark 是不同平台，请选择租户实际所属的平台；飞书连接不能等同于 Lark 连接。
从 Rovai 桌面端登录
- 打开“设置 → 渠道”，选择飞书，在桌面端发起开发者账号登录。
- 用飞书客户端完成平台登录，在确认界面核对授权身份与租户。有效登录二维码不要放进教程或支持消息。
- 回到渠道页，确认显示的开发者身份。登录只是建立账号上下文，不会自动发布全部队员。
发布选定队员
- 在飞书区域选中要开放的队员，使用该队员的发布操作。先核对职责与智能体配置；每位已发布队员对应自己的机器人身份。
- Rovai 会推进应用创建或复用、机器人能力、权限与事件设置、版本发布和连接验证。停住时查看当前阶段，不要因验证耗时而重复创建平台应用。
- 需要租户审核时，打开该应用的官方平台入口，核对应用身份、请求能力和可用成员范围，再请租户管理员在平台完成审核。回到 Rovai，对同一个应用继续或重新验证。
- 等待发布与连接都成功。“已创建应用”“已提交版本”和“机器人已连接”是不同节点。账号登录由原生桌面端完成，桌面 Web 入口不能替代这一步。
在飞书平台核对发布
- 在飞书开放平台控制台打开同一个应用，对照 Rovai 显示的应用名称与 App ID，并确认所属租户。
- 在应用能力中确认已添加机器人。Rovai 的受管发布负责配置机器人、权限与事件；配置未完成时，结合 Rovai 报告的具体阶段检查。
- 进入“版本管理与发布”，打开已提交版本，查看发布状态与可用成员范围。若正在等待审核，请有权限的租户管理员审核该版本及其请求的权限。
- 平台显示版本已发布、当前账号属于可用范围后，回到 Rovai 的同一队员继续验证连接，再在飞书找到该机器人，发送下面的小范围文字请求。
飞书平台参考
找到渠道入口
发送第一条私聊请求
- 在飞书中找到与目标队员同名的已发布机器人，使用连接所属账号打开它的私聊。
- 首次发送下面这条纯文字请求，不需要选择项目或访问文件。
- 观察执行卡片和最终文字回复；在 Rovai 主机中打开对应快速对话，检查同一请求与执行。卡片提供“显示最近输出”或“打开执行台”时，使用当前主机已配置的可用入口。
- 核对回复中的平台名称。请求送达、卡片运行和最终回复是不同证据，不能把按下发送当成连接成功。
实测使用的请求
这是 Rovai 官网渠道教程的演示请求。请为 Orbit 下载页整理三条简短的平台选择说明：Apple Silicon、Intel、Windows x64。每条说明适合哪种电脑，并提醒这是教程示例。只回复文字，不读写文件，不联系其他队员。
实际收到的结果
实测在 Orbit 专用群里分别发送中英文请求，执行卡从“执行中”变为“已完成”。回复分别把 Apple Silicon 对应到 Apple M 系列 Mac，把 Intel 对应到 Intel Mac，把 Windows x64 对应到运行 64 位 Windows 的 Intel/AMD x64 电脑；每条均标注教程示例。
这验证了已有连接下的私聊收发，以及新群选择快速对话后的寻址和回复；没有验证首次发布、绑定具体项目的群、附件、Lark 或钉钉。本次素材不包含真实账号周边的聊天历史。
截图中的专用群操作
- 创建仅含自己账号的群，在群设置 → 群机器人 → 添加机器人中选择已发布队员，核对身份后添加。
- 在输入区键入 @，从实际提及选择器中选中机器人，再填写有边界的请求并发送。
- 本次是纯文字教程，在 Rovai 项目选择卡片点击“开始快速对话”；依赖文件的请求则应选择主机上的正确项目。
- Rovai 会建立对应会话，核对入站消息、运行队员和最终回复与外部群一致。后续英文请求沿用了已建立的群会话。
选择首次工作上下文
Rovai 中的请求与执行
收到实际回复
需要群聊时再建立关联
建立专用群，添加目标已发布机器人及需要参与的人，再用飞书真正的提及选择器选中机器人。群组或话题首条有效请求可以出现项目选择或快速对话入口，应明确选择主机项目。
建立后，外部会话关联保持稳定；后续消息不会悄悄切换到另一个项目。同在飞书群里也不意味着每个人自动获得操作 Rovai 所有者电脑的权限，当前入站所有权检查仍然适用。
按环节排查
- 搜不到机器人
- 检查应用身份、发布状态及平台可用成员范围，确认在正确飞书租户中查找。
- 消息到达但未开始
- 检查所有者账号、连接主机、队员可用性及当前执行或队列。不要反复发送会改文件的同一请求。
- 发布停住
- 阅读当前阶段和原因，先完成平台待审核事项，再继续验证已有应用，避免重复创建。
- 输出入口不可用
- 浏览器执行链接需要可用的 Web 入口；未配置时直接查看聊天最终回复和主机执行记录。