Yuanbao

Tencent Yuanbao, Tencent'in AI asistan platformudur. OpenClaw kanal Plugin'i Yuanbao botlarını WebSocket üzerinden OpenClaw'a bağlar; böylece doğrudan mesajlar ve grup sohbetleri üzerinden kullanıcılarla etkileşime geçebilirler.

Durum: bot DM'leri + grup sohbetleri için üretime hazır. WebSocket desteklenen tek bağlantı modudur.

# Hızlı başlangıç

OpenClaw 2026.4.10 veya üzeri gerekir. Kontrol etmek için openclaw --version çalıştırın. openclaw update ile yükseltin.

openclaw channels add --channel yuanbao --token "appKey:appSecret"

openclaw gateway restart

# Etkileşimli kurulum (alternatif)

Etkileşimli sihirbazı da kullanabilirsiniz:

openclaw channels login --channel yuanbao

App ID ve App Secret bilgilerinizi girmek için istemleri izleyin.

# Erişim denetimi

# Doğrudan mesajlar

Bota kimlerin DM gönderebileceğini denetlemek için dmPolicy yapılandırın:

• "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" - tüm kullanıcılara izin ver (varsayılan)
• "disabled" - tüm DM'leri devre dışı bırak

Bir eşleştirme isteğini onaylama:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

# Grup sohbetleri

Bahsetme gereksinimi (channels.yuanbao.requireMention):

• true - @bahsetme gerektirir (varsayılan)
• false - @bahsetme olmadan yanıt verir

Bir grup sohbetinde botun mesajını yanıtlamak örtük bir bahsetme olarak değerlendirilir.

# Yapılandırma örnekleri

# Açık DM ilkesiyle temel kurulum

{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "open",
      },
    },
  },
}

# DM'leri belirli kullanıcılarla sınırla

{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "allowlist",
        allowFrom: ["user_id_1", "user_id_2"],
      },
    },
  },
}

# Gruplarda @bahsetme gereksinimini devre dışı bırak

{
  channels: {
    yuanbao: {
      requireMention: false,
    },
  },
}

# Giden mesaj teslimini iyileştir

{
  channels: {
    yuanbao: {
      // Send each chunk immediately without buffering
      outboundQueueStrategy: "immediate",
    },
  },
}

# Metin birleştirme stratejisini ayarla

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",
      minChars: 2800, // buffer until this many chars
      maxChars: 3000, // force split above this limit
      idleMs: 5000, // auto-flush after idle timeout (ms)
    },
  },
}

# Yaygın komutlar

Yuanbao yerel eğik çizgi komutu menülerini destekler. Gateway başlatıldığında komutlar platforma otomatik olarak eşitlenir.

# Sorun giderme

# Bot grup sohbetlerinde yanıt vermiyor

1. Botun gruba eklendiğinden emin olun
2. Bota @bahsettiğinizden emin olun (varsayılan olarak gereklidir)
3. Günlükleri kontrol edin: openclaw logs --follow

# Bot mesaj almıyor

1. Botun Yuanbao uygulamasında oluşturulduğundan ve onaylandığından emin olun
2. appKey ve appSecret değerlerinin doğru yapılandırıldığından emin olun
3. Gateway'in çalıştığından emin olun: openclaw gateway status
4. Günlükleri kontrol edin: openclaw logs --follow

# Bot boş veya yedek yanıtlar gönderiyor

1. AI modelinin geçerli içerik döndürüp döndürmediğini kontrol edin
2. Varsayılan yedek yanıt şudur: "暂时无法解答，你可以换个问题问问我哦"
3. Bunu channels.yuanbao.fallbackReply üzerinden özelleştirin

# App Secret sızdırıldı

1. YuanBao APP 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: {
    yuanbao: {
      defaultAccount: "main",
      accounts: {
        main: {
          appKey: "key_xxx",
          appSecret: "secret_xxx",
          name: "Primary bot",
        },
        backup: {
          appKey: "key_yyy",
          appSecret: "secret_yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

Giden API'ler bir accountId belirtmediğinde hangi hesabın kullanılacağını defaultAccount denetler.

# Mesaj sınırları

• maxChars - tek mesaj için maksimum karakter sayısı (varsayılan: 3000 karakter)
• mediaMaxMb - medya yükleme/indirme sınırı (varsayılan: 20 MB)
• overflowPolicy - mesaj sınırı aştığında davranış: "split" (varsayılan) veya "stop"

# Akış

Yuanbao blok düzeyinde akış çıktısını destekler. Etkinleştirildiğinde bot, metni üretirken parçalar halinde gönderir.

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // block streaming enabled (default)
    },
  },
}

Tam yanıtı tek mesajda göndermek için disableBlockStreaming: true ayarlayın.

# Grup sohbeti geçmişi bağlamı

Grup sohbetleri için AI bağlamına kaç geçmiş mesajın dahil edileceğini denetleyin:

{
  channels: {
    yuanbao: {
      historyLimit: 100, // default: 100, set 0 to disable
    },
  },
}

# Yanıt-hedef modu

Grup sohbetlerinde yanıt verirken botun mesajları nasıl alıntılayacağını denetleyin:

{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (default: "first")
    },
  },
}

# Markdown ipucu ekleme

Varsayılan olarak bot, AI modelinin tüm yanıtı markdown kod blokları içine sarmasını önlemek için sistem istemine yönergeler ekler.

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // default: true
    },
  },
}

# Hata ayıklama modu

Belirli bot ID'leri için temizlenmemiş günlük çıktısını etkinleştirin:

{
  channels: {
    yuanbao: {
      debugBotIds: ["bot_user_id_1", "bot_user_id_2"],
    },
  },
}

# Çoklu ajan yönlendirme

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

{
  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: "yuanbao",
        peer: { kind: "direct", id: "user_xxx" },
      },
    },
    {
      agentId: "agent-b",
      match: {
        channel: "yuanbao",
        peer: { kind: "group", id: "group_zzz" },
      },
    },
  ],
}

Yönlendirme alanları:

• match.channel: "yuanbao"
• match.peer.kind: "direct" (DM) veya "group" (grup sohbeti)
• match.peer.id: kullanıcı ID'si veya grup kodu

# Yapılandırma başvurusu

Tam yapılandırma: Gateway yapılandırması

# Desteklenen mesaj türleri

# Alma

• ✅ Metin
• ✅ Görseller
• ✅ Dosyalar
• ✅ Ses / Sesli mesaj
• ✅ Video
• ✅ Çıkartmalar / Özel emoji
• ✅ Özel öğeler (bağlantı kartları vb.)

# Gönderme

• ✅ Metin (markdown desteğiyle)
• ✅ Görseller
• ✅ Dosyalar
• ✅ Ses
• ✅ Video
• ✅ Çıkartmalar

# Konular ve yanıtlar

• ✅ Alıntı yanıtları (replyToMode üzerinden yapılandırılabilir)
• ❌ Konu yanıtları (platform tarafından desteklenmez)

# İ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 geçidi
• Kanal Yönlendirme - mesajlar için oturum yönlendirmesi
• Güvenlik - erişim modeli ve sıkılaştırma