OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Feishu

这页说明书在教你,怎么让你的AI助手和飞书聊天机器人做好朋友。飞书就像一个公司里大家用来聊天和一起工作的大玩具。你需要先安装一个叫“飞书插件”的小工具,然后去飞书那里创建一个机器人,再把机器人的“小钥匙”告诉你的AI助手。这样,AI助手就能在飞书里和你聊天啦!如果你想让AI助手在飞书里工作,就看这一页。

五岁小孩版解释

首先,我们要给AI助手安装一个叫“飞书插件”的小工具。这就像给你的玩具车装上一个新轮子,它才能跑起来。打开电脑上的“终端”(一个可以输入命令的黑色窗口),输入下面这行命令,然后按回车键: openclaw plugins install @openclaw/feishu 安装好之后,我们就可以开始设置飞书机器人了。有两种简单的方法可以开始,一种是让一个叫“向导”的帮手带你一步步做,另一种是自己用命令来设置。

第一步:在飞书里创建你的机器人

  1. 打开一个叫“飞书开放平台”的网站,用你的飞书账号登录。这就像去一个玩具工厂申请制作一个你自己的机器人。
  2. 点击“创建企业应用”,给你的机器人起个好听的名字,再选一个可爱的头像。
  3. 在“凭证与基础信息”页面,找到“App ID”和“App Secret”并记下来。App Secret 就像机器人的秘密钥匙,千万不能告诉别人哦!
  4. 去“权限管理”页面,点击“批量导入”,把说明书里给的一大段文字(就是那个有很多 im:message 的代码块)粘贴进去。这就像给你的机器人一张“权限清单”,告诉它可以在飞书里做什么事情。
  5. 去“应用能力”页面,找到“机器人”并打开它,再给你的机器人起个名字。
  6. 去“事件订阅”页面,选择“使用长连接接收事件”,然后添加一个叫 im.message.receive_v1 的事件。注意啦:在做这一步之前,你需要先确保后面的“第二步”已经开始了,也就是AI助手那边的“网关”已经跑起来了。
  7. 最后,去“版本管理与发布”页面,创建一个新版本并提交发布。这样你的机器人就做好啦!

第二步:告诉你的AI助手关于机器人的事 现在要把飞书机器人的“小钥匙”交给AI助手。最推荐的方法是,在终端里输入这个命令,然后跟着屏幕上的提示做: openclaw channels add 选择“Feishu”,然后把刚才记下的“App ID”和“App Secret”粘贴进去。

第三步:启动并测试

  1. 在终端里输入 openclaw gateway 来启动AI助手的“网关”。网关就像一座桥,连接着AI助手和飞书。
  2. 去飞书里找到你刚创建的机器人,给它发一条“你好!”。
  3. 第一次聊天时,机器人会回复一个“配对码”。你需要回到终端,输入命令来批准它:openclaw pairing approve feishu <配对码>。批准之后,你们就可以正常聊天啦!

一些重要的提醒和规则

  • 谁可以和机器人聊天? 在私聊里,默认需要“配对”批准。在群聊里,默认需要@提到机器人才会回复。这些规则你都可以自己修改。
  • 怎么知道群或人的ID? 最简单的方法是:在群里@一下机器人,或者在私聊里发句话,然后去看终端的日志(输入 openclaw logs --follow),日志里会显示像 oc_xxx(群ID)或 ou_xxx(用户ID)这样的信息。
  • 如果机器人不回复怎么办? 先检查机器人有没有被加到群里;再检查你有没有@它;然后看看“网关”是不是在运行(openclaw gateway status);最后看看日志里有没有错误信息(openclaw logs --follow)。
  • 秘密钥匙泄露了怎么办? 要立刻去飞书开放平台重置“App Secret”,然后更新AI助手那边的配置,最后重启网关。

你还可以做更多高级设置,比如让不同的飞书群聊由不同的AI小助手来服务,或者让回复像流水一样一段段显示出来。这些都在说明书的后面部分有详细讲解。