--- read_when: - Bir Yuanbao botu bağlamak istiyorsunuz - Yuanbao kanalını yapılandırıyorsunuz summary: Yuanbao botuna genel bakış, özellikleri ve yapılandırması title: Yuanbao x-i18n: generated_at: "2026-05-06T09:04:28Z" model: gpt-5.5 provider: openai source_hash: 3830af0206854e500132edfc9340724fe97f90ca60fa23ce05202d96d9cacf04 source_path: channels/yuanbao.md workflow: 16 --- 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. ```bash openclaw channels add --channel yuanbao --token "appKey:appSecret" ``` `--token` değeri, iki nokta üst üste ile ayrılmış `appKey:appSecret` biçimini kullanır. Bunları Yuanbao uygulamasında, uygulama ayarlarınızdan bir robot oluşturarak alabilirsiniz. ```bash openclaw gateway restart ``` ### Etkileşimli kurulum (alternatif) Etkileşimli sihirbazı da kullanabilirsiniz: ```bash 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:** ```bash openclaw pairing list yuanbao openclaw pairing approve yuanbao ``` ### 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 ```json5 { channels: { yuanbao: { appKey: "your_app_key", appSecret: "your_app_secret", dm: { policy: "open", }, }, }, } ``` ### DM'leri belirli kullanıcılarla sınırla ```json5 { 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 ```json5 { channels: { yuanbao: { requireMention: false, }, }, } ``` ### Giden mesaj teslimini iyileştir ```json5 { channels: { yuanbao: { // Send each chunk immediately without buffering outboundQueueStrategy: "immediate", }, }, } ``` ### Metin birleştirme stratejisini ayarla ```json5 { 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 | Komut | Açıklama | | ---------- | --------------------------- | | `/help` | Kullanılabilir komutları göster | | `/status` | Bot durumunu göster | | `/new` | Yeni bir oturum başlat | | `/stop` | Geçerli çalışmayı durdur | | `/restart` | OpenClaw'ı yeniden başlat | | `/compact` | Oturum bağlamını sıkıştır | > 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 ```json5 { 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. ```json5 { 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: ```json5 { 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: ```json5 { channels: { yuanbao: { replyToMode: "first", // "off" | "first" | "all" (default: "first") }, }, } ``` | Değer | Davranış | | --------- | -------------------------------------------------------- | | `"off"` | Alıntılı yanıt yok | | `"first"` | Gelen mesaj başına yalnızca ilk yanıtı alıntıla (varsayılan) | | `"all"` | Her yanıtı alıntıla | ### 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. ```json5 { 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: ```json5 { 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. ```json5 { 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ı](/tr/gateway/configuration) | Ayar | Açıklama | Varsayılan | | ------------------------------------------ | ------------------------------------------------- | -------------------------------------- | | `channels.yuanbao.enabled` | Kanalı etkinleştir/devre dışı bırak | `true` | | `channels.yuanbao.defaultAccount` | Giden yönlendirme için varsayılan hesap | `default` | | `channels.yuanbao.accounts..appKey` | App Key (imzalama ve bilet üretimi için kullanılır) | - | | `channels.yuanbao.accounts..appSecret` | App Secret (imzalama için kullanılır) | - | | `channels.yuanbao.accounts..token` | Önceden imzalanmış token (otomatik bilet imzalamayı atlar) | - | | `channels.yuanbao.accounts..name` | Hesap görünen adı | - | | `channels.yuanbao.accounts..enabled` | Belirli bir hesabı etkinleştir/devre dışı bırak | `true` | | `channels.yuanbao.dm.policy` | DM ilkesi | `open` | | `channels.yuanbao.dm.allowFrom` | DM izin listesi (kullanıcı ID'si listesi) | - | | `channels.yuanbao.requireMention` | Gruplarda @bahsetme gerektir | `true` | | `channels.yuanbao.overflowPolicy` | Uzun mesaj işleme (`split` veya `stop`) | `split` | | `channels.yuanbao.replyToMode` | Grup yanıt-hedef stratejisi (`off`, `first`, `all`) | `first` | | `channels.yuanbao.outboundQueueStrategy` | Giden strateji (`merge-text` veya `immediate`) | `merge-text` | | `channels.yuanbao.minChars` | Merge-text: göndermeyi tetiklemek için min karakter | `2800` | | `channels.yuanbao.maxChars` | Merge-text: mesaj başına maks karakter | `3000` | | `channels.yuanbao.idleMs` | Merge-text: otomatik boşaltmadan önce boşta kalma zaman aşımı (ms) | `5000` | | `channels.yuanbao.mediaMaxMb` | Medya boyutu sınırı (MB) | `20` | | `channels.yuanbao.historyLimit` | Grup sohbeti geçmişi bağlam girdileri | `100` | | `channels.yuanbao.disableBlockStreaming` | Blok düzeyinde akış çıktısını devre dışı bırak | `false` | | `channels.yuanbao.fallbackReply` | AI içerik döndürmediğinde yedek yanıt | `暂时无法解答，你可以换个问题问问我哦` | | `channels.yuanbao.markdownHintEnabled` | Markdown sarmayı önleme yönergelerini ekle | `true` | | `channels.yuanbao.debugBotIds` | Hata ayıklama izin listesindeki bot ID'leri (temizlenmemiş günlükler) | `[]` | --- ## 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ış](/tr/channels) - desteklenen tüm kanallar - [Eşleştirme](/tr/channels/pairing) - DM kimlik doğrulaması ve eşleştirme akışı - [Gruplar](/tr/channels/groups) - grup sohbeti davranışı ve bahsetme geçidi - [Kanal Yönlendirme](/tr/channels/channel-routing) - mesajlar için oturum yönlendirmesi - [Güvenlik](/tr/gateway/security) - erişim modeli ve sıkılaştırma