简要总结
Feishu
这页说明书在教你,怎么让你的AI助手和飞书聊天机器人做好朋友。飞书就像一个公司里大家用来聊天和一起工作的大玩具。你需要先安装一个叫“飞书插件”的小工具,然后去飞书那里创建一个机器人,再把机器人的“小钥匙”告诉你的AI助手。这样,AI助手就能在飞书里和你聊天啦!如果你想让AI助手在飞书里工作,就看这一页。
五岁小孩版解释
首先,我们要给AI助手安装一个叫“飞书插件”的小工具。这就像给你的玩具车装上一个新轮子,它才能跑起来。打开电脑上的“终端”(一个可以输入命令的黑色窗口),输入下面这行命令,然后按回车键:
openclaw plugins install @openclaw/feishu
安装好之后,我们就可以开始设置飞书机器人了。有两种简单的方法可以开始,一种是让一个叫“向导”的帮手带你一步步做,另一种是自己用命令来设置。
第一步:在飞书里创建你的机器人
- 打开一个叫“飞书开放平台”的网站,用你的飞书账号登录。这就像去一个玩具工厂申请制作一个你自己的机器人。
- 点击“创建企业应用”,给你的机器人起个好听的名字,再选一个可爱的头像。
- 在“凭证与基础信息”页面,找到“App ID”和“App Secret”并记下来。App Secret 就像机器人的秘密钥匙,千万不能告诉别人哦!
- 去“权限管理”页面,点击“批量导入”,把说明书里给的一大段文字(就是那个有很多
im:message的代码块)粘贴进去。这就像给你的机器人一张“权限清单”,告诉它可以在飞书里做什么事情。 - 去“应用能力”页面,找到“机器人”并打开它,再给你的机器人起个名字。
- 去“事件订阅”页面,选择“使用长连接接收事件”,然后添加一个叫
im.message.receive_v1的事件。注意啦:在做这一步之前,你需要先确保后面的“第二步”已经开始了,也就是AI助手那边的“网关”已经跑起来了。 - 最后,去“版本管理与发布”页面,创建一个新版本并提交发布。这样你的机器人就做好啦!
第二步:告诉你的AI助手关于机器人的事
现在要把飞书机器人的“小钥匙”交给AI助手。最推荐的方法是,在终端里输入这个命令,然后跟着屏幕上的提示做:
openclaw channels add
选择“Feishu”,然后把刚才记下的“App ID”和“App Secret”粘贴进去。
第三步:启动并测试
- 在终端里输入
openclaw gateway来启动AI助手的“网关”。网关就像一座桥,连接着AI助手和飞书。 - 去飞书里找到你刚创建的机器人,给它发一条“你好!”。
- 第一次聊天时,机器人会回复一个“配对码”。你需要回到终端,输入命令来批准它:
openclaw pairing approve feishu <配对码>。批准之后,你们就可以正常聊天啦!
一些重要的提醒和规则
- 谁可以和机器人聊天? 在私聊里,默认需要“配对”批准。在群聊里,默认需要@提到机器人才会回复。这些规则你都可以自己修改。
- 怎么知道群或人的ID? 最简单的方法是:在群里@一下机器人,或者在私聊里发句话,然后去看终端的日志(输入
openclaw logs --follow),日志里会显示像oc_xxx(群ID)或ou_xxx(用户ID)这样的信息。 - 如果机器人不回复怎么办? 先检查机器人有没有被加到群里;再检查你有没有@它;然后看看“网关”是不是在运行(
openclaw gateway status);最后看看日志里有没有错误信息(openclaw logs --follow)。 - 秘密钥匙泄露了怎么办? 要立刻去飞书开放平台重置“App Secret”,然后更新AI助手那边的配置,最后重启网关。
你还可以做更多高级设置,比如让不同的飞书群聊由不同的AI小助手来服务,或者让回复像流水一样一段段显示出来。这些都在说明书的后面部分有详细讲解。