OpenClaw 安装并配置飞书插件
为 OpenClaw 安装并配置飞书插件
想在飞书里直接指挥你的AI助手吗？只需为OpenClaw安装一个飞书插件就能实现。整个过程其实不复杂，但其中的几个关键步骤和先后顺序确实值得注意。只要按照下面的清晰指南操作，完全可以绕开那些常见的“坑”，顺利配置成功。
???? 安装飞书插件
第一步，我们得把插件本身安装上。这个操作与你的操作系统无关，Windows、macOS还是Linux，命令都是通用的。
openclaw plugins install @m1heng-clawd/feishu看到安装完成的提示后，有一件必做的事：重启网关服务。只有重启，新安装的插件才能真正生效。
openclaw gateway restart???? 在飞书开放平台创建应用
插件就位，接下来需要一个“机器人”实体。这个实体，就是你在飞书开放平台上创建的应用。
- 访问平台：打开浏览器，访问飞书开放平台（
open.feishu.cn）并用你的账号登录。 - 创建应用：进入开发者后台，点击“创建企业自建应用”，给你的机器人起个名字，比如“AI助手”。
- 获取凭证：应用创建成功后，进入“凭证与基础信息”页面。这里你会找到至关重要的 App ID 和 App Secret，请务必妥善保管，下一步马上要用。
- 添加机器人能力：在“应用能力”页面，找到并点击启用“机器人”能力。这是后续所有配置的基石。
⚙️ 配置应用权限与事件
这一步是连接OpenClaw与飞书应用的关键，也是最容易出错的地方。最好能一气呵成地按顺序完成。
1. 配置 OpenClaw 飞书通道
现在，把刚刚拿到的 App ID 和 App Secret 交给 OpenClaw。最推荐的方式是通过命令行直接设置：
# 将 cli_xxxx 和 your_app_secret 替换为你的实际值
openclaw config set channels.feishu.appId "cli_xxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw config set channels.feishu.enabled true配置好后，别忘了再次运行 openclaw gateway restart，重启服务让新的通道配置加载。
2. 在飞书后台配置权限与事件
配置的另一半工作在飞书开放平台。回到你刚创建的应用页面，进行以下操作：
- 开通权限：进入“权限管理”。为了让机器人能正常工作，至少需要搜索并开通这几项核心权限：
contact:user.base:readonly（获取用户信息）im:message（收发消息）im:message.p2p_msg:readonly（接收私聊消息）im:message.group_at_msg:readonly（接收群聊中@机器人的消息）im:message:send_as_bot（以机器人身份发送消息）
- 配置事件订阅（关键步骤）：转战“事件与回调”页面。
- 将订阅方式设置为 “长连接（WebSocket）”。
- 添加事件，至少需要添加
im.message.receive_v1（接收消息事件）。
- 发布应用：最后一步，在“版本管理与发布”中创建一个新版本并发布应用。只有发布后，你才能在飞书客户端里搜索并使用这个机器人。
???? 测试与使用
一切就绪，打开你的飞书客户端（手机App或电脑版），在搜索栏查找你刚刚创建的应用名称（比如“AI助手”）。
找到它，然后就可以像和任何同事聊天一样，直接在对话框里向它发出指令了。例如，试试输入：“帮我列出当前目录下的文件”。
???? 常见问题与技巧
- 确保配置顺序：最稳妥的流程是：安装插件 → 在OpenClaw中配置凭证并重启服务 → 最后在飞书后台配置事件订阅。这个顺序能有效避免因服务未就绪而导致的飞书连接失败。
- 权限检查：如果出现机器人能发送消息却无法回复私聊或@消息的情况，第一个要检查的就是飞书后台的权限列表和事件订阅是否已正确配置并完成发布。
- 备用交互方式：除了飞书，OpenClaw本身也提供了一个Web控制界面（通常访问
http://127.0.0.1:18789），你可以在那里与AI助手进行交互，或者进行一些更复杂的设置。
配好后，通过飞书的机器人与本地claw交互：
