OpenClaw 安装并配置飞书插件-平芜编程栈

为 OpenClaw 安装并配置飞书插件，可以让你在飞书中直接指挥 AI 助手。下面是一个清晰的步骤指南，其中包含了关键注意事项，可以帮助你避免常见问题。

🔧 安装飞书插件

首先，你需要在终端中执行以下命令来安装飞书插件。无论你的操作系统是 Windows、macOS 还是 Linux，这个命令都是通用的。

openclaw pluginsinstall@m1heng-clawd/feishu

安装完成后，系统会提示你需要重启网关服务才能使插件生效。请务必运行以下命令：

openclaw gateway restart

📝 在飞书开放平台创建应用

安装好插件后，你需要创建一个飞书应用来作为机器人的载体。

访问平台：在浏览器中打开飞书开放平台(open.feishu.cn)，并登录你的账号。
创建应用：在开发者后台，点击“创建企业自建应用”，为你的机器人起一个名字（例如“AI助手”）。
获取凭证：创建成功后，进入应用的“凭证与基础信息”页面，这里可以找到至关重要的App ID和App Secret，请妥善保存，下一步会用到。
添加机器人能力：在应用管理的“应用能力”页面，找到并为应用添加“机器人”能力。这是后续配置权限的基础。

⚙️ 配置应用权限与事件

1. 配置 OpenClaw 飞书通道

拿到 App ID 和 App Secret 后，你需要将它们配置到 OpenClaw 中。推荐使用以下命令直接设置：

# 将 cli_xxxx 和 your_app_secret 替换为你的实际值openclaw configsetchannels.feishu.appId"cli_xxxx"openclaw configsetchannels.feishu.appSecret"your_app_secret"openclaw configsetchannels.feishu.enabledtrue

完成后，再次运行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助手交互或进行复杂设置。