Feishu

Feishu/Lark, ekiplerin sohbet ettiği, belge paylaştığı, takvimleri yönettiği ve işleri birlikte tamamladığı hepsi bir arada bir iş birliği platformudur.

Durum: bot DM’leri + grup sohbetleri için üretime hazır. Varsayılan mod WebSocket’tir; Webhook modu isteğe bağlıdır.

Hızlı başlangıç

openclaw channels login --channel feishu

openclaw gateway restart

Erişim denetimi

Doğrudan mesajlar

Bota kimlerin DM gönderebileceğini denetlemek için dmPolicy yapılandırın:

• "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

Bir eşleştirme isteğini onaylayın:

openclaw pairing list feishuopenclaw pairing approve feishu <CODE>

Grup sohbetleri

Grup politikası (channels.feishu.groupPolicy):

Varsayılan: allowlist

Bahsetme gereksinimi (channels.feishu.requireMention):

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

allowlist modunda, açık bir groups.<chat_id> girdisi ekleyerek bir grubu da kabul edebilirsiniz. Açık girdiler groupPolicy: "disabled" değerini geçersiz kılmaz. groups.* altındaki joker karakter varsayılanları eşleşen grupları yapılandırır, ancak grupları tek başına kabul etmez.

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

Grubu Feishu/Lark içinde açın, sağ üst köşedeki menü simgesine tıklayın ve Ayarlar’a gidin. Grup kimliği (chat_id) ayarlar sayfasında listelenir.

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

Gateway’i başlatın, bota bir DM gönderin, ardından günlükleri kontrol edin:

openclaw logs --follow

Günlük çıktısında open_id arayın. Bekleyen eşleştirme isteklerini de kontrol edebilirsiniz:

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

defaultAccount, giden API’ler bir accountId belirtmediğinde hangi hesabın kullanılacağını denetler. accounts.<id>.tts, messages.tts ile aynı biçimi kullanır ve global TTS yapılandırmasının üzerine derin birleştirme uygular; böylece çok botlu Feishu kurulumları, yalnızca ses, model, persona veya otomatik modu hesap başına geçersiz kılarken paylaşılan sağlayıcı kimlik bilgilerini global olarak tutabilir.

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ış

Feishu/Lark, etkileşimli kartlar aracılığıyla akış yanıtlarını destekler. Etkinleştirildiğinde, bot metin üretirken kartı gerçek zamanlı olarak günceller.

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

Tam yanıtı tek mesajda göndermek için streaming: false ayarlayın. blockStreaming varsayılan olarak kapalıdır; yalnızca tamamlanmış asistan bloklarının son yanıttan önce gönderilmesini istediğinizde etkinleştirin.

Kota optimizasyonu

İki isteğe bağlı bayrakla Feishu/Lark API çağrılarının sayısını azaltın:

• 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ı

Feishu/Lark, DM’ler ve grup konu mesajları için ACP’yi destekler. Feishu/Lark ACP metin komutu odaklıdır; yerel slash komut menüleri yoktur, bu yüzden /acp ... mesajlarını doğrudan konuşmada kullanın.

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

Bir Feishu/Lark DM’sinde veya konusunda:

/acp spawn codex --thread here

--thread here, DM’ler ve Feishu/Lark konu mesajları için çalışır. Bağlı konuşmadaki takip mesajları doğrudan bu ACP oturumuna yönlendirilir.

Çok ajanlı yönlendirme

Feishu/Lark DM’lerini veya gruplarını farklı ajanlara yönlendirmek için bindings kullanın.

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

Yönlendirme alanları:

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

Arama ipuçları için Grup/kullanıcı kimliklerini alın bölümüne bakın.

Yapılandırma başvurusu

Tam yapılandırma: Gateway yapılandırması

Desteklenen mesaj türleri

Alma

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

Gelen Feishu/Lark ses mesajları, ham file_key JSON yerine medya yer tutucuları olarak normalleştirilir. tools.media.audio yapılandırıldığında OpenClaw, sesli not kaynağını indirir ve aracı turundan önce paylaşılan ses deşifresini çalıştırır; böylece aracı konuşulan deşifre metnini alır. Feishu, ses yükünde deşifre metnini doğrudan içeriyorsa bu metin başka bir ASR çağrısı yapılmadan kullanılır. Ses deşifresi sağlayıcısı olmadan da aracı, ham Feishu kaynak yükü yerine bir <media:audio> yer tutucusu ve kaydedilmiş eki alır.

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)

Yerel Feishu/Lark ses balonları, Feishu audio mesaj türünü kullanır ve Ogg/Opus yükleme medyası (file_type: "opus") gerektirir. Mevcut .opus ve .ogg medyaları doğrudan yerel ses olarak gönderilir. MP3/WAV/M4A ve diğer olası ses biçimleri, yalnızca yanıt sesli teslimat istediğinde (audioAsVoice / mesaj aracı asVoice, TTS sesli not yanıtları dahil) ffmpeg ile 48kHz Ogg/Opus biçimine dönüştürülür. Sıradan MP3 ekleri normal dosya olarak kalır. ffmpeg eksikse veya dönüşüm başarısız olursa OpenClaw dosya ekine geri döner ve nedeni günlüğe kaydeder.

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

groupSessionScope: "group_topic" ve "group_topic_sender" için yerel Feishu/Lark konu grupları, olaydaki thread_id değerini (omt_*) kanonik konu oturumu anahtarı olarak kullanır. Yerel bir konu başlatıcı olayı thread_id içermezse OpenClaw, turu yönlendirmeden önce bunu Feishu'dan doldurur. OpenClaw'ın konulara dönüştürdüğü normal grup yanıtları, ilk tur ve takip turu aynı oturumda kalsın diye yanıt kök mesaj kimliğini (om_*) kullanmaya devam eder.

İ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