--- read_when: - Bir Feishu/Lark botu bağlamak istiyorsunuz - Feishu kanalını yapılandırıyorsunuz summary: Feishu botuna genel bakış, özellikler ve yapılandırma title: Feishu x-i18n: generated_at: "2026-05-11T20:20:31Z" model: gpt-5.5 provider: openai source_hash: 8d4e43c65072d44cb5973a1ed09cb5336f18d100d0cb5b43c5e31f37aecff329 source_path: channels/feishu.md workflow: 16 --- 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 2026.4.25 veya üzeri gerekir. Kontrol etmek için `openclaw --version` çalıştırın. `openclaw update` ile yükseltin. ```bash openclaw channels login --channel feishu ``` Feishu Open Platform’dan bir App ID ve App Secret yapıştırmak için manuel kurulumu seçin veya otomatik olarak bot oluşturmak için QR kurulumunu seçin. Yerel Feishu mobil uygulaması QR koda tepki vermiyorsa kurulumu yeniden çalıştırın ve manuel kurulumu seçin. ```bash 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:** ```bash openclaw pairing list feishu openclaw pairing approve feishu ``` ### Grup sohbetleri **Grup politikası** (`channels.feishu.groupPolicy`): | Değer | Davranış | | ------------- | -------------------------------------------------------------------------------------------- | | `"open"` | Gruplardaki tüm mesajlara yanıt verir | | `"allowlist"` | Yalnızca `groupAllowFrom` içindeki veya `groups.` altında açıkça yapılandırılmış gruplara yanıt verir | | `"disabled"` | Tüm grup mesajlarını devre dışı bırakır; açık `groups.` girdileri bunu geçersiz kılmaz | 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..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 ```json5 { channels: { feishu: { groupPolicy: "open", }, }, } ``` ### Tüm gruplara izin ver, yine de @mention gerektir ```json5 { channels: { feishu: { groupPolicy: "open", requireMention: true, }, }, } ``` ### Yalnızca belirli gruplara izin ver ```json5 { channels: { feishu: { groupPolicy: "allowlist", // Group IDs look like: oc_xxx groupAllowFrom: ["oc_xxx", "oc_yyy"], }, }, } ``` `allowlist` modunda, açık bir `groups.` 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. ```json5 { channels: { feishu: { groupPolicy: "allowlist", groups: { oc_xxx: { requireMention: false, }, }, }, }, } ``` ### Bir grup içindeki göndericileri kısıtla ```json5 { 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. ![Grup Kimliğini Al](/images/feishu-get-group-id.png) ### 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: ```bash openclaw logs --follow ``` Günlük çıktısında `open_id` arayın. Bekleyen eşleştirme isteklerini de kontrol edebilirsiniz: ```bash openclaw pairing list feishu ``` --- ## Yaygın komutlar | Komut | Açıklama | | --------- | --------------------------- | | `/status` | Bot durumunu göster | | `/reset` | Geçerli oturumu sıfırla | | `/model` | AI modelini göster veya değiştir | Feishu/Lark yerel slash komut menülerini desteklemez, bu yüzden bunları düz metin mesajları olarak gönderin. --- ## 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 ```json5 { 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..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. ```json5 { 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 ```json5 { 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ı ```json5 { 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: ```text /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. ```json5 { 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](#get-groupuser-ids) bölümüne bakın. --- ## Yapılandırma başvurusu Tam yapılandırma: [Gateway yapılandırması](/tr/gateway/configuration) | Ayar | Açıklama | Varsayılan | | ------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------- | | `channels.feishu.enabled` | Kanalı etkinleştir/devre dışı bırak | `true` | | `channels.feishu.domain` | API etki alanı (`feishu` veya `lark`) | `feishu` | | `channels.feishu.connectionMode` | Olay aktarımı (`websocket` veya `webhook`) | `websocket` | | `channels.feishu.defaultAccount` | Giden yönlendirme için varsayılan hesap | `default` | | `channels.feishu.verificationToken` | Webhook modu için zorunlu | - | | `channels.feishu.encryptKey` | Webhook modu için zorunlu | - | | `channels.feishu.webhookPath` | Webhook rota yolu | `/feishu/events` | | `channels.feishu.webhookHost` | Webhook bağlama ana makinesi | `127.0.0.1` | | `channels.feishu.webhookPort` | Webhook bağlama bağlantı noktası | `3000` | | `channels.feishu.accounts..appId` | Uygulama kimliği | - | | `channels.feishu.accounts..appSecret` | Uygulama sırrı | - | | `channels.feishu.accounts..domain` | Hesap başına etki alanı geçersiz kılması | `feishu` | | `channels.feishu.accounts..tts` | Hesap başına TTS geçersiz kılması | `messages.tts` | | `channels.feishu.dmPolicy` | DM ilkesi | `allowlist` | | `channels.feishu.allowFrom` | DM izin listesi (`open_id` listesi) | [BotOwnerId] | | `channels.feishu.groupPolicy` | Grup ilkesi | `allowlist` | | `channels.feishu.groupAllowFrom` | Grup izin listesi | - | | `channels.feishu.requireMention` | Gruplarda @bahsetme gerektir | `true` | | `channels.feishu.groups..requireMention` | Grup başına @bahsetme geçersiz kılması; açık kimlikler grubu izin listesi modunda da kabul eder | devralınan | | `channels.feishu.groups..enabled` | Belirli bir grubu etkinleştir/devre dışı bırak | `true` | | `channels.feishu.textChunkLimit` | Mesaj parçası boyutu | `2000` | | `channels.feishu.mediaMaxMb` | Medya boyutu sınırı | `30` | | `channels.feishu.streaming` | Akış kartı çıktısı | `true` | | `channels.feishu.blockStreaming` | Tamamlanmış blok yanıt akışı | `false` | | `channels.feishu.typingIndicator` | Yazıyor tepkileri gönder | `true` | | `channels.feishu.resolveSenderNames` | Gönderen görünen adlarını çözümle | `true` | --- ## 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 `` 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ış](/tr/channels) - desteklenen tüm kanallar - [Eşleştirme](/tr/channels/pairing) - DM kimlik doğrulaması ve eşleştirme akışı - [Gruplar](/tr/channels/groups) - grup sohbeti davranışı ve bahsetme kapısı - [Kanal Yönlendirme](/tr/channels/channel-routing) - mesajlar için oturum yönlendirme - [Güvenlik](/tr/gateway/security) - erişim modeli ve sağlamlaştırma