为 OpenClaw 安装并配置飞书插件，可以让你在飞书中直接指挥 AI 助手。下面是一个清晰的步骤指南，其中包含了关键注意事项，可以帮助你避免常见问题。
🔧 安装飞书插件
首先，你需要在终端中执行以下命令来安装飞书插件。无论你的操作系统是 Windows、macOS 还是 Linux，这个命令都是通用的。
bash
openclaw plugins install @m1heng-clawd/feishu安装完成后，系统会提示你需要重启网关服务才能使插件生效。请务必运行以下命令：
bash
openclaw gateway restart📝 在飞书开放平台创建应用
安装好插件后，你需要创建一个飞书应用来作为机器人的载体。
- 访问平台 ：在浏览器中打开 飞书开放平台 (
open.feishu.cn)，并登录你的账号。 - 创建应用：在开发者后台，点击"创建企业自建应用"，为你的机器人起一个名字（例如"AI助手"）。
- 获取凭证 ：创建成功后，进入应用的"凭证与基础信息"页面，这里可以找到至关重要的 App ID 和 App Secret，请妥善保存，下一步会用到。
- 添加机器人能力 ：在应用管理的"应用能力"页面，找到并为应用添加"机器人"能力。这是后续配置权限的基础。
⚙️ 配置应用权限与事件
1. 配置 OpenClaw 飞书通道
拿到 App ID 和 App Secret 后，你需要将它们配置到 OpenClaw 中。推荐使用以下命令直接设置：
bash
# 将 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中配置凭证并重启服务 → 最后在飞书后台配置事件订阅。这可以避免因服务未启动导致的飞书连接失败。
- 权限检查：如果机器人能发送消息但无法回复，请首先检查飞书后台的权限和事件订阅是否已正确配置并发布。
- 使用Web UI ：除了在飞书使用，你还可以通过OpenClaw的Web控制界面（通常位于
http://127.0.0.1:18789）与AI助手交互或进行复杂设置。
配好后，通过飞书的机器人与本地claw交互：
