Feishu

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Bắt đầu nhanh

openclaw channels login --channel feishu

openclaw gateway restart

​

Kiểm soát truy cập

​

Tin nhắn trực tiếp

• "pairing" - người dùng không xác định nhận mã ghép đôi; phê duyệt qua CLI
• "allowlist" - chỉ người dùng được liệt kê trong allowFrom mới có thể trò chuyện (mặc định: chỉ chủ sở hữu bot)
• "open" - chỉ cho phép DM công khai khi allowFrom bao gồm "*"; với các mục hạn chế, chỉ người dùng khớp mới có thể trò chuyện
• "disabled" - tắt tất cả DM

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Trò chuyện nhóm

• true - yêu cầu @mention (mặc định)
• false - phản hồi mà không cần @mention
• Ghi đè theo từng nhóm: channels.feishu.groups.<chat_id>.requireMention
• @all và @_all chỉ dùng để phát tới mọi người không được coi là nhắc đến bot. Một tin nhắn nhắc đến cả @all và trực tiếp bot vẫn được tính là nhắc đến bot.

​

Ví dụ cấu hình nhóm

​

Cho phép tất cả nhóm, không yêu cầu @mention

{
  channels: {
    feishu: {
      groupPolicy: "open",
    },
  },
}

​

Cho phép tất cả nhóm, vẫn yêu cầu @mention

{
  channels: {
    feishu: {
      groupPolicy: "open",
      requireMention: true,
    },
  },
}

​

Chỉ cho phép các nhóm cụ thể

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Group IDs look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groups: {
        oc_xxx: {
          requireMention: false,
        },
      },
    },
  },
}

​

Hạn chế người gửi trong một nhóm

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // User open_ids look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Lấy ID nhóm/người dùng

​

ID nhóm (chat_id, định dạng: oc_xxx)

​

ID người dùng (open_id, định dạng: ou_xxx)

openclaw logs --follow

openclaw pairing list feishu

​

Lệnh thường dùng

​

Khắc phục sự cố

​

Bot không phản hồi trong trò chuyện nhóm

1. Đảm bảo bot đã được thêm vào nhóm
2. Đảm bảo bạn @mention bot (bắt buộc theo mặc định)
3. Xác minh groupPolicy không phải là "disabled"
4. Kiểm tra nhật ký: openclaw logs --follow

​

Bot không nhận được tin nhắn

1. Đảm bảo bot đã được phát hành và phê duyệt trong Feishu Open Platform / Lark Developer
2. Đảm bảo đăng ký sự kiện bao gồm im.message.receive_v1
3. Đảm bảo đã chọn kết nối liên tục (WebSocket)
4. Đảm bảo tất cả phạm vi quyền cần thiết đã được cấp
5. Đảm bảo gateway đang chạy: openclaw gateway status
6. Kiểm tra nhật ký: openclaw logs --follow

​

App Secret bị rò rỉ

1. Đặt lại App Secret trong Feishu Open Platform / Lark Developer
2. Cập nhật giá trị trong cấu hình của bạn
3. Khởi động lại gateway: openclaw gateway restart

​

Cấu hình nâng cao

​

Nhiều tài khoản

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Primary bot",
          tts: {
            providers: {
              openai: { voice: "shimmer" },
            },
          },
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

Giới hạn tin nhắn

• textChunkLimit - kích thước đoạn văn bản gửi đi (mặc định: 2000 ký tự)
• mediaMaxMb - giới hạn tải lên/tải xuống phương tiện (mặc định: 30 MB)

​

Streaming

{
  channels: {
    feishu: {
      streaming: true, // enable streaming card output (default: true)
      blockStreaming: true, // opt into completed-block streaming
    },
  },
}

​

Tối ưu hạn mức

• typingIndicator (mặc định true): đặt false để bỏ qua các lệnh gọi phản ứng đang nhập
• resolveSenderNames (mặc định true): đặt false để bỏ qua tra cứu hồ sơ người gửi

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
    },
  },
}

​

Phiên ACP

​

Liên kết ACP liên tục

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "direct", id: "ou_1234567890" },
      },
    },
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "group", id: "oc_group_chat:topic:om_topic_root" },
      },
      acp: { label: "codex-feishu-topic" },
    },
  ],
}

​

Tạo ACP từ trò chuyện

/acp spawn codex --thread here

​

Định tuyến nhiều agent

{
  agents: {
    list: [
      { id: "main" },
      { id: "agent-a", workspace: "/home/user/agent-a" },
      { id: "agent-b", workspace: "/home/user/agent-b" },
    ],
  },
  bindings: [
    {
      agentId: "agent-a",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "agent-b",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

• match.channel: "feishu"
• match.peer.kind: "direct" (DM) hoặc "group" (trò chuyện nhóm)
• match.peer.id: Open ID của người dùng (ou_xxx) hoặc ID nhóm (oc_xxx)

​

Tham chiếu cấu hình

​

Loại tin nhắn được hỗ trợ

​

Nhận

• ✅ Văn bản
• ✅ Văn bản định dạng (bài đăng)
• ✅ Hình ảnh
• ✅ Tệp
• ✅ Âm thanh
• ✅ Video/media
• ✅ Nhãn dán

​

Gửi

• ✅ Văn bản
• ✅ Hình ảnh
• ✅ Tệp
• ✅ Âm thanh
• ✅ Video/media
• ✅ Thẻ tương tác (bao gồm cập nhật streaming)
• ⚠️ Văn bản định dạng (định dạng kiểu bài đăng; không hỗ trợ đầy đủ khả năng soạn thảo của Feishu/Lark)

​

Luồng và trả lời

• ✅ Trả lời nội tuyến
• ✅ Trả lời trong luồng
• ✅ Trả lời media vẫn nhận biết luồng khi trả lời một tin nhắn trong luồng

​

Liên quan

• Tổng quan về kênh - tất cả các kênh được hỗ trợ
• Ghép nối - xác thực DM và luồng ghép nối
• Nhóm - hành vi trò chuyện nhóm và chặn theo lượt nhắc
• Định tuyến kênh - định tuyến phiên cho tin nhắn
• Bảo mật - mô hình truy cập và gia cố