Feishu

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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 (predefinito: solo proprietario del bot)
• "open" - consenti DM pubblici solo quando allowFrom include "*"; con voci restrittive, solo gli utenti corrispondenti possono chattare
• "disabled" - disabilita tutti i DM

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Chat di gruppo

• true - richiede @mention (predefinito)
• false - risponde senza @mention
• Override per gruppo: channels.feishu.groups.<chat_id>.requireMention
• Gli @all e @_all solo broadcast non sono 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, senza @mention richiesta

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

​

Consenti tutti i gruppi, richiedi comunque @mention

{
  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 gli ID 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 @mention 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 agli 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 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 suo 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

​

Più account

{
  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/download 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 del profilo del mittente

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

​

Genera 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)

​

Riferimento di configurazione

​

Tipi di messaggio supportati

​

Ricezione

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

​

Invio

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

​

Thread e risposte

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

​

Correlati

• Panoramica dei canali - tutti i canali supportati
• Associazione - autenticazione DM e flusso di associazione
• Gruppi - comportamento della chat di gruppo e gating delle menzioni
• Routing dei canali - routing della sessione per i messaggi
• Sicurezza - modello di accesso e rafforzamento