想在飞书里拥有一个能听懂指令、自动响应的专属机器人吗?本文将手把手带你完成机器人在飞书开放平台的创建和配置,并介绍如何通过一个简单的“配对码”将它连接到强大的 OpenClaw 框架上。全程只需 10 分钟,Let’s go!
第一步:在飞书后台创建你的机器人应用
首先,我们需要为机器人“注册户口”,并赋予它必要的“超能力”。
1. 创建应用
登录 飞书开放平台,点击 【创建企业自建应用】 。给你的机器人起一个心仪的名字,比如 “我的龙虾助手”。
2. 获取身份凭证:App ID 与 App Secret
进入应用的 【凭证与基础信息】 页面,找到 App ID 和 App Secret。请将它们复制并妥善保存(建议存入记事本)。这是后续 OpenClaw 识别和操控你机器人的唯一凭证,务必保密。
3. 添加机器人能力
在左侧菜单栏选择 【添加应用能力】 ,点击并开启 【机器人】 能力。这一步让你的应用拥有了“嘴巴和耳朵”,可以收发消息。
4. 批量开通权限
为了让机器人在飞书群里自由活动,需要授予一系列权限。
进入 【权限管理】 页面。
点击 【批量导入】 按钮。
将下方 JSON 代码粘贴进去,然后点击 【批量申请开通】 。这些代码涵盖了机器人读取消息、发送消息、在群聊中被@等核心权限。
{
"scopes": {
"tenant": [
"contact:user.base:readonly",
"contact:user.employee_id:readonly",
"contact:user.id:readonly",
"contact:contact.base:readonly",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:read",
"im:chat.moderation:read",
"im:chat.tabs:read",
"im:chat.tabs:write_only",
"im:chat.top_notice:write_only",
"im:chat:moderation:write_only",
"im:chat:operate_as_owner",
"im:chat:read",
"im:chat:readonly",
"im:chat:update",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message.urgent",
"im:message.urgent.status:write",
"im:message:readonly",
"im:message:send_as_bot",
"im:message:send_multi_depts",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"im:url_preview.update",
"im:user_agent:read",
"passport:session_mask:readonly"
],
"user": []
}
}
5. 配置事件订阅:告诉飞书消息该往哪里推
这一步是连接飞书与 OpenClaw 的桥梁。
进入 【事件与回调】 页面。
在 【订阅方式】 处选择 “长连接(WebSocket)” 模式。
小提示:此时直接点击保存可能会报错,这是正常的,因为我们还没启动 OpenClaw 服务。
接着点击 【添加事件】 ,搜索并添加 im.message.receive_v1(接收消息)事件。这个事件相当于机器人的“耳朵”,一旦有人发消息,飞书就会把内容转发给 OpenClaw 处理。
6. 发布应用
所有配置完成后,别忘了最后一步:发布应用。
进入 【版本管理与发布】 页面。
创建一个版本(例如版本号 1.0.0),填写更新说明。
点击 【发布】,提交后等待飞书审核(通常很快)。
第二步:连接 OpenClaw——用“配对码”完成握手
现在机器人已经在飞书后台“出生”了,但还需要和 OpenClaw 建立连接才能变得智能。
启动 OpenClaw 服务
根据 OpenClaw 的文档,在本地或服务器上启动服务。确保 OpenClaw 已经正确配置了之前保存的 App ID 和 App Secret。
在飞书中获取配对码
打开飞书客户端,在消息搜索框输入你刚创建的机器人名字(例如“我的龙虾助手”),进入对话界面。发送任意一条消息(比如“你好”),机器人会自动回复你一个 配对码,格式类似于:
Pairing code: ABC123XYZ
这是飞书通过 WebSocket 长连接与 OpenClaw 进行身份验证的临时密码。
将配对码交给 OpenClaw
回到 OpenClaw 的控制台界面(可能是命令行、Web 管理页面或配置文件),根据提示输入你收到的配对码。提交后,OpenClaw 会使用该码与飞书服务器完成最后的握手。
验证连接
连接成功后,你的机器人就会真正“活”起来。此时再向机器人发送消息,它就能按照你在 OpenClaw 中编写的逻辑进行回复了。
大功告成!
现在,你的飞书机器人已经成功接入了 OpenClaw,可以开始为你服务了!你可以随心所欲地为它扩展功能,比如定时提醒、信息查询、任务管理等等。尽情享受 DIY 的乐趣吧!

1847






