Feishu

​

Szybki start

openclaw channels login --channel feishu

openclaw gateway restart

​

Kontrola dostępu

​

Wiadomości prywatne

• "pairing" - nieznani użytkownicy otrzymują kod parowania; zatwierdź przez CLI
• "allowlist" - czatować mogą tylko użytkownicy wymienieni w allowFrom
• "open" - zezwól na publiczne DM-y tylko wtedy, gdy allowFrom zawiera "*"; przy wpisach restrykcyjnych czatować mogą tylko pasujący użytkownicy

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Czaty grupowe

• true - wymagaj @wzmianki (domyślnie)
• false - odpowiadaj bez @wzmianki
• Nadpisanie dla grupy: channels.feishu.groups.<chat_id>.requireMention
• Wzmianki rozgłoszeniowe @all i @_all nie są traktowane jako wzmianki o bocie. Wiadomość, która zawiera zarówno @all, jak i bezpośrednią wzmiankę o bocie, nadal liczy się jako wzmianka o bocie.

​

Przykłady konfiguracji grup

​

Zezwól na wszystkie grupy, bez wymaganej @wzmianki

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

​

Zezwól na wszystkie grupy, nadal wymagaj @wzmianki

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

​

Zezwól tylko na konkretne grupy

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

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

​

Ogranicz nadawców w grupie

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

​

Uzyskaj identyfikatory grup/użytkowników

​

Identyfikatory grup (chat_id, format: oc_xxx)

​

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

openclaw logs --follow

openclaw pairing list feishu

​

Typowe polecenia

​

Rozwiązywanie problemów

​

Bot nie odpowiada w czatach grupowych

1. Upewnij się, że bot został dodany do grupy
2. Upewnij się, że używasz @wzmianki o bocie (domyślnie wymagane)
3. Sprawdź, czy groupPolicy nie ma wartości "disabled"
4. Sprawdź logi: openclaw logs --follow

​

Bot nie odbiera wiadomości

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

​

Konfiguracja QR nie reaguje w aplikacji mobilnej Feishu

1. Uruchom konfigurację ponownie: openclaw channels login --channel feishu
2. Wybierz konfigurację ręczną
3. W Feishu Open Platform utwórz aplikację własną i skopiuj jej App ID oraz App Secret
4. Wklej te poświadczenia do kreatora konfiguracji

​

Wyciekł App Secret

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

​

Konfiguracja zaawansowana

​

Wiele kont

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

​

Limity wiadomości

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

​

Strumieniowanie

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

​

Optymalizacja limitów

• 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

​

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

​

Uruchom ACP z czatu

/acp spawn codex --thread here

​

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

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

​

Izolacja agentów dla poszczególnych użytkowników (dynamiczne tworzenie agentów)

• Niezależny katalog workspace
• Osobne USER.md / SOUL.md / MEMORY.md
• Prywatną historię rozmów
• Izolowane Skills i stan

​

Szybka konfiguracja

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

​

Jak to działa

1. Kanał generuje unikalne agentId: feishu-{user_open_id} dla konta domyślnego albo ograniczony skrót tożsamości z prefiksem konta dla konta nazwanego
2. Tworzy nowy workspace w ścieżce workspaceTemplate
3. Rejestruje agenta i tworzy powiązanie dla tego użytkownika
4. Pomocnik workspace zapewnia pliki inicjalizacyjne (AGENTS.md, SOUL.md, USER.md itd.) przy pierwszym dostępie
5. Kieruje wszystkie przyszłe wiadomości od tego użytkownika do jego dedykowanego agenta

​

Opcje konfiguracji

• {agentId} - wygenerowany identyfikator agenta (np. feishu-ou_xxxxxx lub feishu-support-<identity_digest>)
• {userId} - Feishu open_id nadawcy (np. ou_xxxxxx)

​

Zakres sesji

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

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

​

Typowe wdrożenie wieloużytkownikowe

{
  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
}

​

Weryfikacja

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-*

​

Uwagi

• Izolacja obszaru roboczego: każdy użytkownik otrzymuje własny katalog obszaru roboczego i instancję agenta. Użytkownicy nie widzą historii rozmów ani plików innych użytkowników w normalnym przepływie wiadomości.
• Granica bezpieczeństwa: to mechanizm izolacji kontekstu wiadomości, a nie granica bezpieczeństwa między wrogimi współdzierżawcami. Proces agenta i środowisko hosta są współdzielone.
• bindings powinno być puste: dynamiczni agenci automatycznie rejestrują własne powiązania
• Ścieżka aktualizacji: istniejące ręczne powiązania nadal działają równolegle z dynamicznymi agentami
• session.dmScope jest globalne: wpływa to na wszystkie kanały, nie tylko Feishu

​

Dokumentacja konfiguracji

​

Obsługiwane typy wiadomości

​

Odbieranie

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

​

Wysyłanie

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

​

Wątki i odpowiedzi

• ✅ Odpowiedzi w linii
• ✅ Odpowiedzi w wątku
• ✅ Odpowiedzi z mediami zachowują świadomość wątku podczas odpowiadania na wiadomość w wątku

​

Powiązane

• Przegląd kanałów - wszystkie obsługiwane kanały
• Parowanie - przepływ uwierzytelniania i parowania w DM
• Grupy - zachowanie czatu grupowego i bramkowanie wzmianek
• Routing kanałów - routing sesji dla wiadomości
• Bezpieczeństwo - model dostępu i utwardzanie