飞书开放平台 · 智能体（机器人）应用
简易操作手册

浏览器打开官网：https://open.feishu.cn

点右上角登录，用你企业飞书账号扫码登录。

登录成功进入【开发者后台】，右上角确认选中你要部署的企业名称，不要选错。

开发者后台首页，点击【创建应用】→【创建企业自建应用】。

填写基础信息：

应用名称：机器人对外显示的名字（飞书搜索机器人就是这个名字）

应用描述：简单填写用途，例如「AI智能机器人，内部智能问答服务」

应用图标：可选，不上传使用系统默认图标

点击【创建】，进入该应用的后台配置页。

左侧菜单找到【应用能力】→【添加应用能力】。

在列表找到「机器人」，点击【添加】，开启机器人能力。

进入机器人配置页：消息接收模式，对接 OpenClaw 选 WebSocket 长连接。

勾选接收消息类型：文本消息；需要处理图片/文件就额外勾选图片、文件消息。

左侧菜单打开【权限管理】。

两种开通方式：

必选权限：

im:message — 发送接收单聊、群聊消息（必选）

im:message.p2pmsg — 接收单聊消息

im:message.group_at_msg — 接收群内 @ 消息

权限申请：

测试企业内调试：权限免审核，开通立刻生效。

正式给全企业使用：需要创建版本、提交发布，等待企业管理员审批通过。

事件与回调：WebSocket 长连接不需要填回调地址；若是 HTTP 推送模式，才需要填后端回调地址。

把前面复制好的 App ID、App Secret 填入 OpenClaw 后台对应位置，完成飞书与 OpenClaw 对接。

回到机器人配置页，可修改：机器人头像、简介、欢迎语、是否允许单聊、是否允许群聊 @ 触发。

触发模式设置：

需要 @ 才回复：保持默认设置

需要无需 @ 直接回复（对应 4–7 号机器人）：在机器人高级设置开启「无需 @ 触发」

回到飞书客户端，搜索你的机器人应用名称发起单聊；或拉群把机器人加进去。

发送消息，看机器人是否正常响应。

改机器人名字/头像：【凭证与基础信息】修改综合信息，保存，重新发布版本生效。

新增权限：权限管理勾选新权限，创建版本提交发布。

改欢迎语、触发规则：进入【机器人】应用能力页面修改。

关闭某项能力：在应用能力页面移除对应能力。