OpenClaw 安装并配置飞书插件

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

🔧 安装飞书插件

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

bash 复制代码
openclaw plugins install @m1heng-clawd/feishu

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

bash 复制代码
openclaw gateway restart

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

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

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

⚙️ 配置应用权限与事件

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交互:

相关推荐
w3296362717 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
宝哥聊编程18 天前
主流 Agent 平台对比:Coze、Dify、飞书、扣子、OpenClaw 落地实操手册
前端·人工智能·飞书
guoran_shini20 天前
Agent系统服务化封装和IM接入
飞书
mudtools23 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
人工智能·ai·.net·飞书·agent
极致了23 天前
飞书插件、RPA、API三条路的真实分界线
飞书·rpa
玩泥巴的24 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
ai·.net·飞书·agent
玩泥巴的25 天前
一份声明,多份产物:飞书 SDK 的 AI 工具面是怎么生成的
ai·.net·飞书·agent
OpenPortal认证计费系统1 个月前
基于 飞书认证 通过 华为、H3C 结合 OpenPortal认证计费系统 实现 网络准入 飞书授权 实名认证
华为·飞书·h3c·portal认证·openportal
前进的李工1 个月前
飞书企业知识库设计+后端高频八股
数据库·redis·后端·mysql·性能优化·飞书·rag