文档目录

产品文档

自动接入飞书并完成首次对话验收

从 AI 伙伴页新增飞书渠道,完成开放平台登录和自动创建,再发送一条消息确认伙伴能够正常回复。

更新于 文档版本 1.2

把 AI 伙伴接入飞书后,你可以直接在飞书里发起任务、补充材料和接收结果。第一次接入先选一位负责人,并用一条低风险消息完成验收。收到真实回复以后,再把它加入客户群或日常工作群。

适用场景

这份步骤适合第一次给 AI 伙伴接入飞书,或旧连接已经移除、需要重新接入的情况。已经有可用飞书应用,并且准备继续使用原 App ID 和 App Secret 时,可以在接入方式里选择「关联已创建的渠道」。

开始前

确认 MotiClaw 桌面端已经可以正常使用,并且至少有一位 AI 伙伴可以接收新任务。自动创建需要本机安装 Google Chrome,还要能登录飞书开放平台。最后的消息验收需要飞书桌面端。

建议先用自己的测试会话完成第一次接入。不要一开始就在客户群或多人工作群里测试。

1. 选择这条飞书连接的负责人

打开侧边栏的「AI 伙伴」,选择负责接收飞书消息的伙伴,再进入它的渠道管理。伙伴仍在处理旧任务、处于离线状态或显示异常时,先完成原任务或处理运行问题。

MotiClaw AI 伙伴页展示多位伙伴的运行状态、渠道、任务和技能信息
先从 AI 伙伴页选定唯一负责人并核对状态,再为它新增飞书渠道。

一个会话先交给一位明确的伙伴负责。这样收到回复时,你能判断是哪位伙伴处理了消息,也能在出问题时回到同一张伙伴卡片检查。

2. 新增飞书渠道

在「已接入渠道」里点击「新增渠道」,选择「飞书」。如果这位伙伴还没有任何渠道,也可以直接从渠道接入入口选择飞书。

页面会让你选择接入方式。第一次使用时选择带有「推荐」标记的「自动创建」。只有已经准备好 App ID 和 App Secret 时,才选择「关联已创建的渠道」。

3. 完成飞书开放平台登录

自动接入会检查本机环境并打开飞书开放平台登录页。按照打开页面的提示完成登录,然后回到 MotiClaw 点击「确认已登录,继续」。

没有看到登录页时,先检查刚刚打开的 Chrome 窗口。页面仍然停在登录步骤时,重新打开登录页,完成登录后再确认一次。不要连续重复点击。

4. 等待自动接入完成

首次配置通常需要几分钟。页面会依次显示准备接入、确认登录、创建应用、接入渠道和验证连接。接入进行中时保持 MotiClaw 和登录窗口打开,不要切换到另一种接入方式。

出现「Google Chrome 未找到」时,先安装 Chrome 并放在系统常用位置,再重新开始。自动接入无法完成,但你已经有飞书应用时,可以返回并选择「关联已创建的渠道」,填入 App ID 和 App Secret。

5. 发送「你好」并确认回复

自动创建完成后,点击「打开飞书发送“你好”」。如果本机还没有飞书桌面端,先按页面提示安装,MotiClaw 检测到以后会继续显示发送入口。

在打开的飞书对话里发送「你好」,等待当前 AI 伙伴回复。回到 MotiClaw 检查自动确认结果。页面要求人工确认时,核对回复来自刚刚选择的伙伴,再完成设置。

完成标准

飞书对话已经收到当前 AI 伙伴的真实回复,MotiClaw 的已接入渠道列表显示飞书可以通信。后续把伙伴加入真实工作群时,再发送一条范围小、可以立即检查结果的任务。

常见问题

  • 登录后没有继续 回到 MotiClaw 点击「确认已登录,继续」。仍未检测到时,重新打开登录页并确认当前 Chrome 窗口已经登录正确账号。
  • 自动创建停留很久 保持窗口打开,先看页面正在执行哪一步。出现排查码时保存截图,再按页面给出的下一步处理。
  • 飞书没有打开 确认飞书桌面端已经安装并可以正常登录,然后回到 MotiClaw 重新打开对话。
  • 收到的回复属于另一位伙伴 停止确认,回到 AI 伙伴页核对负责人和当前连接,再重新发送本轮测试消息。
  • 已经有飞书应用 返回接入方式,选择「关联已创建的渠道」,从飞书开放平台复制 App ID 和 App Secret,保存后仍要发送「你好」完成消息验收。

相关页面

需要管理多种渠道、处理待配置状态或选择默认渠道时,阅读「给 AI 伙伴接入和管理渠道」;需要先确认伙伴是否适合接新任务时,阅读「检查 AI 伙伴状态并决定下一步」。

数据边界

工作数据默认留在本机;仅你主动接入的渠道与模型调用按任务所需出网。