OpenClaw 飞书机器人配置教程｜一键对接飞书，实现聊天下达 AI 指令

Vinnv
0 阅读4分钟

​

 前言

OpenClaw（小龙虾）作为本地 AI 智能体执行框架，支持一键对接飞书机器人，让你在飞书聊天中直接下达 AI 指令，实现智能对话、任务执行、文件处理等功能。本文提供零代码、保姆级配置流程，从飞书开放平台创建应用到 OpenClaw 侧配置，全程清晰可操作，新手也能快速完成对接。

本文严格遵循 CSDN 技术文章规范，无夸大宣传、无违规表述，中间嵌入官方正版链接，结尾再次汇总，方便大家快速获取资源、避开配置坑点。

一、前置准备（1 分钟检查）

  1. 已完成 OpenClaw 本地部署（Windows 10/11 64 位，内存≥4GB）。
  2. 拥有飞书账号（个人 / 企业均可，用于登录飞书开放平台）。
  3. 确保 OpenClaw 服务正常运行，可通过 openclaw status 验证。

官方链接（必存，正版无捆绑）

OpenClaw 官方下载（Windows 一键部署包）

二、飞书开放平台配置（5 分钟完成）

1. 创建企业自建应用

  1. 登录飞书开放平台：open.feishu.cn/。

  2. 点击「创建应用」→ 选择「企业自建应用」。

  3. 填写应用信息：

    • 应用名称：OpenClaw AI 助手（可自定义）
    • 应用描述：OpenClaw 飞书机器人，支持本地 AI 指令执行
    • 应用图标：上传自定义图标（≥240×240px）

  4. 点击「创建」，进入应用管理页面。

2. 添加机器人能力

  1. 左侧菜单 → 「应用能力」→「添加应用能力」。
  2. 选择「机器人」→ 点击「添加」，开启机器人功能。

3. 配置核心权限（关键）

  1. 左侧菜单 → 「权限管理」→「批量导入 / 导出权限」。

  2. 选择「应用身份权限」，粘贴以下 JSON 代码：

    json

    {
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:send_as_bot",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:chat"
    ],
    "user": []
  }
}

  3. 点击「格式化 JSON」→「下一步，确认新增权限」→「申请开通」（个人账号立即生效，企业账号需管理员审核）。

4. 配置事件订阅（推荐 WebSocket 模式）

  1. 左侧菜单 → 「事件与回调」→「事件订阅」。
  2. 选择「使用长连接接收事件（WebSocket）」。
  3. 点击「添加事件」，搜索并添加 im.message.receive_v1（接收消息事件）。
  4. 点击「保存」，完成事件配置。

5. 获取应用凭证（核心）

  1. 左侧菜单 → 「凭证与基础信息」。
  2. 复制 App ID 和 App Secret，保存备用。

6. 发布应用（必做）

  1. 左侧菜单 → 「版本管理与发布」→「创建版本」。
  2. 填写版本号（如 1.0.0）和更新说明 → 点击「提交发布」。
  3. 等待审核（个人账号通常自动通过），发布成功后应用生效。

三、OpenClaw 侧飞书配置（3 分钟完成）

1. 安装飞书插件

打开 OpenClaw 终端，执行命令安装飞书插件：

bash

运行

openclaw plugins install feishu-openclaw

2. 交互式配置飞书通道（推荐）

  1. 执行命令添加飞书通道：

    bash

    运行

    openclaw channels add

  2. 按提示操作：

    • configure chat channels now? → 输入 y 确认。
    • select a channel → 选择 feishu 并回车。
    • enter feishu appid → 粘贴飞书 App ID。
    • enter feishu appsecret → 粘贴飞书 App Secret。
    • which feishu domain? → 选择 china（国内默认）。
    • group chat policy → 选择 open（允许所有群聊）。
    • direct message policy → 选择 open（允许所有人私聊）。

  3. 配置完成后，终端提示「飞书通道配置成功」。

3. 手动配置（进阶）

若需手动编辑配置文件，打开 ~/.openclaw/config.json，添加飞书配置：

json

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "你的App ID",
      "appSecret": "你的App Secret",
      "connectionMode": "websocket",
      "domain": "china",
      "groupChatPolicy": "open",
      "directMessagePolicy": "open"
    }
  }
}

保存后重启 OpenClaw 服务：openclaw restart。

四、配对与使用（1 分钟激活）

1. 飞书内配对

  1. 打开飞书客户端，搜索已发布的机器人应用（如 OpenClaw AI 助手）。
  2. 发送测试消息（如「你好」），机器人会回复配对命令。
  3. 复制配对命令，在 OpenClaw 终端执行，提示「配对成功」即完成。

2. 飞书内使用 AI

  • 私聊：直接与机器人对话，下达 AI 指令（如「整理桌面文件」「生成代码」）。
  • 群聊：将机器人添加到群聊，@机器人即可发起交互（如「@OpenClaw AI 助手 总结群聊内容」）。

五、常见问题排查

  1. 机器人无响应：检查飞书应用是否发布、权限是否开通、OpenClaw 服务是否正常。
  2. 配对失败：核对 App ID 和 App Secret，确保飞书应用已发布。
  3. 群聊 @无反应：检查群聊权限配置，确保 groupChatPolicy 为 open。
  4. WebSocket 连接失败：重启 OpenClaw 服务，重新配置飞书通道。

总结

本文提供 OpenClaw 飞书机器人完整配置教程，从飞书开放平台创建应用到 OpenClaw 侧配置，全程零代码、保姆级，新手也能快速完成对接，实现飞书内直接调用本地 AI 功能。

务必通过官方链接下载正版 OpenClaw，避免盗版风险；配置时核对飞书凭证与权限，即可零踩坑完成对接。

官方链接汇总（再次提供）

OpenClaw 官方下载（Windows 一键部署包）

​

avatar
文章
阅读
粉丝