Feishu

​

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 nố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
• "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

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 thông báo không được xem là nhắc đến bot. Tin nhắn nhắc đến cả @all và trực tiếp bot vẫn được tính là một lượt 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,
        },
      },
    },
  },
}

​

Giới hạn 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 (mặc định là bắt buộc)
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 đã cấp tất cả phạm vi quyền bắt buộc
5. Đảm bảo Gateway đang chạy: openclaw gateway status
6. Kiểm tra nhật ký: openclaw logs --follow

​

Thiết lập QR không phản hồi trong ứng dụng Feishu trên di động

1. Chạy lại thiết lập: openclaw channels login --channel feishu
2. Chọn thiết lập thủ công
3. Trong Feishu Open Platform, tạo ứng dụng tự xây dựng và sao chép App ID cùng App Secret của ứng dụng đó
4. Dán các thông tin xác thực đó vào trình hướng dẫn thiết lập

​

App Secret bị lộ

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 lâu dài

{
  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" },
    },
  ],
}

​

Spawn ACP từ chat

/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 người dùng (ou_xxx) hoặc ID nhóm (oc_xxx)

​

Cô lập agent theo từng người dùng (Tạo agent động)

• Thư mục workspace độc lập
• USER.md / SOUL.md / MEMORY.md riêng
• Lịch sử cuộc trò chuyện riêng tư
• Skills và trạng thái cô lập

​

Thiết lập nhanh

{
  channels: {
    feishu: {
      dmPolicy: "open",
      allowFrom: ["*"],
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Critical: makes each user's DM their "main session"
    // Automatically loads USER.md / SOUL.md / MEMORY.md
    // For stronger isolation, use "per-channel-peer" instead
    dmScope: "main",
  },
}

​

Cách hoạt động

1. Kênh tạo một agentId duy nhất: feishu-{user_open_id} cho tài khoản mặc định, hoặc một digest danh tính có tiền tố tài khoản và giới hạn độ dài cho tài khoản được đặt tên
2. Tạo workspace mới tại đường dẫn workspaceTemplate
3. Đăng ký agent và tạo liên kết cho người dùng này
4. Trình trợ giúp workspace đảm bảo có các tệp bootstrap (AGENTS.md, SOUL.md, USER.md, v.v.) trong lần truy cập đầu tiên
5. Định tuyến tất cả tin nhắn trong tương lai từ người dùng này đến agent chuyên dụng của họ

​

Tùy chọn cấu hình

• {agentId} - ID agent được tạo (ví dụ: feishu-ou_xxxxxx hoặc feishu-support-<identity_digest>)
• {userId} - open_id Feishu của người gửi (ví dụ: ou_xxxxxx)

​

Phạm vi phiên

{
  session: {
    // For single-user personal bots: enables auto bootstrap loading
    dmScope: "main",

    // For public multi-user bots: stronger isolation
    // dmScope: "per-channel-peer",
  },
}

​

Triển khai nhiều người dùng điển hình

{
  channels: {
    feishu: {
      appId: "cli_xxx",
      appSecret: "xxx",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "open",
      requireMention: true,
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Choose dmScope based on your isolation needs:
    // "main" for bootstrap auto-loading, "per-channel-peer" for stronger isolation
    dmScope: "main",
  },
  bindings: [], // Empty - dynamic agents auto-bind
}

​

Xác minh

feishu: creating dynamic agent "feishu-ou_xxxxxx" for user ou_xxxxxx
workspace: /Users/you/.openclaw/workspace-feishu-ou_xxxxxx
feishu: dynamic agent created, new route: agent:feishu-ou_xxxxxx:main

ls -la ~/.openclaw/workspace-*

​

Ghi chú

• Cách ly workspace: Mỗi người dùng có thư mục workspace và phiên bản agent riêng. Người dùng không thể xem lịch sử hội thoại hoặc tệp của nhau trong luồng nhắn tin thông thường.
• Ranh giới bảo mật: Đây là cơ chế cách ly ngữ cảnh nhắn tin, không phải ranh giới bảo mật giữa các đồng thuê đối địch. Tiến trình agent và môi trường máy chủ được dùng chung.
• bindings nên để trống: Agent động tự động đăng ký liên kết riêng của chúng
• Lộ trình nâng cấp: Các liên kết thủ công hiện có tiếp tục hoạt động cùng với agent động
• session.dmScope là toàn cục: Điều này ảnh hưởng đến tất cả các kênh, không chỉ Feishu

​

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 giàu đị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/phương tiện
• ✅ Thẻ tương tác (bao gồm cập nhật phát trực tuyến)
• ⚠️ Văn bản định dạng phong phú (định dạng kiểu bài đăng; không hỗ trợ đầy đủ các khả năng soạn thảo của Feishu/Lark)

​

Luồng và phản hồi

• ✅ Phản hồi nội dòng
• ✅ Phản hồi trong luồng
• ✅ Phản hồi phương tiện 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 - luồng ghép nối và xác thực DM
• Nhóm - hành vi trò chuyện nhóm và cổng nhắc đến
• Đị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ố