OpenClaw 接入QQ-Bot + 接入Feishu(飞书)

OpenClaw 接入QQ-Bot + 接入Feishu(飞书)

  • 前置
  • 一、接入QQ-Bot
  • 二、接入飞书
    • [2.1 创建机器人](#2.1 创建机器人)
    • [2.2 添加 Feishu (飞书) 通道](#2.2 添加 Feishu (飞书) 通道)
    • [2.3 添加事件与回调](#2.3 添加事件与回调)

OpenClaw(大龙虾) 系列教程
安装教程


接入QQ-Bot + Feishu(飞书)


切换其他大模型


目录详解


常见报错与解决方案

前置

你的服务器已经安装部署了 OpenClaw ,并正常运行。

一、接入QQ-Bot

  1. 打开QQ 开放平台,点击进入QQ 开放平台 ,使用QQ 扫码登录。

  2. 登录之后进入到这个界面,点击右上角的 创建机器人, 此时你的QQ上会自动创建一个openclaw 机器人。

  3. 接下来进入这个界面,保存好你的 AppID 和 AppSecret 。按照官方提供步骤,依次在服务器终端执行即可成功接入。

  4. 执行完指令之后就可以正常使用手机端QQ来使用 openclaw 了。

    bash 复制代码
    # 1. 安装插件
    openclaw plugins install @tencent-connect/openclaw-qqbot@latest
    
    # 2. 配置绑定当前QQ机器人
    openclaw channels add --channel qqbot --token "<你的APPID>:<你的APPSecret>"
    
    # 3. 重启本地OpenClaw服务
    openclaw gateway restart

二、接入飞书

2.1 创建机器人

  1. 打开飞书开放平台,点击进入飞书开放平台 , 没有账号的要先注册登录。点击 创建企业自建应用 。

  2. 填写应用信息,并点击创建。

  3. 创建完成后,进入到这里,点击 添加应用能力,点击 添加机器人 。

  4. 接下来,点击 权限管理,点击 批量导入,从官方文档复制 json 文件粘贴至此处,点击下一步,点击申请开通。如果你的飞书有工作信息等重要隐私数据,还请仔细查看需要开通/关闭的权限,避免隐私泄露。由于我是第一次使用飞书,所以我就根据官方文档,全部都开通了。 点击进入openclaw 官方文档------ Feishu(飞书),查看最新版json 文件

    后续如果你不需要某些权限或者需要开通其他权限,可以在此页面选择关闭或开通相关权限。


  5. 权限开通后,点击最上方的 创建版本 / 左侧导航栏 版本管理与发布 ,发布你的第一个版本。 注意:如果不发布版本,你修改的配置将不会生效!!!

  6. 点击左侧导航栏,查看 APP ID 和 APP 密钥

2.2 添加 Feishu (飞书) 通道

  1. 添加聊天通道,在服务器终端执行以下指令:

    bash 复制代码
    openclaw channels add
  2. 选择 Yes , 选择 Feishu/Lark (飞书) 。

  3. 安装飞书插件。新版本好像都自带了 Feishu 插件。如果本地没有,你就选择第一个,使用 npm 下载。

  4. 选择第一个,输入 APP 密钥(注意:不要输入成 APP ID 了)。生产环境中,选择第二个,以环境变量/其他方式配置密钥。

  5. 输入 APP 密钥 和 APP ID。连接模式选择 WebSocket 长连接模式。

  6. 选择你要访问哪个飞书的域名? 选择第一个。如果你是海外用户,选择第二个。

  7. 选择群聊策略。我们是个人自己使用,配置的是仅私聊,只能自己访问。(根据需要自行选择)

    控制 OpenClaw 飞书机器人在群聊中的访问权限,即群聊策略:

    • Allowlist : 配置白名单。仅白名单内的群 / 用户可触发机器人,适合(企业 / 团队、仅内部群使用)
    • Open : 公开群聊,安全系数最低。所有群里的成员 @机器人即可触发,适合(公开群、测试、个人自用)
    • Disabled : 禁用群聊。完全禁用所有群消息,只响应对话,适合(仅用私聊、不想在群里被打扰)
  8. 再一次出现选择通道,选择 Finished , 配置完成。

  9. 配置私聊(Direct Message)访问策略,选择: No 。

    就是谁能单独私聊你的飞书机器人?默认选项: pairing , 只有 已经配对(绑定) 的用户才能私聊机器人。Yes:现在就详细配置私聊权限(白名单、开放、禁止等),

    No:直接使用默认的 pairing 模式,不用现在配置。

  10. 要不要给飞书账号加一个显示名称(这是个可选参数,为了方便你自己区分多账号)? 选择: No

  11. 把你刚配好的飞书账号绑定到智能体(Agent)? 选择: Yes

  12. 把你刚配置的飞书账号,路由到默认智能体 main。回车,配置完成。

  13. 在终端执行以下指令,重启 openclaw 网关:

    bash 复制代码
    openclaw gateway restart

2.3 添加事件与回调

  1. 下一步,回到飞书开放平台,点击 事件与回调 ,选择订阅方式为: 长连接 (即之前配置的 WebSocket),点击保存。

  2. 点击右下角 添加事件 ,搜索并添加 接受消息 。

  3. 发布新版本。 注意:如果不发布版本,你修改的配置将不会生效!!!

  4. 打开飞书 app, 找到开发者助手,点击打开应用。或者在搜索框搜索你的机器人名称,打开聊天对话框。

  5. 随便和他一句对话,他会回复你一段配对码。复制最下面一行代码,直接粘贴至你的服务器终端执行。然会你就可以正常与他对话了。

    bash 复制代码
    openclaw pairing approve feishu <你的配对码>
  6. 加油,少年,更多有趣的功能等待你探索~


End

你好,少年,未来可期~

相关推荐
Ruiery9 小时前
Linux 6.6内核 CPU 启动深度解析(二):AP 拉起 — BSP 如何用 INIT-SIPI 唤醒其余 CPU
linux·运维·服务器
Lsetea9 小时前
OpenSSL verify报error 62:证书主机名不匹配与-verify_hostname排查
运维·https·ssl证书·openssl·san
rm -rf * && haha.sh9 小时前
【Linux】Rocky 9.8 操作系统磁盘分区与MySQL数据目录迁移
linux·运维·mysql
anew___9 小时前
《从零手写操作系统 (20):ELF加载器——让OS读懂现代编译器》
java·服务器·前端
吴声子夜歌10 小时前
Nginx应用与运维——Nginx Web服务应用实战(Python网站的搭建)
运维·前端·nginx
资深技术分享员10 小时前
Geejing WebBuilder 数据库连接配置与在线 SQL 工具,运维的左右手
运维·数据库·sql·低代码
高山有多高10 小时前
【Linux笔记】UpdSocket
linux·运维·笔记
皓月盈江10 小时前
Linux系统grep、sed 、awk介绍下,使用方法及区别?
linux·运维·服务器·sed·grep·awk
宵时待雨10 小时前
MySQL数据库1:数据库基础
服务器·数据库·mysql
云栖梦泽10 小时前
Linux内存管理
linux·运维·服务器