​

Feishu botu

​

Pakete dahil plugin

openclaw plugins install @openclaw/feishu

​

Hızlı başlangıç

​

Yöntem 1: onboarding (önerilir)

openclaw onboard

1. Bir Feishu uygulaması oluşturma ve kimlik bilgilerini toplama
2. Uygulama kimlik bilgilerini OpenClaw içinde yapılandırma
3. Gateway’i başlatma

• openclaw gateway status
• openclaw logs --follow

​

Yöntem 2: CLI kurulumu

openclaw channels add

• openclaw gateway status
• openclaw gateway restart
• openclaw logs --follow

​

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

​

1. Feishu Open Platform’u açın

​

2. Bir uygulama oluşturun

1. Create enterprise app öğesine tıklayın
2. Uygulama adı + açıklamasını doldurun
3. Bir uygulama simgesi seçin

​

3. Kimlik bilgilerini kopyalayın

• App ID (biçim: cli_xxx)
• App Secret

​

4. İzinleri yapılandı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",
      "cardkit:card:read",
      "cardkit:card: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

1. Bot yeteneğini etkinleştirin
2. Bot adını ayarlayın

​

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

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

1. Use long connection to receive events (WebSocket) seçeneğini belirleyin
2. Şu olayı ekleyin: im.message.receive_v1
3. (İsteğe bağlı) Drive yorum iş akışları için şunu da ekleyin: drive.notice.comment_add_v1

​

7. Uygulamayı yayımlayın

1. Version Management & Release içinde bir sürüm oluşturun
2. İnceleme için gönderin ve yayımlayın
3. Yönetici onayını bekleyin (kurumsal uygulamalar genellikle otomatik onaylanır)

​

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

​

Sihirbaz ile yapılandırın (önerilir)

openclaw channels add

​

Config dosyasıyla yapılandırın

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

​

Verification Token ve Encrypt Key (webhook modu)

1. Feishu Open Platform içinde uygulamanızı açın
2. Development → Events & Callbacks bölümüne gidin (开发配置 → 事件与回调)
3. Encryption sekmesini açın (加密策略)
4. Verification Token ve Encrypt Key değerlerini kopyalayın

​

Ortam değişkenleriyle yapılandırın

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

​

Lark (global) domain

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

​

Kota optimizasyon bayrakları

• typingIndicator (varsayılan true): false olduğunda yazıyor tepkisi çağrılarını atlar.
• resolveSenderNames (varsayılan true): false olduğunda gönderen profil arama çağrılarını atlar.

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          typingIndicator: true,
          resolveSenderNames: false,
        },
      },
    },
  },
}

​

3. Adım: Başlatın + test edin

​

1. Gateway’i başlatın

openclaw gateway

​

2. Bir test mesajı gönderin

​

3. Eşleştirmeyi onaylayın

openclaw pairing approve feishu <CODE>

​

Genel bakış

• Feishu bot kanalı: gateway tarafından yönetilen Feishu botu
• Deterministik yönlendirme: yanıtlar her zaman Feishu’ya geri döner
• Oturum yalıtımı: DM’ler bir ana oturumu paylaşır; gruplar yalıtılmıştır
• WebSocket bağlantısı: Feishu SDK üzerinden uzun bağlantı, genel 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 onaylayın:
  openclaw pairing list feishu
  openclaw pairing approve feishu <CODE>
  
• İzin listesi modu: izin verilen Open ID’lerle channels.feishu.allowFrom ayarlayın

​

Grup sohbetleri

• "open" = gruplarda herkese izin ver
• "allowlist" = yalnızca groupAllowFrom içindekilere izin ver
• "disabled" = grup mesajlarını devre dışı bırak

• açık true = @mention zorunlu
• açık false = mention olmadan yanıt ver
• ayarlanmamışsa ve groupPolicy: "open" ise = varsayılan false
• ayarlanmamışsa ve groupPolicy "open" değilse = varsayılan true

​

Grup yapılandırma örnekleri

​

Tüm gruplara izin ver, @mention gerekmesin (açık gruplar için varsayılan)

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

​

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

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

​

Yalnızca belirli gruplara izin ver

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Feishu grup kimlikleri (chat_id) şöyle görünür: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

​

Bir grupta hangi göndericilerin mesaj gönderebileceğini kısıtlayın (gönderici izin listesi)

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Feishu kullanıcı kimlikleri (open_id) şöyle görünür: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Grup/kullanıcı kimliklerini alın

​

Grup kimlikleri (chat_id)

1. Gateway’i başlatın ve grupta botu @mention ile etiketleyin
2. openclaw logs --follow çalıştırın ve chat_id değerini arayın

​

Kullanıcı kimlikleri (open_id)

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

openclaw pairing list feishu

​

Yaygın komutlar

Not: Feishu henüz yerel komut menülerini desteklemez, bu nedenle komutlar metin olarak gönderilmelidir.

​

Gateway yönetim komutları

​

Sorun giderme

​

Bot grup sohbetlerinde yanıt vermiyor

1. Botun gruba eklendiğinden emin olun
2. Botu @mention ile etiketlediğinizden emin olun (varsayılan davranış)
3. groupPolicy değerinin "disabled" olarak ayarlanmadığını kontrol edin
4. Günlükleri kontrol edin: openclaw logs --follow

​

Bot mesaj almıyor

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

​

App Secret sızıntısı

1. Feishu Open Platform içinde App Secret’ı sıfırlayın
2. Config dosyanızdaki App Secret’ı güncelleyin
3. Gateway’i yeniden başlatın

​

Mesaj gönderme hataları

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

​

Gelişmiş yapılandırma

​

Birden fazla hesap

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

​

Mesaj sınırları

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

​

Streaming

{
  channels: {
    feishu: {
      streaming: true, // kart üzerinden streaming çıktıyı etkinleştirir (varsayılan true)
      blockStreaming: true, // blok düzeyinde streaming'i etkinleştirir (varsayılan true)
    },
  },
}

​

ACP oturumları

• DM’ler
• grup konu konuşmaları

​

Kalıcı ACP bağlamaları

{
  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 iş parçacığına bağlı ACP başlatma

/acp spawn codex --thread here

• --thread here, DM’ler ve Feishu konuları için çalışır.
• Bağlı DM/konudaki takip mesajları doğrudan o ACP oturumuna yönlendirilir.
• v1, genel konu dışı grup sohbetlerini hedeflemez.

​

Çoklu ajan yönlendirme

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

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

​

Yapılandırma başvurusu

​

dmPolicy başvurusu

​

Desteklenen mesaj türleri

​

Alma

• ✅ Metin
• ✅ Zengin metin (post)
• ✅ Görseller
• ✅ Dosyalar
• ✅ Ses
• ✅ Video/medya
• ✅ Sticker’lar

​

Gönderme

• ✅ Metin
• ✅ Görseller
• ✅ Dosyalar
• ✅ Ses
• ✅ Video/medya
• ✅ Etkileşimli kartlar
• ⚠️ Zengin metin (post tarzı biçimlendirme ve kartlar, ancak rastgele Feishu yazım özellikleri değil)

​

İş parçacıkları ve yanıtlar

• ✅ Satır içi yanıtlar
• ✅ Feishu’nun reply_in_thread sunduğu konu iş parçacığı yanıtları
• ✅ Medya yanıtları, bir iş parçacığına/konu mesajına yanıt verirken iş parçacığı farkındalığını korur

​

Drive yorumları

• Feishu uygulamanızın olay aboneliği ayarlarında drive.notice.comment_add_v1 olayına abone olun (im.message.receive_v1 ile birlikte)
• Drive aracı varsayılan olarak etkindir; devre dışı bırakmak için channels.feishu.tools.drive: false kullanın

• yorum metni ve gönderen
• belge meta verileri (başlık, tür, URL)
• iş parçacığı içi yanıtlar için yorum iş parçacığı bağlamı

​

Çalışma zamanı eylem yüzeyi

• send
• read
• edit
• thread-reply
• pin
• list-pins
• unpin
• member-info
• channel-info
• channel-list
• tepkiler config içinde etkinleştirildiğinde react ve reactions
• feishu_drive yorum eylemleri: list_comments, list_comment_replies, add_comment, reply_comment

​

İlgili

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