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 yuanbaoopenclaw 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