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.

​

Hızlı başlangıç

openclaw channels login --channel feishu

openclaw gateway restart

​

Erişim denetimi

​

Doğrudan mesajlar

• "pairing" - bilinmeyen kullanıcılar bir eşleştirme kodu alır; CLI üzerinden onaylayın
• "allowlist" - yalnızca allowFrom içinde listelenen kullanıcılar sohbet edebilir (varsayılan: yalnızca bot sahibi)
• "open" - yalnızca allowFrom "*" içerdiğinde herkese açık DM’lere izin verir; kısıtlayıcı girdilerle yalnızca eşleşen kullanıcılar sohbet edebilir
• "disabled" - tüm DM’leri devre dışı bırakır

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Grup sohbetleri

• true - @mention gerektirir (varsayılan)
• false - @mention olmadan yanıt verir
• Grup başına geçersiz kılma: channels.feishu.groups.<chat_id>.requireMention
• Yalnızca yayın amaçlı @all ve @_all, bot bahsetmeleri olarak değerlendirilmez. Hem @all hem de doğrudan bottan bahseden bir mesaj yine de bot bahsetmesi sayılır.

​

Grup yapılandırma örnekleri

​

Tüm gruplara izin ver, @mention gerekmesin

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

​

Tüm gruplara izin ver, yine de @mention gerektir

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

​

Yalnızca belirli gruplara izin ver

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

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

​

Bir grup içindeki göndericileri kısıtla

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

​

Grup/kullanıcı kimliklerini alın

​

Grup kimlikleri (chat_id, biçim: oc_xxx)

​

Kullanıcı kimlikleri (open_id, biçim: ou_xxx)

openclaw logs --follow

openclaw pairing list feishu

​

Yaygın komutlar

​

Sorun giderme

​

Bot grup sohbetlerinde yanıt vermiyor

1. Botun gruba eklendiğinden emin olun
2. Bottan @mention ile bahsettiğinizden emin olun (varsayılan olarak gerekir)
3. groupPolicy değerinin "disabled" olmadığını doğrulayın
4. Günlükleri kontrol edin: openclaw logs --follow

​

Bot mesaj almıyor

1. Botun Feishu Open Platform / Lark Developer’da yayımlandığından ve onaylandığından emin olun
2. Olay aboneliğinin im.message.receive_v1 içerdiğinden emin olun
3. Kalıcı bağlantı (WebSocket) seçili olduğundan emin olun
4. Gerekli tüm izin kapsamlarının verildiğinden emin olun
5. Gateway’in çalıştığından emin olun: openclaw gateway status
6. Günlükleri kontrol edin: openclaw logs --follow

​

QR kurulumu Feishu mobil uygulamasında tepki vermiyor

1. Kurulumu yeniden çalıştırın: openclaw channels login --channel feishu
2. Manuel kurulumu seçin
3. Feishu Open Platform’da kendi oluşturduğunuz bir uygulama oluşturun ve App ID ile App Secret değerlerini kopyalayın
4. Bu kimlik bilgilerini kurulum sihirbazına yapıştırın

​

App Secret sızdırıldı

1. Feishu Open Platform / Lark Developer’da App Secret değerini sıfırlayın
2. Yapılandırmanızdaki değeri güncelleyin
3. Gateway’i yeniden başlatın: openclaw gateway restart

​

Gelişmiş yapılandırma

​

Birden çok hesap

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

​

Mesaj sınırları

• textChunkLimit - giden metin parçası boyutu (varsayılan: 2000 karakter)
• mediaMaxMb - medya yükleme/indirme sınırı (varsayılan: 30 MB)

​

Akış

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

​

Kota optimizasyonu

• typingIndicator (varsayılan true): yazıyor tepkisi çağrılarını atlamak için false ayarlayın
• resolveSenderNames (varsayılan true): gönderen profil sorgularını atlamak için false ayarlayın

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

​

ACP oturumları

​

Kalıcı ACP bağlaması

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

​

Sohbetten ACP başlat

/acp spawn codex --thread here

​

Çok ajanlı yönlendirme

{
  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) veya "group" (grup sohbeti)
• match.peer.id: kullanıcı Open ID’si (ou_xxx) veya grup kimliği (oc_xxx)

​

Yapılandırma başvurusu

​

Desteklenen mesaj türleri

​

Alma

• ✅ Metin
• ✅ Zengin metin (post)
• ✅ Görseller
• ✅ Dosyalar
• ✅ Ses
• ✅ Video/medya
• ✅ Çıkartmalar

​

Gönderme

• ✅ Metin
• ✅ Görseller
• ✅ Dosyalar
• ✅ Ses
• ✅ Video/medya
• ✅ Etkileşimli kartlar (akış güncellemeleri dahil)
• ⚠️ Zengin metin (post tarzı biçimlendirme; tüm Feishu/Lark yazma yeteneklerini desteklemez)

​

Konular ve yanıtlar

• ✅ Satır içi yanıtlar
• ✅ Konu yanıtları
• ✅ Bir konu mesajına yanıt verirken medya yanıtları konu farkındalığını korur

​

İlgili

• Kanallara Genel Bakış - desteklenen tüm kanallar
• Eşleştirme - DM kimlik doğrulaması ve eşleştirme akışı
• Gruplar - grup sohbeti davranışı ve bahsetme kapısı
• Kanal Yönlendirme - mesajlar için oturum yönlendirme
• Güvenlik - erişim modeli ve sağlamlaştırma