OpenClaw ile WeChat Ücretsiz Nasıl Kullanılır?

TL;DR: OpenClaw'ı WeChat'e bağlamak için @tencent-weixin/openclaw-weixin eklentisini yükleyin, hesabınızı yetkilendirmek için bir QR kodunu tarayın ve ağ geçidini yeniden başlatın. Tüm kurulum 5 dakikadan az sürer. Eklenti ücretsiz, açık kaynaklıdır ve aynı anda birden fazla WeChat hesabını destekler.

Giriş

WeChat'te bir yapay zeka asistanı çalıştırmak karmaşık görünebilir. Çoğu çözüm pahalı API abonelikleri, karmaşık sunucu kurulumları veya kurumsal hesaplar gerektirir. OpenClaw bunu değiştiriyor.

@tencent-weixin/openclaw-weixin eklentisi, kişisel WeChat hesabınızı OpenClaw'un yapay zeka ağ geçidine dakikalar içinde bağlar. Kurumsal hesap gerekmez. Aylık ücret yok. Sadece bir QR kodunu tarayın ve yayındasınız.

Bu rehber, eklentiyi yüklemekten birden fazla hesabı yönetmeye ve konuşma bağlamlarını izole etmeye kadar eksiksiz kurulumu adım adım anlatır. Sonunda, WeChat'iniz OpenClaw üzerinde tamamen işlevsel bir yapay zeka asistanına sahip olacak.

Ön Koşullar

Başlamadan önce şunlara ihtiyacınız var:

• OpenClaw yüklü (eklenti v2.0.x için sürüm >=2026.3.22)
• Terminalinizde openclaw CLI mevcut
• Bir WeChat hesabı (kişisel hesap çalışır — kurumsal hesap gerekmez)
• Node.js yüklü (tek tıklamalı yükleyici için)

OpenClaw sürümünüzü kontrol edin:

openclaw --version

Eski bir sürüm kullanıyorsanız, önce güncelleyin. Eklenti v2.0.x, OpenClaw >=2026.3.22 gerektirir.

Eklenti Uyumluluğu

Eklenti başlangıçta ana bilgisayar sürümünü kontrol eder. OpenClaw sürümünüz aralığın dışındaysa, eklenti yüklenmeyi reddedecektir.

Adım 1: Eklentiyi Yükleyin

Seçenek A: Tek Tıklamayla Kurulum (Önerilen)

npx -y @tencent-weixin/openclaw-weixin-cli install

Bu, her şeyi otomatik olarak halleder — eklenti kurulumu, yapılandırma ve ilk kurulum.

Seçenek B: Manuel Kurulum

Tek tıklamayla yükleyici sisteminizde çalışmazsa, manuel olarak kurun:

1. Eklentiyi yükleyin:

openclaw plugins install "@tencent-weixin/openclaw-weixin"

2. Eklentiyi etkinleştirin:

openclaw config set plugins.entries.openclaw-weixin.enabled true

Adım 2: WeChat'i Yetkilendirmek için QR Kodunu Tarayın

Eklenti yüklendikten sonra, WeChat hesabınızla oturum açın:

openclaw channels login --channel openclaw-weixin

Terminalinizde bir QR kodu görünecektir. Telefonunuzda WeChat'i açın, tarama simgesine dokunun ve kodu tarayın. Yetkilendirmeyi telefonunuzda onaylayın.

Oturum açma bilgileriniz otomatik olarak yerel olarak kaydedilir. Oturumunuzu kapatmadığınız sürece tekrar taramanıza gerek yoktur.

Adım 3: Ağ Geçidini Yeniden Başlatın

Yetkilendirdikten sonra, eklentiyi etkinleştirmek için OpenClaw ağ geçidini yeniden başlatın:

openclaw gateway restart

Hepsi bu. WeChat hesabınız artık OpenClaw'a bağlı. WeChat'inize gönderilen mesajlar yapay zeka aracısı tarafından işlenecektir.

Adım 4: Birden Fazla WeChat Hesabı Ekleyin (İsteğe Bağlı)

OpenClaw, aynı anda birden fazla WeChat hesabını destekler. Başka bir hesap eklemek için, oturum açma komutunu tekrar çalıştırın:

openclaw channels login --channel openclaw-weixin

Her QR kodu taraması yeni bir hesap girişi oluşturur. Tüm hesaplar birbirini etkilemeden paralel olarak çalışır.

Adım 5: Konuşma Bağlamlarını İzole Edin (İsteğe Bağlı)

Varsayılan olarak, tüm kanallar aynı yapay zeka konuşma bağlamını paylaşır. Bu, WeChat konuşmalarınızın ve diğer kanalların (Telegram, Discord vb.) aynı yapay zeka belleğini paylaştığı anlamına gelir.

Her WeChat hesabının kendi izole bağlamına sahip olmasını istiyorsanız:

openclaw config set agents.mode per-channel-per-peer

Bu ayar ile, "WeChat hesabı + kişi"nin her kombinasyonu kendi bağımsız yapay zeka belleğine sahip olur. Farklı hesaplar arasındaki konuşmalar birbirine karışmaz.

Eklenti Kaputun Altında Nasıl Çalışır

Eklentiyi anlamak veya genişletmek isteyen geliştiriciler için, OpenClaw ağ geçidi ile nasıl iletişim kurduğunu burada bulabilirsiniz.

Kimlik Doğrulama Başlıkları

Tüm API istekleri bu başlıkları kullanır:

Temel API Uç Noktaları

Eklenti 5 HTTP JSON uç noktası kullanır:

Mesaj Alma (Uzun Yoklama)

Eklenti, mesajları almak için uzun yoklama kullanır:

// İstek
{
  "get_updates_buf": ""
}

// Yanıt
{
  "ret": 0,
  "msgs": [...],
  "get_updates_buf": "<new_cursor>",
  "longpolling_timeout_ms": 35000
}

Yalnızca yeni mesajları almak için her sonraki istekte get_updates_buf imlecini geri geçirin.

Mesaj Gönderme

{
  "msg": {
    "to_user_id": "<target_user_id>",
    "context_token": "<session_context_token>",
    "item_list": [
      {
        "type": 1,
        "text_item": { "text": "Hello!" }
      }
    ]
  }
}

Mesaj Türleri

Medya Yükleme (Resimler, Dosyalar, Videolar)

Medya dosyaları yüklenmeden önce AES-128-ECB ile şifrelenir. Akış:

1. Dosya meta verileriyle (boyut, MD5) getUploadUrl çağrısı yapın
2. Önceden imzalanmış CDN yükleme parametrelerini alın
3. Dosyayı AES-128-ECB ile şifreleyin
4. Önceden imzalanmış URL kullanarak CDN'e yükleyin
5. CDN dosyasını sendMessage içinde referans gösterin

Yaygın Sorunlar ve Çözümleri

Eklenti Yüklenmeyi Reddediyor

Hata: Eklenti başlangıçta yüklenmeyi reddediyor

Çözüm: OpenClaw sürümünüzü kontrol edin. Eklenti v2.0.x, >=2026.3.22 gerektirir.

openclaw --version
# Eski ise, önce OpenClaw'ı güncelleyin

QR Kodu Süresi Doldu

Hata: QR kodu taranmadan önce zaman aşımına uğruyor

Çözüm: Oturum açma komutunu tekrar çalıştırın. QR kodlarının süresi yaklaşık 30 saniye sonra dolar.

openclaw channels login --channel openclaw-weixin

Mesajlar Alınmıyor

Hata: WeChat mesajları OpenClaw'a ulaşmıyor

Çözüm: Oturum açtıktan sonra ağ geçidini yeniden başlatın.

openclaw gateway restart

Birden Fazla Hesabın Bağlamları Karışıyor

Hata: Bir hesaptan gelen yapay zeka yanıtları diğerinde görünüyor

Çözüm: Kanal başına bağlam izolasyonunu etkinleştirin.

openclaw config set agents.mode per-channel-per-peer

Gerçek Dünya Kullanım Senaryoları

Kişisel Yapay Zeka Asistanı

Kişisel WeChat'inizi OpenClaw'a bağlayın ve meşgul olduğunuzda bir yapay zeka asistanının mesajlara yanıt vermesini sağlayın. Her bir kişinin konuşma geçmişine göre kişiselleştirilmiş yanıtlar alması için bağlam izolasyonunu ayarlayın.

Küçük İşletme Müşteri Desteği

Farklı iş kolları için birden fazla WeChat hesabı çalıştırın. Her hesap, kendi müşteri sorgularını izole yapay zeka belleğiyle yönetir. Hesaplar arasında çapraz kirlenme olmaz.

Geliştirici Testi

Özel entegrasyonlar oluşturmak için HTTP JSON API'sini kullanın. Eklentinin arka uç protokolü tamamen belgelenmiştir, bu da varsayılan davranışı genişletmeyi veya değiştirmeyi kolaylaştırır.

Sonuç

OpenClaw'ı WeChat ile kurmak 5 dakikadan az sürer. Eklentiyi yükleyin, bir QR kodunu tarayın, ağ geçidini yeniden başlatın — tamamdır. Ücretsiz kurulum, birden fazla hesabı, bağlam izolasyonunu ve tam medya desteğini (resimler, ses, dosyalar, video) destekler.

Geliştiriciler için, belgelenmiş HTTP JSON API, özel entegrasyonları kolaylaştırır.

Tek tıklamayla yükleyici ile başlayın:

npx -y @tencent-weixin/openclaw-weixin-cli install

Sonraki adım: WeChat botunuz çalışmaya başladıktan sonra, muhtemelen onu harici API'lere (ödeme ağ geçitleri, CRM'ler, hava durumu hizmetleri vb.) bağlamanız gerekecektir. Botunuzun her zaman doğru veriyi gönderdiğinden emin olmak için API'lerinizi Apidog ile test edin. Ücretsiz katman mevcuttur, kredi kartı gerekmez.

Sıkça Sorulan Sorular

S: Bu, kişisel WeChat hesaplarıyla çalışır mı?

C: Evet. Çoğu WeChat otomasyon aracından farklı olarak, bu eklenti kişisel hesaplarla çalışır. Kurumsal veya resmi hesap gerekmez.

S: Eklenti ücretsiz mi?

C: Evet. @tencent-weixin/openclaw-weixin eklentisi ücretsiz ve açık kaynaklıdır. Yalnızca çalışan bir OpenClaw kurulumuna ihtiyacınız var.

S: Aynı anda birden fazla WeChat hesabı çalıştırabilir miyim?

C: Evet. Her hesap için openclaw channels login --channel openclaw-weixin komutunu çalıştırın. Tüm hesaplar aynı anda çalışır.

S: Bilgisayarımı yeniden başlatırsam ne olur?

C: Oturum açma bilgileri yerel olarak kaydedilir. Yeniden başlattıktan sonra QR kodunu tekrar taramanıza gerek yoktur. Sadece ağ geçidini openclaw gateway restart ile yeniden başlatın.

S: Bunun üzerine özel entegrasyonlar oluşturabilir miyim?

C: Evet. Eklenti, 5 uç nokta ile belgelenmiş bir HTTP JSON API'si sunar: getUpdates, sendMessage, getUploadUrl, getConfig ve sendTyping. Botunuzun harici hizmetleri çağırması gerekiyorsa, yayına almadan önce API entegrasyonlarınızı test etmek ve doğrulamak için Apidog'u kullanın.