大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



状态：生产就绪，支持机器人私聊和群组。使用 WebSocket 长连接模式接收消息。

当前版本的 OpenClaw 已内置 Feishu 插件，因此通常不需要单独安装。 如果你使用的是较旧版本，或是没有内置 Feishu 的自定义安装，可手动安装：

openclaw plugins install @openclaw/feishu

添加飞书渠道有两种方式：

如果您刚安装完 OpenClaw，可以直接运行向导，根据提示添加飞书：

向导会引导您完成：

✅完成配置后，您可以使用以下命令检查网关状态：

如果您已经完成了初始安装，可以用以下命令添加飞书渠道：

然后根据交互式提示选择 Feishu，输入 App ID 和 App Secret 即可。 ✅完成配置后，您可以使用以下命令管理网关：

访问飞书开放平台，使用飞书账号登录。 Lark（国际版）请使用https://open.larksuite.com/app，并在配置中设置。

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

❗重要：请妥善保管 App Secret，不要分享给他人。

在权限管理页面，点击批量导入按钮，粘贴以下 JSON 配置一键导入所需权限：

 }

在应用能力机器人页面：

⚠️重要提醒：在配置事件订阅前，请务必确保已完成以下步骤：

在事件订阅页面：

⚠️注意：如果网关未启动或渠道未添加，长连接设置将保存失败。

运行以下命令，根据提示粘贴 App ID 和 App Secret：

选择Feishu，然后输入您在第一步获取的凭证即可。

编辑：

{ channels: { feishu: { enabled: true, dmPolicy: “pairing”, accounts: { main: { appId: “cli_xxx”, appSecret: “xxx”, botName: “我的AI助手”, }, }, }, }, }

若使用，需设置。飞书 Webhook 服务默认绑定；仅在需要不同监听地址时设置。

获取 Verification Token（仅 Webhook 模式）

使用 Webhook 模式时，需在配置中设置。获取方式：

export FEISHUAPPID=“clixxx” export FEISHUAPP_SECRET=“xxx”

如果您的租户在 Lark（国际版），请设置域名为（或完整域名），可配置或：

{ channels: { feishu: { domain: “lark”, accounts: { main: { appId: “cli_xxx”, appSecret: “xxx”, }, }, }, }, }

可通过以下可选配置减少飞书 API 调用：

可在渠道级或账号级配置：

{ channels: { feishu: { typingIndicator: false, resolveSenderNames: false, accounts: { main: { appId: “cli_xxx”, appSecret: “xxx”, typingIndicator: true, resolveSenderNames: false, }, }, }, }, }

在飞书中找到您创建的机器人，发送一条消息。

默认情况下，机器人会回复一个配对码。您需要批准此代码：

openclaw pairing approve feishu  
 
   
   <配对码< pre=""> 
  
    
    
批准后即可正常对话。
 
  
    
    
群组策略（）：
 
  
    
    
@提及要求（）：
 
  
    
    
{ channels: { feishu: { groupPolicy: “open”, // 默认 requireMention: true }, }, }
 
  
    
    
需要为特定群组配置：
 
  
    
    
{ channels: { feishu: { groups: { oc_xxx: { requireMention: false }, }, }, }, }
 
  
    
    
{ channels: { feishu: { groupPolicy: “allowlist”, // 群组 ID 格式为 ocxxx groupAllowFrom: [“ocxxx”, “oc_yyy”], }, }, }
 
  
    
    
除群组白名单外，该群组内所有消息均按发送者 open_id 校验：仅中列出的用户消息会被处理，其他成员的消息会被忽略（此为发送者级白名单，不仅针对 /reset、/new 等控制命令）。
 
  
    
    
{ channels: { feishu: { groupPolicy: “allowlist”, groupAllowFrom: [“ocxxx”], groups: { ocxxx: { // 用户 openid 格式为 ouxxx allowFrom: [“ouuser1”, “ouuser2”], }, }, }, }, }
 
  
    
    
群组 ID 格式为，可以通过以下方式获取：方法一（推荐）：
 
  
    
    
方法二： 使用飞书 API 调试工具获取机器人所在群组列表。
 
  
    
    
用户 ID 格式为，可以通过以下方式获取：
 
  
    
    
方法一（推荐）：
 
  
    
    
方法二： 查看配对请求列表，其中包含用户的 Open ID：
 
  
    
    
openclaw pairing list feishu
 
  
    
    
命令
 
  
    
    
说明
 
  
    
    
 
  
    
    
查看机器人状态
 
  
    
    
 
  
    
    
重置对话会话
 
  
    
    
 
  
    
    
查看/切换模型
 
  
    
    
 
     
注意：飞书目前不支持原生命令菜单，命令需要以文本形式发送。
 
    
 
  
    
    
在配置和使用飞书渠道时，您可能需要使用以下网关管理命令：
 
  
    
    
 
  
    
    
如果需要管理多个飞书机器人，可配置指定出站未显式指定时使用的账号：
 
  
    
    
{ channels: { feishu: { defaultAccount: “main”, accounts: { main: { appId: “clixxx”, appSecret: “xxx”, botName: “主机器人”, }, backup: { appId: “cliyyy”, appSecret: “yyy”, botName: “备用机器人”, enabled: false, // 暂时禁用 }, }, }, }, }
 
  
    
    
飞书支持通过交互式卡片实现流式输出，机器人会实时更新卡片内容显示生成进度。默认配置：
 
  
    
    
{ channels: { feishu: { streaming: true, // 启用流式卡片输出（默认 true） blockStreaming: true, // 启用块级流式（默认 true） }, }, }
 
  
    
    
如需禁用流式输出（等待完整回复后一次性发送），可设置。
 
  
    
    
在群聊中，机器人的回复可以引用用户发送的原始消息，让对话上下文更加清晰。 配置选项：
 
  
    
    
{ channels: { feishu: { // 账户级别配置（默认 “all”） replyToMode: “all”, groups: { oc_xxx: { // 特定群组可以覆盖 replyToMode: “first”, }, }, }, }, }
 
  
    
    
值说明：
 
  
    
    
值
 
  
    
    
行为
 
  
    
    
 
  
    
    
不引用原消息（私聊默认值）
 
  
    
    
 
  
    
    
仅在第一条回复时引用原消息
 
  
    
    
 
  
    
    
所有回复都引用原消息（群聊默认值）
 
  
    
    
 
     
注意：消息引用功能与流式卡片输出（）不能同时使用。当启用流式输出时，回复会以卡片形式呈现，不会显示引用。
 
    
 
  
    
    
通过配置，您可以用一个飞书机器人对接多个不同功能或性格的 Agent。系统会根据用户 ID 或群组 ID 自动将对话分发到对应的 Agent。 配置示例：
 
  
    
    
{ agents: { list: [ { id: “main” }, { id: “clawd-fan”, workspace: ”/home/user/clawd-fan”, agentDir: ”/home/user/.openclaw/agents/clawd-fan/agent”, }, { id: “clawd-xi”, workspace: ”/home/user/clawd-xi”, agentDir: ”/home/user/.openclaw/agents/clawd-xi/agent”, }, ], }, bindings: [ { // 用户 A 的私聊 → main agent agentId: “main”, match: { channel: “feishu”, peer: { kind: “dm”, id: “ou28b31a88…” }, }, }, { // 用户 B 的私聊 → clawd-fan agent agentId: “clawd-fan”, match: { channel: “feishu”, peer: { kind: “dm”, id: “ou0fe6b1c9…” }, }, }, { // 某个群组 → clawd-xi agent agentId: “clawd-xi”, match: { channel: “feishu”, peer: { kind: “group”, id: “oc_xxx…” }, }, }, ], }
 
  
    
    
匹配规则说明：
 
  
    
    
 
  
    
    
完整配置请参考：网关配置主要选项：
 
  
    
    
 
  
    
    
值
 
  
    
    
行为
 
  
    
    
 
  
    
    
默认。未知用户收到配对码，管理员批准后才能对话
 
  
    
    
 
  
    
    
仅列表中的用户可对话，其他静默忽略
 
  
    
    
 
  
    
    
允许所有人对话（需在 allowFrom 中加）
 
  
    
    
 
  
    
    
完全禁止私聊