通过配置聊天软件与OpenClaw进行交互,本文将为您介绍打造飞书个人助理的最佳实践。
注意
OpenClaw 作为开源项目,建议在使用前全面评估其安全性与稳定性,并且严格按照对应的开源许可协议规范使用,确保系统和数据安全。
前置依赖
完成OpenClaw(原Clawdbot/Moltbot)服务器的部署。
完成大模型配置。
说明
以上流程,可参考使用云主机一键部署OpenClaw。
步骤1:飞书机器人创建(个人用户可使用)
进入飞书应用中心 ,选择创建企业自建应用。
填写信息,点击创建
选择机器人应用,点击添加机器人。
为应用添加权限。点击权限管理-开通权限,在输入框中输入目标权限,必需权限和可选权限配置见下表。
必需权限 范围 说明 contact:user.base:readonly 用户信息 获取用户基本信息 contact:contact.base:readonly 通讯录 获取通讯录基本信息 im:message 消息 发送和接收消息 im:message.p2p_msg:readonly 私聊 读取发给机器人的私聊消息 im:message.group_at_msg:readonly 群聊 接收群内 @机器人 的消息 im:message:send_as_bot 发送 以机器人身份发送消息 im:resource 媒体 上传和下载图片/文件 可选权限 范围 说明 im:message.group_msg 群聊 读取所有群消息(敏感) im:message:readonly 读取 获取历史消息 im:message:update 编辑 更新/编辑已发送消息 im:message:recall 撤回 撤回已发送消息 im:message.reactions:read 表情 查看消息表情回复 权限添加完后状态如下:
获取并保存飞书的APP ID 和 APP Secret 用于“步骤3-在云主机上配置飞书插件”,获取入口如下:
步骤2:在云主机上配置飞书插件信息
登录目标云主机。登录天翼云官网,进入计算控制台,点击远程登录按钮。
本文以Linux系统操作为例,在管理终端页面中,输入用户名(默认为root)及密码,登录云主机。
在云主机管理终端页面中执行下方3条命令,完成飞书的相关信息配置:
openclaw config set channels.feishu.appId "[飞书的App ID]"openclaw config set channels.feishu.appSecret "[飞书的App Secret]"openclaw config set channels.feishu.enabled true注意
若您选择安装的镜像名称中的版本信息为v2026.3.13或以上版本的,需额外进行配置 pairing 认证或执行以下命令关闭 pairing 模式:
openclaw config set channels.feishu.dmPolicy open重启 OpenClaw。在云主机中执行以下命令:
openclaw gateway restart
步骤3:添加事件订阅
选择订阅方式为长连接
添加事件,具体添加项见下表:
事件 说明 im.message.receive_v1 接收消息(必需) im.message.message_read_v1 消息已读回执 im.chat.member.bot.added_v1 机器人进群 im.chat.member.bot.deleted_v1 机器人被移出群 配置完成后,进行发版
注意
事件订阅必须在OpenClaw添加飞书配置并启动后,才可以创建,否则无法创建成功。
飞书机器人已创建成功,在飞书搜索栏中搜索机器人应用名称。
例如本文“步骤1”命名的“私人AI助手”,点击应用即可开启对话。
现在可以在飞书中和机器人对话,开启全新AI助手体验。