Feishu

​

Hızlı başlangıç

openclaw channels login --channel feishu

openclaw gateway restart

​

Erişim kontrolü

​

Doğrudan mesajlar

• "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
• "open" - yalnızca allowFrom "*" içerdiğinde herkese açık DM’lere izin verilir; kısıtlayıcı girdilerle yalnızca eşleşen kullanıcılar sohbet edebilir

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Grup sohbetleri

• true - @mention gerektir (varsayılan)
• false - @mention olmadan yanıt ver
• 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 bot bahsetmesi sayılır.

​

Grup yapılandırma örnekleri

​

Tüm gruplara izin ver, @mention gerekmez

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

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groups: {
        oc_xxx: {
          requireMention: false,
        },
      },
    },
  },
}

​

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 alma

​

Grup kimlikleri (chat_id, biçim: oc_xxx)

​

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

openclaw logs --follow

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 içinde yayınlandığından ve onaylandığından emin olun
2. Etkinlik aboneliğinin im.message.receive_v1 içerdiğinden emin olun
3. Kalıcı bağlantı (WebSocket) seçildiğinden 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 içinde 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ı

1. Feishu Open Platform / Lark Developer içinde 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,
        },
      },
    },
  },
}

​

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

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

​

Kota optimizasyonu

• typingIndicator (varsayılan true): yazıyor tepkisi çağrılarını atlamak için false ayarlayın
• resolveSenderNames (varsayılan true): gönderici profili aramalarını atlamak için false ayarlayın

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

​

ACP oturumları

​

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

/acp spawn codex --thread here

​

Çok ajanlı yönlendirme

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

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

​

Kullanıcı başına ajan yalıtımı (Dinamik Ajan Oluşturma)

• Bağımsız çalışma alanı dizini
• Ayrı USER.md / SOUL.md / MEMORY.md
• Özel konuşma geçmişi
• Yalıtılmış Skills ve durum

​

Hızlı kurulum

{
  channels: {
    feishu: {
      dmPolicy: "open",
      allowFrom: ["*"],
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Critical: makes each user's DM their "main session"
    // Automatically loads USER.md / SOUL.md / MEMORY.md
    // For stronger isolation, use "per-channel-peer" instead
    dmScope: "main",
  },
}

​

Nasıl çalışır

1. Kanal benzersiz bir agentId üretir: varsayılan hesap için feishu-{user_open_id} veya adlandırılmış bir hesap için sınırlandırılmış, hesap önekli kimlik özeti
2. workspaceTemplate yolunda yeni bir çalışma alanı oluşturur
3. Ajanı kaydeder ve bu kullanıcı için bir bağlama oluşturur
4. Çalışma alanı yardımcısı ilk erişimde önyükleme dosyalarını (AGENTS.md, SOUL.md, USER.md vb.) sağlar
5. Bu kullanıcıdan gelen tüm gelecekteki mesajları ayrılmış ajanına yönlendirir

​

Yapılandırma seçenekleri

• {agentId} - oluşturulan ajan kimliği (ör. feishu-ou_xxxxxx veya feishu-support-<identity_digest>)
• {userId} - gönderenin Feishu open_id değeri (ör. ou_xxxxxx)

​

Oturum kapsamı

{
  session: {
    // For single-user personal bots: enables auto bootstrap loading
    dmScope: "main",

    // For public multi-user bots: stronger isolation
    // dmScope: "per-channel-peer",
  },
}

​

Tipik çok kullanıcılı dağıtım

{
  channels: {
    feishu: {
      appId: "cli_xxx",
      appSecret: "xxx",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "open",
      requireMention: true,
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Choose dmScope based on your isolation needs:
    // "main" for bootstrap auto-loading, "per-channel-peer" for stronger isolation
    dmScope: "main",
  },
  bindings: [], // Empty - dynamic agents auto-bind
}

​

Doğrulama

feishu: creating dynamic agent "feishu-ou_xxxxxx" for user ou_xxxxxx
workspace: /Users/you/.openclaw/workspace-feishu-ou_xxxxxx
feishu: dynamic agent created, new route: agent:feishu-ou_xxxxxx:main

ls -la ~/.openclaw/workspace-*

​

Notlar

• Çalışma alanı yalıtımı: Her kullanıcı kendi çalışma alanı dizinini ve ajan örneğini alır. Kullanıcılar normal mesajlaşma akışı içinde birbirlerinin konuşma geçmişini veya dosyalarını göremez.
• Güvenlik sınırı: Bu, düşmanca bir ortak kiracı güvenlik sınırı değil, mesajlaşma bağlamı yalıtım mekanizmasıdır. Ajan süreci ve ana makine ortamı paylaşılır.
• bindings boş olmalıdır: Dinamik ajanlar kendi bağlamalarını otomatik kaydeder
• Yükseltme yolu: Mevcut elle yapılan bağlamalar dinamik ajanlarla birlikte çalışmaya devam eder
• session.dmScope geneldir: Bu yalnızca Feishu’yu değil, tüm kanalları etkiler

​

Yapılandırma başvurusu

​

Desteklenen mesaj türleri

​

Alma

• ✅ Metin
• ✅ Zengin metin (gönderi)
• ✅ 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 (gönderi tarzı biçimlendirme; tam Feishu/Lark yazarlık özelliklerini desteklemez)

​

Konular ve yanıtlar

• ✅ Satır içi yanıtlar
• ✅ Konu yanıtları
• ✅ Medya yanıtları, bir konu iletisine yanıt verirken konu 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 kapısı
• Kanal Yönlendirme - iletiler için oturum yönlendirmesi
• Güvenlik - erişim modeli ve güçlendirme