Feishu botu

Feishu (Lark), şirketler tarafından mesajlaşma ve iş birliği için kullanılan bir ekip sohbet platformudur. Bu eklenti, OpenClaw’u platformun WebSocket olay aboneliğini kullanarak bir Feishu/Lark botuna bağlar; böylece herkese açık bir webhook URL’si açmadan mesajlar alınabilir.

Gerekli eklenti

Feishu eklentisini yükleyin:

openclaw plugins install @openclaw/feishu

Yerel checkout (bir git deposundan çalıştırırken):

openclaw plugins install ./extensions/feishu

Hızlı Başlangıç

Feishu kanalını eklemenin iki yolu vardır:

Yöntem 1: onboarding sihirbazı (önerilen)

OpenClaw’u yeni kurduysanız sihirbazı çalıştırın:

openclaw onboard

Sihirbaz sizi şu adımlarda yönlendirir:

Bir Feishu uygulaması oluşturma ve kimlik bilgilerini toplama
Uygulama kimlik bilgilerini OpenClaw’da yapılandırma
Gateway’i başlatma

✅ Yapılandırmadan sonra, gateway durumunu kontrol edin:

openclaw gateway status
openclaw logs --follow

Yöntem 2: CLI ile kurulum

İlk kurulumu zaten tamamladıysanız, kanalı CLI üzerinden ekleyin:

openclaw channels add

Feishu’yu seçin, ardından App ID ve App Secret’ı girin. ✅ Yapılandırmadan sonra, gateway’i yönetin:

openclaw gateway status
openclaw gateway restart
openclaw logs --follow

Adım 1: Bir Feishu uygulaması oluşturun

1. Feishu Open Platform’u açın

Feishu Open Platform adresini ziyaret edin ve oturum açın. Lark (küresel) kiracıları https://open.larksuite.com/app adresini kullanmalı ve Feishu yapılandırmasında domain: "lark" ayarını yapmalıdır.

2. Bir uygulama oluşturun

Create enterprise app’e tıklayın
Uygulama adı ve açıklamasını doldurun
Bir uygulama simgesi seçin

3. Kimlik bilgilerini kopyalayın

Credentials & Basic Info bölümünden şunları kopyalayın:

Uygulama Kimliği (biçim: cli_xxx)
App Secret

❗ Önemli: App Secret’ı gizli tutun. Get credentials

4. İzinleri yapılandırın

Permissions bölümünde Batch import’a tıklayın ve şunu yapıştırın:

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

5. Bot yeteneğini etkinleştirin

App Capability > Bot bölümünde:

Bot yeteneğini etkinleştirin
Bot adını ayarlayın

6. Olay aboneliğini yapılandırın

⚠️ Önemli: olay aboneliğini ayarlamadan önce şunlardan emin olun:

Feishu için openclaw channels add komutunu zaten çalıştırdınız
Gateway çalışıyor (openclaw gateway status)

Event Subscription bölümünde:

Use long connection to receive events (WebSocket) seçeneğini seçin
Şu olayı ekleyin: im.message.receive_v1

⚠️ Gateway çalışmıyorsa, uzun bağlantı ayarları kaydedilemeyebilir. Configure event subscription

7. Uygulamayı yayınlayın

Version Management & Release bölümünde bir sürüm oluşturun
İncelemeye gönderin ve yayınlayın
Yönetici onayını bekleyin (kurumsal uygulamalar genellikle otomatik onaylanır)

Adım 2: OpenClaw’u yapılandırın

Sihirbaz ile yapılandırma (önerilen)

openclaw channels add

Feishu’yu seçin ve App ID ile App Secret’ı yapıştırın.

Yapılandırma dosyası ile yapılandırma

~/.openclaw/openclaw.json dosyasını düzenleyin:

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "My AI assistant",
        },
      },
    },
  },
}

Ortam değişkenleri aracılığıyla yapılandırma

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

Lark (küresel) alan adı

Kiracınız Lark (uluslararası) üzerindeyse alan adını lark (veya tam bir alan adı dizesi) olarak ayarlayın. Bunu channels.feishu.domain konumunda ya da hesap bazında (channels.feishu.accounts.<id>.domain) ayarlayabilirsiniz.

{
  channels: {
    feishu: {
      domain: "lark",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
        },
      },
    },
  },
}

Adım 3: Başlatma + test

1. Gateway’i başlatın

openclaw gateway

2. Test mesajı gönderin

Feishu’da botunuzu bulun ve bir mesaj gönderin.

3. Eşleştirmeyi onaylayın

Varsayılan olarak bot bir eşleştirme kodu ile yanıt verir. Onaylayın:

openclaw pairing approve feishu <CODE>

Onaydan sonra normal şekilde sohbet edebilirsiniz.

Genel bakış

Feishu bot kanalı: Gateway tarafından yönetilen Feishu botu
Deterministik yönlendirme: yanıtlar her zaman Feishu’ya döner
Oturum yalıtımı: DM’ler ana bir oturumu paylaşır; gruplar yalıtılmıştır
WebSocket bağlantısı: Feishu SDK üzerinden uzun bağlantı, herkese açık URL gerekmez

Erişim denetimi

Doğrudan mesajlar

Varsayılan: dmPolicy: "pairing" (bilinmeyen kullanıcılar eşleştirme kodu alır)

Eşleştirmeyi onayla:

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

İzin listesi modu: izin verilen Open ID’lerle channels.feishu.allowFrom ayarlayın

Grup sohbetleri

1. Grup politikası (channels.feishu.groupPolicy):

"open" = gruplarda herkese izin ver (varsayılan)
"allowlist" = yalnızca groupAllowFrom’e izin ver
"disabled" = grup mesajlarını devre dışı bırak

2. Bahsetme gereksinimi (channels.feishu.groups.<chat_id>.requireMention):

true = @bahsetme zorunlu (varsayılan)
false = bahsetme olmadan yanıtla

Grup yapılandırma örnekleri

Tüm gruplara izin ver, @bahsetme zorunlu (varsayılan)

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

Tüm gruplara izin ver, @bahsetme gerekmez

{
  channels: {
    feishu: {
      groups: {
        oc_xxx: { requireMention: false },
      },
    },
  },
}

Yalnızca gruplarda belirli kullanıcılara izin ver

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["ou_xxx", "ou_yyy"],
    },
  },
}

Grup/kullanıcı ID’lerini alma

Grup ID’leri (chat_id)

Grup ID’leri oc_xxx biçimindedir. Yöntem 1 (önerilen)

Gateway’i başlatın ve grupta botu @bahsedin
openclaw logs --follow komutunu çalıştırın ve chat_id değerini bulun

Yöntem 2 Feishu API hata ayıklayıcısını kullanarak grup sohbetlerini listeleyin.

Kullanıcı ID’leri (open_id)

Kullanıcı ID’leri ou_xxx biçimindedir. Yöntem 1 (önerilen)

Gateway’i başlatın ve bota DM gönderin
openclaw logs --follow komutunu çalıştırın ve open_id değerini bulun

Yöntem 2 Eşleştirme isteklerinden kullanıcı Open ID’lerini kontrol edin:

openclaw pairing list feishu

Yaygın komutlar

Command	Açıklama
`/status`	Bot durumunu göster
`/reset`	Reset the session
`/model`	Modeli göster/değiştir

Not: Feishu henüz yerel komut menülerini desteklemediğinden, komutlar metin olarak gönderilmelidir.

Gateway yönetim komutları

Command	Açıklama
`openclaw gateway status`	Gateway durumunu göster
`openclaw gateway install`	Gateway servisini yükle/başlat
`openclaw gateway stop`	Gateway servisini durdur
`openclaw gateway restart`	Gateway servisini yeniden başlat
`openclaw logs --follow`	Tail gateway logs

Sorun Giderme

Bot grup sohbetlerinde yanıt vermiyor

Botun gruba eklendiğinden emin olun
Botu @bahsettiğinizden emin olun (varsayılan davranış)
groupPolicy’nin "disabled" olarak ayarlanmadığını kontrol edin
Günlükleri kontrol edin: openclaw logs --follow

Bot mesaj almıyor

Uygulamanın yayınlandığından ve onaylandığından emin olun
Olay aboneliğinin im.message.receive_v1 içerdiğinden emin olun
Uzun bağlantının etkin olduğundan emin olun
Uygulama izinlerinin eksiksiz olduğundan emin olun
Gateway’in çalıştığından emin olun: openclaw gateway status
Günlükleri kontrol edin: openclaw logs --follow

App Secret sızıntısı

Feishu Open Platform’da App Secret’ı sıfırlayın
Yapılandırmanızdaki App Secret’ı güncelleyin
Gateway’i yeniden başlatın

Mesaj gönderme hataları

Uygulamanın im:message:send_as_bot iznine sahip olduğundan emin olun
Uygulamanın yayınlandığından emin olun
Ayrıntılı hatalar için günlükleri kontrol edin

Gelişmiş yapılandırma

Birden fazla hesap

{
  channels: {
    feishu: {
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "Primary bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          botName: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

Mesaj limitleri

textChunkLimit: giden metin parça boyutu (varsayılan: 2000 karakter)
mediaMaxMb: medya yükleme/indirme limiti (varsayılan: 30MB)

Akış (Streaming)

Feishu, etkileşimli kartlar üzerinden akış yanıtlarını destekler. Etkinleştirildiğinde bot, metin üretirken bir kartı günceller.

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

Tam yanıt gönderilmeden önce beklemek için streaming: false ayarını yapın.

Multi-agent routing

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

{
  agents: {
    list: [
      { id: "main" },
      {
        id: "clawd-fan",
        workspace: "/home/user/clawd-fan",
        agentDir: "/home/user/.openclaw/agents/clawd-fan/agent",
      },
      {
        id: "clawd-xi",
        workspace: "/home/user/clawd-xi",
        agentDir: "/home/user/.openclaw/agents/clawd-xi/agent",
      },
    ],
  },
  bindings: [
    {
      agentId: "main",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "clawd-fan",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_yyy" },
      },
    },
    {
      agentId: "clawd-xi",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

Yönlendirme alanları:

match.channel: "feishu"
match.peer.kind: "direct" veya "group"
match.peer.id: kullanıcı Open ID’si (ou_xxx) veya grup ID’si (oc_xxx)

Arama ipuçları için Grup/kullanıcı ID’lerini alma bölümüne bakın.

Yapılandırma başvurusu

Tüm yapılandırma: Gateway yapılandırması Temel seçenekler:

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.accounts.<id>.appId`	App ID	-
`channels.feishu.accounts.<id>.appSecret`	App Secret	-
`channels.feishu.accounts.<id>.domain`	Per-account API domain override	`feishu`
`channels.feishu.dmPolicy`	DM politikası	`pairing`
`channels.feishu.allowFrom`	DM izin listesi (open_id listesi)	-
`channels.feishu.groupPolicy`	Grup politikası	`open`
`channels.feishu.groupAllowFrom`	Grup izin listesi	-
`channels.feishu.groups.<chat_id>.requireMention`	@bahsetme zorunlu	`true`
`channels.feishu.groups.<chat_id>.enabled`	Grubu etkinleştir	`true`
`channels.feishu.textChunkLimit`	Mesaj parça boyutu	`2000`
`channels.feishu.mediaMaxMb`	Medya boyut limiti	`30`
`channels.feishu.streaming`	Akış kartı çıktısını etkinleştir	`true`
`channels.feishu.blockStreaming`	Blok halinde akışı etkinleştir	`true`

dmPolicy başvurusu

Değer	Davranış
`"pairing"`	Varsayılan. Bilinmeyen kullanıcılar eşleştirme kodu alır; onaylanmalıdır
`"allowlist"`	Yalnızca `allowFrom` içindeki kullanıcılar sohbet edebilir
`"open"`	Tüm kullanıcılara izin ver (allowFrom içinde `"*"` gerektirir)
`"disabled"`	DM’leri devre dışı bırak

Desteklenen mesaj türleri

Receive

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

Gönderme

✅ Metin
✅ Görseller
✅ Dosyalar
✅ Ses
⚠️ Zengin metin (kısmi destek)

​Feishu botu

​Gerekli eklenti

​Hızlı Başlangıç

​Yöntem 1: onboarding sihirbazı (önerilen)

​Yöntem 2: CLI ile kurulum

​Adım 1: Bir Feishu uygulaması oluşturun

​1. Feishu Open Platform’u açın

​2. Bir uygulama oluşturun

​3. Kimlik bilgilerini kopyalayın

​4. İzinleri yapılandırın

​5. Bot yeteneğini etkinleştirin

​6. Olay aboneliğini yapılandırın

​7. Uygulamayı yayınlayın

​Adım 2: OpenClaw’u yapılandırın

​Sihirbaz ile yapılandırma (önerilen)

​Yapılandırma dosyası ile yapılandırma

​Ortam değişkenleri aracılığıyla yapılandırma

​Lark (küresel) alan adı

​Adım 3: Başlatma + test

​1. Gateway’i başlatın

​2. Test mesajı gönderin

​3. Eşleştirmeyi onaylayın

​Genel bakış

​Erişim denetimi

​Doğrudan mesajlar

​Grup sohbetleri

​Grup yapılandırma örnekleri

​Tüm gruplara izin ver, @bahsetme zorunlu (varsayılan)

​Tüm gruplara izin ver, @bahsetme gerekmez

​Yalnızca gruplarda belirli kullanıcılara izin ver

​Grup/kullanıcı ID’lerini alma

​Grup ID’leri (chat_id)

​Kullanıcı ID’leri (open_id)

​Yaygın komutlar

​Gateway yönetim komutları

​Sorun Giderme

​Bot grup sohbetlerinde yanıt vermiyor

​Bot mesaj almıyor

​App Secret sızıntısı

​Mesaj gönderme hataları

​Gelişmiş yapılandırma

​Birden fazla hesap

​Mesaj limitleri

​Akış (Streaming)

​Multi-agent routing

​Yapılandırma başvurusu

​dmPolicy başvurusu

​Desteklenen mesaj türleri

​Receive

​Gönderme