Configurazione del canale Feishu

Guida passo a passo per creare un'app Feishu e configurarla come canale in OpenClaw.

Apri la console sviluppatori Feishu

1
Apri la console sviluppatori

Vai su https://open.feishu.cn/app ed effettua l’accesso con il tuo account Feishu.

Crea un'app

2
Crea una nuova app enterprise

Fai clic su 'Create Enterprise App', compila nome e descrizione dell’app e scegli un’icona.

Crea una nuova app enterprise

Ottieni le credenziali dell'app

3
Copia App ID e App Secret

Nella pagina 'Credentials & Basic Info', copia App ID (formato `cli_xxx`) e App Secret. Conserva l’App Secret in sicurezza.

Copia App ID e App Secret

Abilita la funzionalità bot

4
Abilita il bot

In 'App Capabilities' > 'Bot', abilita la funzionalità bot in modo che l’app possa agire come bot nelle chat.

Abilita il bot

Configura i permessi

5
Importa gli scope richiesti

In 'Permission Management' fai clic su 'Bulk Import' e incolla il JSON seguente per importare gli scope tenant e utente richiesti. ```json { "scopes": { "tenant": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } } ```

Importa gli scope richiesti

Aggiungi il canale Feishu in OpenClaw

6
Aggiungi canale

Accedi a OpenClaw, vai in 'My OpenClaw' → 'Channels' e fai clic su '+ Add Channel'. Inserisci Feishu App ID e App Secret, salva e attendi il completamento della configurazione.

Aggiungi canale

Configura sottoscrizione eventi e callback

7
Scegli la modalità di connessione

Seleziona 'Use long connection to receive events' (modalità WebSocket). Nota: il canale Feishu deve essere configurato prima in OpenClaw, altrimenti il salvataggio può fallire.

Scegli la modalità di connessione
8
Aggiungi evento ricezione messaggi

Aggiungi l’evento `im.message.receive_v1` per ricevere i messaggi in arrivo.

Aggiungi evento ricezione messaggi

Pubblica l'app

9
Pubblica

Compila i dettagli della versione e salva, poi pubblica l’app affinché sia disponibile per il tuo tenant.

Pubblica

Chatta con il bot

10
Invia un messaggio al bot

Da Feishu Workbench trova il bot creato e invia un messaggio per iniziare la chat.

Invia un messaggio al bot