Feishu / Lark

Feishu/Lark to kompleksowa platforma do współpracy, w której zespoły czatują, udostępniają dokumenty, zarządzają kalendarzami i wspólnie wykonują pracę. Status: gotowe do użycia produkcyjnego dla prywatnych wiadomości bota i czatów grupowych. WebSocket jest trybem domyślnym; tryb webhook jest opcjonalny.

Szybki start

Wymaga OpenClaw 2026.4.10 lub nowszego. Aby sprawdzić wersję, uruchom openclaw --version. Zaktualizuj za pomocą openclaw update.

Uruchom kreator konfiguracji kanału

openclaw channels login --channel feishu

Zeskanuj kod QR w aplikacji mobilnej Feishu/Lark, aby automatycznie utworzyć bota Feishu/Lark.

Po zakończeniu konfiguracji uruchom ponownie Gateway, aby zastosować zmiany

openclaw gateway restart

Kontrola dostępu

Prywatne wiadomości

Skonfiguruj dmPolicy, aby określić, kto może wysyłać prywatne wiadomości do bota:

"pairing" — nieznani użytkownicy otrzymują kod parowania; zatwierdź przez CLI
"allowlist" — tylko użytkownicy wymienieni w allowFrom mogą czatować (domyślnie: tylko właściciel bota)
"open" — zezwól wszystkim użytkownikom
"disabled" — wyłącz wszystkie prywatne wiadomości

Zatwierdzanie prośby o parowanie:

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

Czaty grupowe

Zasada dla grup (channels.feishu.groupPolicy):

Wartość	Zachowanie
`"open"`	Odpowiadaj na wszystkie wiadomości w grupach
`"allowlist"`	Odpowiadaj tylko grupom z `groupAllowFrom`
`"disabled"`	Wyłącz wszystkie wiadomości grupowe

Domyślnie: allowlist Wymaganie wzmianki (channels.feishu.requireMention):

true — wymagaj wzmianki @ (domyślnie)
false — odpowiadaj bez wzmianki @
Nadpisanie dla grupy: channels.feishu.groups.<chat_id>.requireMention

Przykłady konfiguracji grup

Zezwól na wszystkie grupy, bez wymogu wzmianki @

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

Zezwól na wszystkie grupy, ale nadal wymagaj wzmianki @

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

Zezwól tylko na określone grupy

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Identyfikatory grup wyglądają tak: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

Ogranicz nadawców w obrębie grupy

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Identyfikatory open_id użytkowników wyglądają tak: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

Pobieranie identyfikatorów grup/użytkowników

Identyfikatory grup (`chat_id`, format: `oc_xxx`)

Otwórz grupę w Feishu/Lark, kliknij ikonę menu w prawym górnym rogu i przejdź do Settings. Identyfikator grupy (chat_id) jest widoczny na stronie ustawień.

Identyfikatory użytkowników (`open_id`, format: `ou_xxx`)

Uruchom Gateway, wyślij prywatną wiadomość do bota, a następnie sprawdź logi:

openclaw logs --follow

Poszukaj open_id w danych wyjściowych logów. Możesz też sprawdzić oczekujące prośby o parowanie:

openclaw pairing list feishu

Typowe polecenia

Polecenie	Opis
`/status`	Pokaż status bota
`/reset`	Zresetuj bieżącą sesję
`/model`	Pokaż lub przełącz model AI

Feishu/Lark nie obsługuje natywnego menu poleceń z ukośnikiem, więc wysyłaj je jako zwykłe wiadomości tekstowe.

Rozwiązywanie problemów

Bot nie odpowiada na czatach grupowych

Upewnij się, że bot został dodany do grupy
Upewnij się, że oznaczasz bota wzmianką @ (domyślnie wymagane)
Sprawdź, czy groupPolicy nie ma wartości "disabled"
Sprawdź logi: openclaw logs --follow

Bot nie odbiera wiadomości

Upewnij się, że bot został opublikowany i zatwierdzony w Feishu Open Platform / Lark Developer
Upewnij się, że subskrypcja zdarzeń obejmuje im.message.receive_v1
Upewnij się, że wybrano persistent connection (WebSocket)
Upewnij się, że przyznano wszystkie wymagane zakresy uprawnień
Upewnij się, że Gateway działa: openclaw gateway status
Sprawdź logi: openclaw logs --follow

Wyciekł App Secret

Zresetuj App Secret w Feishu Open Platform / Lark Developer
Zaktualizuj wartość w swojej konfiguracji
Uruchom ponownie Gateway: openclaw gateway restart

Konfiguracja zaawansowana

Wiele kont

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Główny bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Bot zapasowy",
          enabled: false,
        },
      },
    },
  },
}

defaultAccount określa, które konto jest używane, gdy wychodzące API nie określają accountId.

Limity wiadomości

textChunkLimit — rozmiar fragmentu tekstu wychodzącego (domyślnie: 2000 znaków)
mediaMaxMb — limit przesyłania/pobierania multimediów (domyślnie: 30 MB)

Streaming

Feishu/Lark obsługuje odpowiedzi strumieniowe za pomocą interaktywnych kart. Gdy ta funkcja jest włączona, bot aktualizuje kartę w czasie rzeczywistym podczas generowania tekstu.

{
  channels: {
    feishu: {
      streaming: true, // włącz wyjście strumieniowe w kartach (domyślnie: true)
      blockStreaming: true, // włącz streaming na poziomie bloków (domyślnie: true)
    },
  },
}

Ustaw streaming: false, aby wysyłać pełną odpowiedź w jednej wiadomości.

Optymalizacja limitów

Zmniejsz liczbę wywołań API Feishu/Lark za pomocą dwóch opcjonalnych flag:

typingIndicator (domyślnie true): ustaw false, aby pominąć wywołania reakcji pisania
resolveSenderNames (domyślnie true): ustaw false, aby pominąć wyszukiwanie profili nadawców

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

Sesje ACP

Feishu/Lark obsługuje ACP dla prywatnych wiadomości i wiadomości wątków grupowych. ACP w Feishu/Lark jest sterowane poleceniami tekstowymi — nie ma natywnych menu poleceń z ukośnikiem, więc używaj bezpośrednio wiadomości /acp ... w rozmowie.

Trwałe powiązanie ACP

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

Uruchamianie ACP z czatu

W prywatnej wiadomości lub wątku Feishu/Lark:

/acp spawn codex --thread here

--thread here działa w prywatnych wiadomościach i wiadomościach wątków Feishu/Lark. Kolejne wiadomości w powiązanej rozmowie są kierowane bezpośrednio do tej sesji ACP.

Routing wielu agentów

Użyj bindings, aby kierować prywatne wiadomości lub grupy Feishu/Lark do różnych agentów.

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

Pola routingu:

match.channel: "feishu"
match.peer.kind: "direct" (prywatna wiadomość) lub "group" (czat grupowy)
match.peer.id: Open ID użytkownika (ou_xxx) lub identyfikator grupy (oc_xxx)

Wskazówki dotyczące wyszukiwania znajdziesz w Pobieranie identyfikatorów grup/użytkowników.

Dokumentacja konfiguracji

Pełna konfiguracja: Konfiguracja Gateway

Ustawienie	Opis	Domyślnie
`channels.feishu.enabled`	Włącz/wyłącz kanał	`true`
`channels.feishu.domain`	Domena API (`feishu` lub `lark`)	`feishu`
`channels.feishu.connectionMode`	Transport zdarzeń (`websocket` lub `webhook`)	`websocket`
`channels.feishu.defaultAccount`	Domyślne konto dla routingu wychodzącego	`default`
`channels.feishu.verificationToken`	Wymagane w trybie webhook	—
`channels.feishu.encryptKey`	Wymagane w trybie webhook	—
`channels.feishu.webhookPath`	Ścieżka trasy webhooka	`/feishu/events`
`channels.feishu.webhookHost`	Host powiązania webhooka	`127.0.0.1`
`channels.feishu.webhookPort`	Port powiązania webhooka	`3000`
`channels.feishu.accounts.<id>.appId`	App ID	—
`channels.feishu.accounts.<id>.appSecret`	App Secret	—
`channels.feishu.accounts.<id>.domain`	Nadpisanie domeny dla konta	`feishu`
`channels.feishu.dmPolicy`	Zasada dla prywatnych wiadomości	`allowlist`
`channels.feishu.allowFrom`	Lista dozwolonych prywatnych wiadomości (lista `open_id`)	[BotOwnerId]
`channels.feishu.groupPolicy`	Zasada dla grup	`allowlist`
`channels.feishu.groupAllowFrom`	Lista dozwolonych grup	—
`channels.feishu.requireMention`	Wymagaj wzmianki @ w grupach	`true`
`channels.feishu.groups.<chat_id>.requireMention`	Nadpisanie wzmianki @ dla grupy	dziedziczone
`channels.feishu.groups.<chat_id>.enabled`	Włącz/wyłącz określoną grupę	`true`
`channels.feishu.textChunkLimit`	Rozmiar fragmentu wiadomości	`2000`
`channels.feishu.mediaMaxMb`	Limit rozmiaru multimediów	`30`
`channels.feishu.streaming`	Strumieniowe wyjście kart	`true`
`channels.feishu.blockStreaming`	Streaming na poziomie bloków	`true`
`channels.feishu.typingIndicator`	Wysyłaj reakcje pisania	`true`
`channels.feishu.resolveSenderNames`	Rozpoznawaj wyświetlane nazwy nadawców	`true`

Obsługiwane typy wiadomości

Odbieranie

✅ Tekst
✅ Tekst sformatowany (post)
✅ Obrazy
✅ Pliki
✅ Audio
✅ Wideo/multimedia
✅ Naklejki

Wysyłanie

✅ Tekst
✅ Obrazy
✅ Pliki
✅ Audio
✅ Wideo/multimedia
✅ Karty interaktywne (w tym aktualizacje strumieniowe)
⚠️ Tekst sformatowany (formatowanie w stylu post; nie obsługuje pełnych możliwości tworzenia treści Feishu/Lark)

Wątki i odpowiedzi

✅ Odpowiedzi wbudowane
✅ Odpowiedzi wątkowe
✅ Odpowiedzi z multimediami zachowują świadomość wątku podczas odpowiadania na wiadomość w wątku

Powiązane

Przegląd kanałów — wszystkie obsługiwane kanały
Parowanie — uwierzytelnianie prywatnych wiadomości i przepływ parowania
Grupy — zachowanie czatów grupowych i bramkowanie wzmiankami
Routing kanałów — routing sesji dla wiadomości
Zabezpieczenia — model dostępu i utwardzanie

Overview

Messaging platforms

Configuration

Feishu

Feishu / Lark

Szybki start

Kontrola dostępu

Prywatne wiadomości

Czaty grupowe

Przykłady konfiguracji grup

Zezwól na wszystkie grupy, bez wymogu wzmianki @

Zezwól na wszystkie grupy, ale nadal wymagaj wzmianki @

Zezwól tylko na określone grupy

Ogranicz nadawców w obrębie grupy

Pobieranie identyfikatorów grup/użytkowników

Identyfikatory grup (`chat_id`, format: `oc_xxx`)

Identyfikatory użytkowników (`open_id`, format: `ou_xxx`)

Typowe polecenia

Rozwiązywanie problemów

Bot nie odpowiada na czatach grupowych

Bot nie odbiera wiadomości

Wyciekł App Secret

Konfiguracja zaawansowana

Wiele kont

Limity wiadomości

Streaming

Optymalizacja limitów

Sesje ACP

Trwałe powiązanie ACP

Uruchamianie ACP z czatu

Routing wielu agentów

Dokumentacja konfiguracji

Obsługiwane typy wiadomości

Odbieranie

Wysyłanie

Wątki i odpowiedzi

Powiązane

Overview

Messaging platforms

Configuration

​Feishu / Lark

​Szybki start

​Kontrola dostępu

​Prywatne wiadomości

​Czaty grupowe

​Przykłady konfiguracji grup

​Zezwól na wszystkie grupy, bez wymogu wzmianki @

​Zezwól na wszystkie grupy, ale nadal wymagaj wzmianki @

​Zezwól tylko na określone grupy

​Ogranicz nadawców w obrębie grupy

​Pobieranie identyfikatorów grup/użytkowników

​Identyfikatory grup (chat_id, format: oc_xxx)

​Identyfikatory użytkowników (open_id, format: ou_xxx)

​Typowe polecenia

​Rozwiązywanie problemów

​Bot nie odpowiada na czatach grupowych

​Bot nie odbiera wiadomości

​Wyciekł App Secret

​Konfiguracja zaawansowana

​Wiele kont

​Limity wiadomości

​Streaming

​Optymalizacja limitów

​Sesje ACP

​Trwałe powiązanie ACP

​Uruchamianie ACP z czatu

​Routing wielu agentów

​Dokumentacja konfiguracji

​Obsługiwane typy wiadomości

​Odbieranie

​Wysyłanie

​Wątki i odpowiedzi

​Powiązane

Feishu / Lark

Szybki start

Kontrola dostępu

Prywatne wiadomości

Czaty grupowe

Przykłady konfiguracji grup

Zezwól na wszystkie grupy, bez wymogu wzmianki @

Zezwól na wszystkie grupy, ale nadal wymagaj wzmianki @

Zezwól tylko na określone grupy

Ogranicz nadawców w obrębie grupy

Pobieranie identyfikatorów grup/użytkowników

Identyfikatory grup (`chat_id`, format: `oc_xxx`)

Identyfikatory użytkowników (`open_id`, format: `ou_xxx`)

Typowe polecenia

Rozwiązywanie problemów

Bot nie odpowiada na czatach grupowych

Bot nie odbiera wiadomości

Wyciekł App Secret

Konfiguracja zaawansowana

Wiele kont

Limity wiadomości

Streaming

Optymalizacja limitów

Sesje ACP

Trwałe powiązanie ACP

Uruchamianie ACP z czatu

Routing wielu agentów

Dokumentacja konfiguracji

Obsługiwane typy wiadomości

Odbieranie

Wysyłanie

Wątki i odpowiedzi

Powiązane