飞书 / Lark 接入

两种方式添加飞书渠道：

# 方式一：安装向导（推荐）
openclaw onboard

# 方式二：命令行添加
openclaw channels add
# 选择 Feishu，输入 App ID 和 App Secret

完成后检查状态：

openclaw gateway status    # 查看网关运行状态
openclaw logs --follow     # 查看实时日志

1. 访问 飞书开放平台（Lark 国际版用 open.larksuite.com），登录后点击"创建企业自建应用"。
2. 在"凭证与基础信息"页面复制 App ID（cli_xxx）和 App Secret。
3. 在"权限管理"页面点击"批量导入"，粘贴所需权限 JSON（包含 im:message、im:chat、im:message:send_as_bot 等）。
4. 在"应用能力"→"机器人"页面开启机器人能力。
5. 在"事件订阅"页面：
   • 选择"使用长连接接收事件"（WebSocket 模式）
   • 添加事件 im.message.receive_v1
6. 在"版本管理与发布"页面创建版本并提交审核。

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

也可通过环境变量配置：

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

启动 Gateway 后，私信机器人会触发配对码流程：

# 查看待审批列表
openclaw pairing list feishu

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

群组策略通过 groupPolicy 控制（默认 open）：

{
  channels: {
    feishu: {
      // 仅允许特定群组
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
      groups: {
        oc_xxx: {
          requireMention: false,     // 无需@也响应
          allowFrom: ["ou_user1"]    // 发送者白名单
        }
      }
    }
  }
}

获取群组 ID（oc_xxx）：在群组中 @机器人发消息，然后 openclaw logs --follow 查看 chat_id。 获取用户 ID（ou_xxx）：同理查看日志中的 open_id，或 openclaw pairing list feishu。

飞书支持通过交互式卡片实现流式输出，实时显示生成进度：

{
  channels: {
    feishu: {
      streaming: true,        // 启用流式卡片（默认 true）
      blockStreaming: true     // 块级流式（默认 true）
    }
  }
}

消息引用功能（replyToMode）与流式卡片不能同时使用。replyToMode 群聊默认 all，私聊默认 off。

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx", appSecret: "xxx", botName: "主机器人"
        },
        backup: {
          appId: "cli_yyy", appSecret: "yyy", botName: "备用", enabled: false
        }
      }
    }
  }
}

通过 bindings 配置可将不同用户/群组路由到不同 Agent。 匹配规则使用 match.channel: "feishu"，match.peer.kind 区分 dm/group。

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

• typingIndicator: false — 不发送"正在输入"状态
• resolveSenderNames: false — 不拉取发送者资料

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

飞书目前不支持原生命令菜单，命令以文本形式发送。