Feishu

​

Avvio rapido

openclaw channels login --channel feishu

openclaw gateway restart

​

Controllo degli accessi

​

Messaggi diretti

• "pairing" - gli utenti sconosciuti ricevono un codice di abbinamento; approva tramite CLI
• "allowlist" - solo gli utenti elencati in allowFrom possono chattare
• "open" - consenti DM pubblici solo quando allowFrom include "*"; con voci restrittive, solo gli utenti corrispondenti possono chattare

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Chat di gruppo

• true - richiede @menzione (predefinito)
• false - risponde senza @menzione
• Sovrascrittura per gruppo: channels.feishu.groups.<chat_id>.requireMention
• @all e @_all solo broadcast non vengono trattati come menzioni del bot. Un messaggio che menziona sia @all sia direttamente il bot conta comunque come menzione del bot.

​

Esempi di configurazione dei gruppi

​

Consenti tutti i gruppi, nessuna @menzione richiesta

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

​

Consenti tutti i gruppi, richiedi comunque @menzione

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

​

Consenti solo gruppi specifici

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

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

​

Limita i mittenti all’interno di un gruppo

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

​

Ottieni ID di gruppo/utente

​

ID gruppo (chat_id, formato: oc_xxx)

​

ID utente (open_id, formato: ou_xxx)

openclaw logs --follow

openclaw pairing list feishu

​

Comandi comuni

​

Risoluzione dei problemi

​

Il bot non risponde nelle chat di gruppo

1. Assicurati che il bot sia aggiunto al gruppo
2. Assicurati di @menzionare il bot (richiesto per impostazione predefinita)
3. Verifica che groupPolicy non sia "disabled"
4. Controlla i log: openclaw logs --follow

​

Il bot non riceve messaggi

1. Assicurati che il bot sia pubblicato e approvato in Feishu Open Platform / Lark Developer
2. Assicurati che la sottoscrizione degli eventi includa im.message.receive_v1
3. Assicurati che sia selezionata la connessione persistente (WebSocket)
4. Assicurati che tutti gli ambiti di autorizzazione richiesti siano concessi
5. Assicurati che il gateway sia in esecuzione: openclaw gateway status
6. Controlla i log: openclaw logs --follow

​

La configurazione tramite QR non reagisce nell’app mobile Feishu

1. Riesegui la configurazione: openclaw channels login --channel feishu
2. Scegli la configurazione manuale
3. In Feishu Open Platform, crea un’app self-built e copia il relativo App ID e App Secret
4. Incolla queste credenziali nella procedura guidata di configurazione

​

App Secret divulgato

1. Reimposta l’App Secret in Feishu Open Platform / Lark Developer
2. Aggiorna il valore nella tua configurazione
3. Riavvia il gateway: openclaw gateway restart

​

Configurazione avanzata

​

Account multipli

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

​

Limiti dei messaggi

• textChunkLimit - dimensione dei blocchi di testo in uscita (predefinito: 2000 caratteri)
• mediaMaxMb - limite di caricamento/scaricamento dei media (predefinito: 30 MB)

​

Streaming

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

​

Ottimizzazione della quota

• typingIndicator (predefinito true): imposta false per saltare le chiamate di reazione alla digitazione
• resolveSenderNames (predefinito true): imposta false per saltare le ricerche dei profili dei mittenti

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

​

Sessioni ACP

​

Binding ACP persistente

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

​

Avvia ACP dalla chat

/acp spawn codex --thread here

​

Routing multi-agente

{
  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) o "group" (chat di gruppo)
• match.peer.id: Open ID utente (ou_xxx) o ID gruppo (oc_xxx)

​

Isolamento agente per utente (Creazione dinamica di agenti)

• Directory workspace indipendente
• USER.md / SOUL.md / MEMORY.md separati
• Cronologia delle conversazioni privata
• Skills e stato isolati

​

Configurazione rapida

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

​

Come funziona

1. Il canale genera un agentId univoco: feishu-{user_open_id} per l’account predefinito, oppure un digest di identità limitato e prefissato con l’account per un account denominato
2. Crea un nuovo workspace nel percorso workspaceTemplate
3. Registra l’agente e crea un binding per questo utente
4. L’helper del workspace assicura i file di bootstrap (AGENTS.md, SOUL.md, USER.md, ecc.) al primo accesso
5. Instrada tutti i messaggi futuri di questo utente al suo agente dedicato

​

Opzioni di configurazione

• {agentId} - l’ID agent generato (ad es. feishu-ou_xxxxxx o feishu-support-<identity_digest>)
• {userId} - il Feishu open_id del mittente (ad es. ou_xxxxxx)

​

Ambito della sessione

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

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

​

Distribuzione multiutente tipica

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

​

Verifica

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

​

Note

• Isolamento dello workspace: ogni utente ottiene la propria directory workspace e la propria istanza agent. Gli utenti non possono vedere la cronologia delle conversazioni o i file degli altri all’interno del normale flusso di messaggistica.
• Confine di sicurezza: questo è un meccanismo di isolamento del contesto di messaggistica, non un confine di sicurezza contro co-tenant ostili. Il processo agent e l’ambiente host sono condivisi.
• bindings deve essere vuoto: gli agent dinamici registrano automaticamente i propri binding
• Percorso di aggiornamento: i binding manuali esistenti continuano a funzionare insieme agli agent dinamici
• session.dmScope è globale: influisce su tutti i canali, non solo su Feishu

​

Riferimento di configurazione

​

Tipi di messaggio supportati

​

Ricezione

• ✅ Testo
• ✅ Testo ricco (post)
• ✅ Immagini
• ✅ File
• ✅ Audio
• ✅ Video/media
• ✅ Sticker

​

Invio

• ✅ Testo
• ✅ Immagini
• ✅ File
• ✅ Audio
• ✅ Video/media
• ✅ Schede interattive (inclusi aggiornamenti in streaming)
• ⚠️ Rich text (formattazione in stile post; non supporta tutte le funzionalità di authoring di Feishu/Lark)

​

Thread e risposte

• ✅ Risposte in linea
• ✅ Risposte nei thread
• ✅ Le risposte multimediali restano consapevoli del thread quando rispondono a un messaggio in un thread

​

Correlati

• Panoramica dei canali - tutti i canali supportati
• Abbinamento - autenticazione DM e flusso di abbinamento
• Gruppi - comportamento delle chat di gruppo e filtro sulle menzioni
• Instradamento dei canali - instradamento delle sessioni per i messaggi
• Sicurezza - modello di accesso e hardening