Feishu / Lark

Feishu/Lark, ekiplerin sohbet ettiği, belgeleri paylaştığı, takvimleri yönettiği ve birlikte iş yaptığı hepsi bir arada bir iş birliği platformudur. Durum: bot DM’leri ve 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.10 veya üstünü gerektirir. Kontrol etmek için openclaw --version çalıştırın. openclaw update ile yükseltin.

Kanal kurulum sihirbazını çalıştırın

openclaw channels login --channel feishu

Otomatik olarak bir Feishu/Lark botu oluşturmak için QR kodunu Feishu/Lark mobil uygulamanızla tarayın.

Kurulum tamamlandıktan sonra, değişiklikleri uygulamak için Gateway'i yeniden başlatın

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" — tüm kullanıcılara izin ver
"disabled" — tüm DM’leri devre dışı bırak

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

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

Grup sohbetleri

Grup ilkesi (channels.feishu.groupPolicy):

Değer	Davranış
`"open"`	Gruplardaki tüm mesajlara yanıt ver
`"allowlist"`	Yalnızca `groupAllowFrom` içindeki gruplara yanıt ver
`"disabled"`	Tüm grup mesajlarını devre dışı bırak

Varsayılan: allowlist Bahsetme gereksinimi (channels.feishu.requireMention):

true — @mention gerekli (varsayılan)
false — @mention olmadan yanıt ver
Grup başına geçersiz kılma: channels.feishu.groups.<chat_id>.requireMention

Grup yapılandırma örnekleri

Tüm gruplara izin ver, @mention gerekmesin

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

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

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

Yalnızca belirli gruplara izin ver

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Grup kimlikleri şu biçimdedir: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

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

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Kullanıcı open_id'leri şu biçimdedir: 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 Settings bölümüne 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 değerini arayın. Bekleyen eşleştirme isteklerini de kontrol edebilirsiniz:

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-command menülerini desteklemez, bu nedenle bunları düz metin mesajları olarak gönderin.

Sorun giderme

Bot grup sohbetlerinde yanıt vermiyor

Botun gruba eklendiğinden emin olun
Bota @mention yaptığınızdan emin olun (varsayılan olarak gereklidir)
groupPolicy değerinin "disabled" olmadığını doğrulayın
Günlükleri kontrol edin: openclaw logs --follow

Bot mesaj almıyor

Botun Feishu Open Platform / Lark Developer içinde yayımlandığından ve onaylandığından emin olun
Olay aboneliğinin im.message.receive_v1 içerdiğinden emin olun
persistent connection (WebSocket) seçildiğinden emin olun
Gerekli tüm izin kapsamlarının verildiğinden emin olun
Gateway’in çalıştığından emin olun: openclaw gateway status
Günlükleri kontrol edin: openclaw logs --follow

App Secret sızdı

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

Gelişmiş yapılandırma

Birden fazla hesap

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Birincil bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Yedek bot",
          enabled: false,
        },
      },
    },
  },
}

defaultAccount, giden API’ler accountId belirtmediğinde hangi hesabın kullanılacağını denetler.

Mesaj sınırları

textChunkLimit — giden metin parça 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, // akış kartı çıktısını etkinleştir (varsayılan: true)
      blockStreaming: true, // blok düzeyinde akışı etkinleştir (varsayılan: true)
    },
  },
}

Tam yanıtı tek bir mesaj olarak göndermek için streaming: false ayarlayın.

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): yazma tepkisi çağrılarını atlamak için false ayarlayın
resolveSenderNames (varsayılan true): gönderen profil aramalarını atlamak için false ayarlayın

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

ACP oturumları

Feishu/Lark, DM’ler ve grup konu başlığı mesajları için ACP’yi destekler. Feishu/Lark ACP, metin komutlarıyla çalışır — yerel slash-command menüleri yoktur, bu nedenle doğrudan konuşma içinde /acp ... mesajlarını kullanın.

Kalıcı ACP bağlama

{
  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şlatma

Bir Feishu/Lark DM’inde veya konu başlığında:

/acp spawn codex --thread here

--thread here, DM’lerde ve Feishu/Lark konu başlığı mesajlarında çalışır. Bağlı konuşmadaki takip mesajları doğrudan o ACP oturumuna yönlendirilir.

Çoklu aracı yönlendirme

Feishu/Lark DM’lerini veya gruplarını farklı aracılara 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 configuration

Ayar	Açıklama	Varsayılan
`channels.feishu.enabled`	Kanalı etkinleştir/devre dışı bırak	`true`
`channels.feishu.domain`	API alan adı (`feishu` veya `lark`)	`feishu`
`channels.feishu.connectionMode`	Olay taşıma yöntemi (`websocket` veya `webhook`)	`websocket`
`channels.feishu.defaultAccount`	Giden yönlendirme için varsayılan hesap	`default`
`channels.feishu.verificationToken`	Webhook modu için gereklidir	—
`channels.feishu.encryptKey`	Webhook modu için gereklidir	—
`channels.feishu.webhookPath`	Webhook rota yolu	`/feishu/events`
`channels.feishu.webhookHost`	Webhook bağlama ana bilgisayarı	`127.0.0.1`
`channels.feishu.webhookPort`	Webhook bağlama bağlantı noktası	`3000`
`channels.feishu.accounts.<id>.appId`	App ID	—
`channels.feishu.accounts.<id>.appSecret`	App Secret	—
`channels.feishu.accounts.<id>.domain`	Hesap başına alan adı geçersiz kılması	`feishu`
`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 @mention gerektir	`true`
`channels.feishu.groups.<chat_id>.requireMention`	Grup başına @mention geçersiz kılması	inherited
`channels.feishu.groups.<chat_id>.enabled`	Belirli bir grubu etkinleştir/devre dışı bırak	`true`
`channels.feishu.textChunkLimit`	Mesaj parça boyutu	`2000`
`channels.feishu.mediaMaxMb`	Medya boyut sınırı	`30`
`channels.feishu.streaming`	Akış kartı çıktısı	`true`
`channels.feishu.blockStreaming`	Blok düzeyinde akış	`true`
`channels.feishu.typingIndicator`	Yazma 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

Gönderme

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

Konu başlıkları ve yanıtlar

✅ Satır içi yanıtlar
✅ Konu başlığı yanıtları
✅ Medya yanıtları, bir konu başlığı mesajına yanıt verirken konu başlığı 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 denetimi
Kanal Yönlendirme — mesajlar için oturum yönlendirmesi
Güvenlik — erişim modeli ve sağlamlaştırma

Overview

Messaging platforms

Configuration

Feishu

Feishu / Lark

Hızlı başlangıç

Erişim denetimi

Doğrudan mesajlar

Grup sohbetleri

Grup yapılandırma örnekleri

Tüm gruplara izin ver, @mention gerekmesin

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

Yalnızca belirli gruplara izin ver

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

Grup/kullanıcı kimliklerini alın

Grup kimlikleri (`chat_id`, biçim: `oc_xxx`)

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

Yaygın komutlar

Sorun giderme

Bot grup sohbetlerinde yanıt vermiyor

Bot mesaj almıyor

App Secret sızdı

Gelişmiş yapılandırma

Birden fazla hesap

Mesaj sınırları

Akış

Kota optimizasyonu

ACP oturumları

Kalıcı ACP bağlama

Sohbetten ACP başlatma

Çoklu aracı yönlendirme

Yapılandırma başvurusu

Desteklenen mesaj türleri

Alma

Gönderme

Konu başlıkları ve yanıtlar

İlgili

Overview

Messaging platforms

Configuration

​Feishu / Lark

​Hızlı başlangıç

​Erişim denetimi

​Doğrudan mesajlar

​Grup sohbetleri

​Grup yapılandırma örnekleri

​Tüm gruplara izin ver, @mention gerekmesin

​Tüm gruplara izin ver, yine de @mention gereksin

​Yalnızca belirli gruplara izin ver

​Bir grup içindeki gönderenleri kısıtla

​Grup/kullanıcı kimliklerini alın

​Grup kimlikleri (chat_id, biçim: oc_xxx)

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

​Yaygın komutlar

​Sorun giderme

​Bot grup sohbetlerinde yanıt vermiyor

​Bot mesaj almıyor

​App Secret sızdı

​Gelişmiş yapılandırma

​Birden fazla hesap

​Mesaj sınırları

​Akış

​Kota optimizasyonu

​ACP oturumları

​Kalıcı ACP bağlama

​Sohbetten ACP başlatma

​Çoklu aracı yönlendirme

​Yapılandırma başvurusu

​Desteklenen mesaj türleri

​Alma

​Gönderme

​Konu başlıkları ve yanıtlar

​İlgili

Feishu / Lark

Hızlı başlangıç

Erişim denetimi

Doğrudan mesajlar

Grup sohbetleri

Grup yapılandırma örnekleri

Tüm gruplara izin ver, @mention gerekmesin

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

Yalnızca belirli gruplara izin ver

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

Grup/kullanıcı kimliklerini alın

Grup kimlikleri (`chat_id`, biçim: `oc_xxx`)

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

Yaygın komutlar

Sorun giderme

Bot grup sohbetlerinde yanıt vermiyor

Bot mesaj almıyor

App Secret sızdı

Gelişmiş yapılandırma

Birden fazla hesap

Mesaj sınırları

Akış

Kota optimizasyonu

ACP oturumları

Kalıcı ACP bağlama

Sohbetten ACP başlatma

Çoklu aracı yönlendirme

Yapılandırma başvurusu

Desteklenen mesaj türleri

Alma

Gönderme

Konu başlıkları ve yanıtlar

İlgili