openclaw配置飞书

He1955012026-03-12 21:52

OpenClaw 配置飞书（Feishu）完整教程 | 打造企业级 AI 智能助手

摘要：本文详细介绍如何将 OpenClaw AI 智能体网关与飞书（Feishu）集成，实现企业内部的 AI 助手功能。涵盖飞书应用创建、权限配置、OpenClaw 连接和高级功能设置。

一、什么是飞书集成

OpenClaw 支持将 AI 智能体连接到飞书（Feishu/Lark）企业聊天平台，通过机器人形式提供：

  • 💬 智能问答：员工可直接与 AI 对话
  • 📁 文档处理：读写飞书文档、知识库
  • 📂 云盘管理：操作飞书云空间文件
  • 👥 群组协作：在群聊中提供 AI 支持
  • 🔐 权限控制：企业级访问控制

二、系统要求

项目 要求
OpenClaw 最新版本
飞书账号 企业管理员或应用创建权限
Node.js 22.0+
网络 可访问飞书开放平台

⚠️ 注意：飞书集成需要企业管理员权限创建应用，个人账号可能受限。

三、安装 OpenClaw（如未安装）

3.1 Windows 安装

powershell 复制代码 
iwr -useb https://openclaw.ai/install.ps1 | iex

3.2 macOS/Linux 安装

bash 复制代码 
curl -fsSL https://openclaw.ai/install.sh | bash

3.3 验证安装

bash 复制代码 
openclaw --version
openclaw gateway status

四、创建飞书应用

4.1 访问飞书开放平台

登录企业飞书账号。

4.2 创建企业应用

  1. 点击 创建企业应用
  2. 填写应用信息：
    • 应用名称：AI 助手（或自定义）
    • 应用描述：OpenClaw AI 智能助手
    • 应用图标：上传一个图标（可选）

4.3 获取应用凭证

在 凭证与基础信息 页面，复制：

  • App ID （格式：cli_xxxxxxxxxxxx）
  • App Secret（点击复制）

🔐 重要 ：App Secret 是敏感信息，请妥善保管，不要泄露！

五、配置应用权限

5.1 批量导入权限

在 权限管理 页面，点击 批量导入，粘贴以下 JSON：

json 复制代码 
{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

5.2 启用机器人能力

  1. 进入 应用能力 → 机器人
  2. 开启机器人能力
  3. 设置机器人名称（如：AI 助手）
  4. 下图是启用之后的截图

5.3 配置事件订阅

⚠️ 重要：在配置事件订阅前，确保：

  1. 已运行 openclaw channels add 添加飞书渠道
  2. Gateway 已启动（openclaw gateway status）

配置步骤：

  1. 进入 事件订阅 页面
  2. 选择 使用长连接接收事件（WebSocket 模式）
  3. 添加事件：im.message.receive_v1
  4. 如何配置长连接事件这边使用的node.js方法

复制node代码到本地新建一个index.js

js 复制代码 
import * as Lark from '@larksuiteoapi/node-sdk';
const baseConfig = {
  appId: '上图中的api-key',
  appSecret: '上图中的pai-secret'
}
const client = new Lark.Client(baseConfig);
const wsClient = new Lark.WSClient({...baseConfig, loggerLevel: Lark.LoggerLevel.debug});
wsClient.start({
  // 处理「接收消息」事件，事件类型为 im.message.receive_v1
  eventDispatcher: new Lark.EventDispatcher({}).register({
    'im.message.receive_v1': async (data) => {
      const {
        message: { chat_id, content}
      } = data;
      // 示例操作：接收消息后，调用「发送消息」API 进行消息回复。
      await client.im.v1.message.create({
        params: {
          receive_id_type: "chat_id"
        },
        data: {
          receive_id: chat_id,
          content: Lark.messageCard.defaultCard({
            title: `回复： ${JSON.parse(content).text}`,
            content: '新年好'
          }),
          msg_type: 'interactive'
        }
      });
    }
  })
});
  1. 之后在命令框运行

npm install @larksuiteoapi/node-sdk

  1. 最后运行

npm index.js

  1. 运行之后就可以在飞书开放平台进行验证长连接了

5.4 发布应用

  1. 进入 版本管理与发布

  2. 创建新版本

  3. 提交审核并发布

  4. 等待管理员审批（企业应用通常自动通过）

六、配置 OpenClaw

6.1 使用向导配置（推荐）

bash 复制代码 
openclaw channels add

选择 Feishu，然后输入：

  • App ID
  • App Secret

向导会自动完成配置。

6.2 手动配置文件

编辑 ~/.openclaw/openclaw.json：

json5 复制代码 
{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "domain": "feishu",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxx",
          "appSecret": "your_app_secret_here",
          "botName": "AI 助手"
        }
      }
    }
  }
}

6.3 国际版（Lark）配置

如果使用飞书国际版：

json5 复制代码 
{
  "channels": {
    "feishu": {
      "domain": "lark",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxx",
          "appSecret": "your_app_secret_here"
        }
      }
    }
  }
}

七、启动并测试

7.1 启动 Gateway

bash 复制代码 
openclaw gateway

或检查服务状态：

bash 复制代码 
openclaw gateway status

7.2 在飞书中添加机器人

  1. 打开飞书
  2. 搜索你的机器人名称（如 AI 助手）
  3. 发送一条测试消息

7.3 配对授权

首次使用时，机器人会回复一个配对码。在终端执行：

bash 复制代码 
openclaw pairing list feishu
openclaw pairing approve feishu <配对码>

配对成功后即可正常对话。

八、访问控制配置

8.1 私聊控制（dmPolicy）

模式 说明
pairing（默认） 未知用户需配对授权
allowlist 仅允许指定用户
open 允许所有用户
disabled 禁用私聊

白名单模式示例：

json5 复制代码 
{
  "channels": {
    "feishu": {
      "dmPolicy": "allowlist",
      "allowFrom": ["ou_xxxxxx1", "ou_xxxxxx2"]
    }
  }
}

8.2 群聊控制（groupPolicy）

模式 说明
open（默认） 允许所有群聊
allowlist 仅允许指定群聊
disabled 禁用群聊

允许特定群聊：

json5 复制代码 
{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["oc_xxxxxx1", "oc_xxxxxx2"]
    }
  }
}

8.3 群组提及设置

默认需要 @机器人 才响应，可配置为始终响应：

json5 复制代码 
{
  "channels": {
    "feishu": {
      "groups": {
        "oc_xxxxxx": {
          "requireMention": false
        }
      }
    }
  }
}

九、获取用户和群组 ID

9.1 获取用户 Open ID

方法 1：查看日志

  1. 用户发送消息给机器人
  2. 运行 openclaw logs --follow
  3. 查找 open_id（格式：ou_xxxxxxxxxxxx）

方法 2：查看配对请求

bash 复制代码 
openclaw pairing list feishu

9.2 获取群组 Chat ID

方法 1：查看日志

  1. 在群聊中 @机器人
  2. 运行 openclaw logs --follow
  3. 查找 chat_id（格式：oc_xxxxxxxxxxxx）

方法 2：使用飞书 API 调试工具

十、高级功能

10.1 多账号配置

json5 复制代码 
{
  "channels": {
    "feishu": {
      "defaultAccount": "main",
      "accounts": {
        "main": {
          "appId": "cli_xxx1",
          "appSecret": "secret1",
          "botName": "主助手"
        },
        "backup": {
          "appId": "cli_xxx2",
          "appSecret": "secret2",
          "botName": "备用助手",
          "enabled": false
        }
      }
    }
  }
}

10.2 多智能体路由

根据不同用户/群组路由到不同 AI 智能体：

json5 复制代码 
{
  "agents": {
    "list": [
      { "id": "main" },
      { "id": "hr-assistant", "workspace": "~/.openclaw/workspace-hr" },
      { "id": "tech-support", "workspace": "~/.openclaw/workspace-tech" }
    ]
  },
  "bindings": [
    {
      "agentId": "main",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "direct", "id": "ou_xxx" }
      }
    },
    {
      "agentId": "hr-assistant",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "group", "id": "oc_hr_group" }
      }
    },
    {
      "agentId": "tech-support",
      "match": {
        "channel": "feishu",
        "peer": { "kind": "group", "id": "oc_tech_group" }
      }
    }
  ]
}

10.3 流式输出配置

json5 复制代码 
{
  "channels": {
    "feishu": {
      "streaming": true,
      "blockStreaming": true
    }
  }
}
  • streaming: true：启用流式卡片输出
  • blockStreaming: true：启用块级流式更新

10.4 性能优化

json5 复制代码 
{
  "channels": {
    "feishu": {
      "typingIndicator": false,
      "resolveSenderNames": false,
      "textChunkLimit": 2000,
      "mediaMaxMb": 30
    }
  }
}
  • typingIndicator: false：禁用输入中提示（减少 API 调用）
  • resolveSenderNames: false：禁用发送者名称解析

十一、飞书工具集成

OpenClaw 飞书集成支持以下工具：

11.1 文档工具（feishu-doc）

  • 读取/写入飞书文档
  • 创建表格
  • 上传图片/附件
  • 支持 Markdown 格式

示例：

复制代码 
帮我读取这个文档：https://xxx.feishu.cn/docx/ABC123def

11.2 云盘工具（feishu-drive）

  • 列出文件夹内容
  • 创建文件夹
  • 移动/删除文件
  • 获取文件信息

示例：

复制代码 
查看我的云盘根目录
在云盘创建一个新文件夹"项目文档"

11.3 权限工具（feishu-perm）

  • 查看协作者列表
  • 添加/移除协作者
  • 设置权限级别

示例：

复制代码 
给这个文档添加协作者：alice@company.com，编辑权限

⚠️ 注意：权限工具默认禁用，需在配置中显式启用。

11.4 知识库工具（feishu-wiki）

  • 浏览知识库空间
  • 创建/移动/重命名节点
  • 读写知识库页面

示例：

复制代码 
列出所有知识库空间
在"技术文档"空间创建一个新页面

十二、常用命令

bash 复制代码 
# 查看网关状态
openclaw gateway status

# 重启网关
openclaw gateway restart

# 查看日志
openclaw logs --follow

# 查看配对请求
openclaw pairing list feishu

# 批准配对
openclaw pairing approve feishu <CODE>

# 拒绝配对
openclaw pairing reject feishu <CODE>

# 添加飞书渠道
openclaw channels add

# 健康检查
openclaw health

十三、常见问题

Q1: 机器人不回复消息

检查：

  1. 应用是否已发布并审批通过
  2. 事件订阅是否包含 im.message.receive_v1
  3. 长连接是否已启用
  4. 应用权限是否完整
  5. Gateway 是否运行：openclaw gateway status
  6. 查看日志：openclaw logs --follow

Q2: 群聊中机器人不响应

检查：

  1. 机器人是否已添加到群聊
  2. 是否 @机器人（默认需要）
  3. groupPolicy 是否设置为 disabled
  4. 查看日志确认消息是否收到

Q3: 长连接配置失败

解决：

  1. 确保 Gateway 已启动
  2. 先运行 openclaw channels add
  3. 再在飞书后台配置事件订阅
  4. 检查网络是否可访问飞书 API

Q4: App Secret 泄露

紧急处理：

  1. 在飞书开放平台重置 App Secret
  2. 更新 OpenClaw 配置
  3. 重启 Gateway

Q5: 权限不足错误

解决：

  1. 检查应用权限是否完整导入
  2. 确认应用已发布
  3. 查看日志中的具体权限错误
  4. 在飞书后台补充缺失权限

十四、安全建议

  1. 配置白名单：限制可访问的用户和群组
  2. 群组提及 ：设置 requireMention: true 避免干扰
  3. 定期更新 ：npm update -g openclaw
  4. 备份配置 ：定期备份 ~/.openclaw/ 目录
  5. 监控日志 ：定期检查 openclaw logs
  6. 权限最小化：只申请必要的 API 权限

十五、配置文件参考

完整配置示例：

json5 复制代码 
{
  "channels": {
    "feishu": {
      "enabled": true,
      "domain": "feishu",
      "connectionMode": "websocket",
      "defaultAccount": "main",
      "dmPolicy": "pairing",
      "allowFrom": [],
      "groupPolicy": "open",
      "groupAllowFrom": [],
      "groups": {
        "oc_xxxxxx": {
          "requireMention": true,
          "enabled": true,
          "allowFrom": ["ou_user1", "ou_user2"]
        }
      },
      "streaming": true,
      "blockStreaming": true,
      "typingIndicator": true,
      "resolveSenderNames": true,
      "textChunkLimit": 2000,
      "mediaMaxMb": 30,
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxx",
          "appSecret": "your_app_secret",
          "botName": "AI 助手",
          "domain": "feishu"
        }
      }
    }
  }
}

十六、资源链接

总结

OpenClaw 飞书集成提供了强大的企业级 AI 助手能力：

✅ 快速集成 ：15 分钟完成配置

✅ 安全可靠 ：企业级权限控制

✅ 功能丰富 ：文档、云盘、知识库全支持

✅ 灵活配置 ：多账号、多智能体路由

✅ 易于管理：完善的日志和监控

配置完成后，你的企业员工可以通过飞书随时随地与 AI 助手交互，提升工作效率。

相关推荐
xzlAwin13 小时前
Win10 安装OpenClaw 龙虾
ai·openclaw·龙虾
mudtools1 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
人工智能·ai·.net·飞书·agent
极致了2 天前
飞书插件、RPA、API三条路的真实分界线
飞书·rpa
玩泥巴的3 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
ai·.net·飞书·agent
玩泥巴的4 天前
一份声明，多份产物：飞书 SDK 的 AI 工具面是怎么生成的
ai·.net·飞书·agent
OpenPortal认证计费系统6 天前
基于 飞书认证 通过 华为、H3C 结合 OpenPortal认证计费系统 实现 网络准入 飞书授权 实名认证
华为·飞书·h3c·portal认证·openportal
前进的李工7 天前
飞书企业知识库设计+后端高频八股
数据库·redis·后端·mysql·性能优化·飞书·rag
长弓三石7 天前
钉钉与飞书机器人接入企业级智能体过程及排障实录
人工智能·机器人·钉钉·飞书·企业级harness
小七-七牛开发者9 天前
Agent 支线知识：Personal Agent 的前世今生
dots·aiagent·openclaw·muse·personalagent
热门推荐
01如何新建文件夹？ 电脑新建文件夹的4种方法02国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）03GitHub 镜像站点04历年考研数学一、数学二、数学三真题试卷及答案PDF05几个好用的ip纯净度检测网站06昇腾910B系列芯片完全指南：四款型号对比、服务器选型与大模型部署实战07苹果iPA游戏软件资源下载网站08蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接09CVE-2026-91403 高危漏洞预警：Java JSSE 信任链被攻破 全场景修复方案与Linux系统级彻底清理实操10Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）