Ön Koşullar
- Geliştirici erişimine sahip bir Feishu veya Lark hesabı
- Bir Claw örneği (buradan oluşturun)
Kurulum Kılavuzu
Bir Feishu Uygulaması Oluşturun
- Feishu Açık Platformu’na (veya Lark Developer’a) gidin
- Create Custom App butonuna tıklayın
- Bir uygulama adı ve açıklaması girin
- Create butonuna tıklayın
Bot Özelliği Ekleyin
- Uygulama ayarlarınızda, Features → Bot bölümüne gidin
- Bot özelliğini etkinleştirin
- Bu, uygulamanızın mesaj almasını ve göndermesini sağlar
Kimlik Bilgilerini Alın
- Credentials & Basic Info bölümüne gidin
- App ID değerini kopyalayın (
cli_ile başlar) - App Secret değerini kopyalayın
Olay Aboneliğini Yapılandırın
- Event Subscriptions bölümüne gidin
- WebSocket modunu seçin (önerilen — genel URL gerekmez)
- İstenirse, Encrypt Key ve Verification Token değerlerini ayarlayın
Olay İzinlerini Ekleyin
- Event Subscriptions altında, bu olayları ekleyin:
im.message.receive_v1— Mesajları al
- Permissions & Scopes bölümüne gidin ve şunları ekleyin:
im:message— Mesaj gönder ve alim:message.group_at_msg— Gruptaki @bahsetmeleri al
- Save butonuna tıklayın
Uygulamayı Yayınlayın
- App Release → Version Management bölümüne gidin
- Yeni bir sürüm oluşturun
- İnceleme için gönderin (dahili uygulamalar için bu genellikle anlıktır)
- Onaylandıktan sonra uygulama yayına girer
LemonClaw WebUI'yi Açın
- Hosted Claw kullanıyorsanız Claw Dashboard sayfanıza gidin ve Open WebUI’ye tıklayın
- LemonClaw’ı self-host ediyorsanız kendi WebUI’nizi (örneğin
http://your-ip:18789) açın ve token ile giriş yapın - WebUI içinde Settings → Channels bölümüne gidin
- Feishu bölümünü genişletin
- App ID ve App Secret bilgilerinizi yapıştırın
- Otomatik oluşturulan Encrypt Key ve Verification Token değerlerini tekrar Feishu geliştirici konsoluna kopyalayın
- Save butonuna tıklayın
Grup Ayarları
Panelinizin Channels bölümünden grup sohbeti davranışını yapılandırın:| Ayar | Seçenekler | Açıklama |
|---|---|---|
| Group Policy | Açık (varsayılan) / İzin Listesi / Devre Dışı | Botu gruplarda kimlerin tetikleyebileceğini kontrol eder |
| Require @mention | Açık / Kapalı | Bot yalnızca @bahsedildiğinde yanıt verir |
| Group IDs | Sohbet ID’leri listesi | Belirli gruplarla sınırla (boş = tüm gruplar) |
| Group Allowed Users | Open ID listesi | Sadece bu kullanıcılar botu tetikleyebilir (izin listesi modu) |
Sorun Giderme
Bot mesajları almıyor
Bot mesajları almıyor
- Uygulamanın yayınlandığını ve onaylandığını doğrulayın
im.message.receive_v1olayına abone olunduğundan emin olun- WebSocket modunun seçildiğinden emin olun (HTTP değil)
- Feishu konsolu ve Claw yapılandırması arasındaki Encrypt Key ve Verification Token değerlerinin eşleştiğini doğrulayın
'app_ticket' hatası
'app_ticket' hatası
- Bu genellikle App ID veya App Secret’ın yanlış olduğu anlamına gelir
- Panelinizdeki kimlik bilgilerini tekrar kontrol edin