Waarom Feishu?
Feishu (飞书), internationaal bekend als Lark, is het zakelijke samenwerkingsplatform van ByteDance — breed gebruikt in Chinese techbedrijven, startups en in toenemende mate in Zuidoost-Azië. Met OpenClaw v2026.2.2 werd Feishu de eerste officieel ondersteunde Chinese chatclient van het platform.
- •Geen publieke URL vereist — geen ngrok, geen domein, geen webhookserver
- •Werkt achter firewalls — de verbinding is uitgaand vanaf uw machine
- •Lage latentie — realtime bidirectioneel berichtenverkeer
- •Ondersteuning voor rijke content — tekst, afbeeldingen, bestanden, audio, video en stickers
Vereisten
- •OpenClaw v2026.2.2 of later
- •Een Feishu/Lark zakelijk account (gratis tier werkt)
- •Beheerderstoegang om apps te maken op het Feishu Open Platform
Stap 1: Maak een Feishu-app aan
- 1.Ga naar het Feishu Open Platform (of de Lark Developer Console voor internationale tenants)
- 2.Klik op Create Custom App
- 3.Stel de app-naam in (bijv. "OpenClaw Agent") en beschrijving
- 4.Upload een icoon (het OpenClaw-kreeftlogo werkt goed)
- 5.Kopieer de App ID (formaat:
cli_xxx) en App Secret van de Credentials-pagina
Stap 2: Configureer app-machtigingen
Schakel in de machtigingsinstellingen van uw app deze scopes in:
| Machtiging | Doel |
|---|---|
im:message | Berichten versturen en ontvangen |
im:message.group_at_msg | @-vermeldingen in groepschats ontvangen |
im:resource | Toegang tot afbeeldingen en bestanden |
contact:user.id:readonly | Gebruikers identificeren |
Klik na het toevoegen van machtigingen op Publish om ter beoordeling in te dienen. In de meeste zakelijke tenants worden zelfgebouwde apps automatisch goedgekeurd.
Stap 3: Schakel event-subscriptie in
- 1.Ga in de app-instellingen naar Event Subscriptions
- 2.Selecteer WebSocket Mode (long connection) — dit is essentieel. Gebruik NIET de webhookmodus, omdat deze een publieke URL vereist.
- 3.Abonneer u op deze events:
Stap 4: Configureer OpenClaw
Voeg de Feishu-credentials toe aan uw OpenClaw-configuratie. Bewerk ~/.openclaw/.env:
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=your_app_secret_here
Of als u het OpenClaw-configuratiebestand gebruikt (~/.openclaw/config.yaml):
channels:
feishu:
enabled: true
appId: cli_xxxxxxxxxxxxx
appSecret: your_app_secret_here
Herstart OpenClaw:
openclaw restart
U zou een logbericht moeten zien dat bevestigt dat de Feishu WebSocket-verbinding tot stand is gebracht.
Stap 5: Test de verbinding
Open Feishu en zoek uw app in de chatlijst (zoek op de app-naam die u in Stap 1 hebt ingesteld). Stuur een bericht:
> Hallo!
- •Tekstberichten
- •Afbeeldingen (de agent kan deze analyseren als een model met visuele mogelijkheden wordt gebruikt)
- •Bestanden (de agent kan documenten lezen)
- •Spraakberichten (getranscribeerd en verwerkt als tekst)
Groepschatconfiguratie
OpenClaw ondersteunt Feishu-groepschats met drie toegangsmodi:
| Modus | Gedrag |
|---|---|
open (standaard) | Elk groepslid kan de bot activeren wanneer @-vermeld |
allowlist | Alleen goedgekeurde gebruikers kunnen interacteren, zelfs met @-vermelding |
disabled | Groepsberichten worden volledig genegeerd |
Configureer in config.yaml:
channels:
feishu:
groupAccess: open # or "allowlist" or "disabled"
allowedUsers: # only used with "allowlist" mode
- user_id_1
- user_id_2
In groepschats reageert de agent alleen wanneer @-vermeld, om ruis in drukke kanalen te voorkomen.
Streaming-responses
OpenClaw ondersteunt het streamen van AI-responses in Feishu met behulp van interactieve kaarten. In plaats van te wachten op de volledige respons, stuurt de agent een initiële kaart en werkt deze in realtime bij terwijl de AI tekst genereert. Dit biedt een veel betere gebruikerservaring voor lange antwoorden.
Streaming is standaard ingeschakeld. Om het uit te schakelen:
channels:
feishu:
streaming: false
Ondersteunde berichttypes
| Richting | Ondersteunde types |
|---|---|
| Inkomend (gebruiker naar agent) | Tekst, rich text (post), afbeeldingen, bestanden, audio, video, stickers |
| Uitgaand (agent naar gebruiker) | Tekst, afbeeldingen, bestanden, audio, interactieve kaarten |
Probleemoplossing
"App not found"-fout: Zorg ervoor dat de app is gepubliceerd en goedgekeurd in uw Feishu-tenant. Zelfgebouwde apps in zakelijke tenants worden doorgaans automatisch goedgekeurd, maar sommige organisaties vereisen goedkeuring van de beheerder.
Geen respons van agent: Controleer OpenClaw-logs (openclaw logs) op WebSocket-verbindingsfouten. Verifieer dat de App ID en App Secret correct zijn.
Berichten komen niet aan in groepschats: Zorg ervoor dat de bot is toegevoegd aan de groep en dat de gebruiker de bot correct @-vermeldt. Controleer de groupAccess-instelling.
Verbinding valt weg: De WebSocket-verbinding herstelt automatisch. Als verbindingsonderbrekingen frequent zijn, controleer dan uw netwerkstabiliteit of firewall-instellingen.
De community-bridge gebruiken (Alternatief)
Als u functies nodig hebt die verder gaan dan de native integratie, biedt de door de gemeenschap onderhouden feishu-openclaw bridge van AlexAnys aanvullende mogelijkheden zoals aangepaste berichtopmaak en geavanceerd groepsbeheer. Het kost ongeveer 5 minuten om in te stellen en vereist geen publieke server.
Voor volledige documentatie, zie de officiële Feishu-kanaalgids.