Yuanbao

Tencent Yuanbao, Tencent’in yapay zekâ asistan platformudur. Topluluk tarafından bakımı yapılan openclaw-plugin-yuanbao plugini, doğrudan mesajlar ve grup sohbetleri için Yuanbao botlarını WebSocket üzerinden OpenClaw’a bağlar. Durum: bot DM’leri ve grup sohbetleri için üretime hazırdır. Desteklenen tek bağlantı modu WebSocket’tir. Bu plugin, çekirdek OpenClaw tarafından değil, harici bir katalog girdisi olarak Tencent Yuanbao ekibi tarafından yönetilir; aşağıdaki yapılandırma/davranış ayrıntıları (kurulum ve genel CLI yüzeyi dışındakiler) pluginin kendi belgelerinden alınmıştır ve OpenClaw çekirdek kaynağına göre doğrulanmamıştır.

Hızlı başlangıç

OpenClaw 2026.4.10 veya üzerini gerektirir. openclaw --version ile denetleyin; openclaw update ile yükseltin.

Kimlik bilgilerinizle Yuanbao kanalını ekleyin

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

--token, iki nokta üst üste ile ayrılmış appKey:appSecret kullanır. Bunları, uygulama ayarlarınızda bir bot oluşturarak Yuanbao uygulamasından edinin.

Değişikliği uygulamak için Gateway'i yeniden başlatın

openclaw gateway restart

Etkileşimli kurulum (alternatif)

openclaw channels login --channel yuanbao

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

Erişim denetimi

Doğrudan mesajlar

channels.yuanbao.dm.policy:

Değer	Davranış
`open` (varsayılan)	Tüm kullanıcılara izin ver
`pairing`	Bilinmeyen kullanıcılar bir eşleştirme kodu alır; CLI üzerinden onaylayın
`allowlist`	Yalnızca `allowFrom` içindeki kullanıcılar sohbet edebilir
`disabled`	Tüm DM’leri devre dışı bırak

Bir eşleştirme isteğini onaylayın:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

Grup sohbetleri

channels.yuanbao.requireMention (varsayılan true): botun bir grupta yanıt vermesinden önce @bahsetme gerektirir. Botun kendi mesajına verilen yanıt, örtük bir bahsetme olarak değerlendirilir.

Yapılandırma örnekleri

Temel kurulum, açık DM politikası:

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

DM’leri belirli kullanıcılarla sınırlandırın:

{
  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ın:

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

Giden teslimatı ayarlama:

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",
      minChars: 2800, // bu karakter sayısına ulaşana kadar arabelleğe al
      maxChars: 3000, // bu sınırın üzerinde bölmeyi zorunlu kıl
      idleMs: 5000, // boşta kalma zaman aşımından (ms) sonra otomatik gönder
    },
  },
}

Her parçayı arabelleğe almadan göndermek için outboundQueueStrategy: "immediate" olarak ayarlayın.

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ıştırmayı durdur
`/restart`	OpenClaw’ı yeniden başlat
`/compact`	Oturum bağlamını sıkıştır

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

Sorun giderme

Bot grup sohbetlerinde yanıt vermiyor:

Botun gruba eklendiğini doğrulayın
Bottan @bahsedildiğini doğrulayın (varsayılan olarak gereklidir)
Günlükleri denetleyin: openclaw logs --follow

Bot mesajları almıyor:

Botun Yuanbao uygulamasında oluşturulduğunu ve onaylandığını doğrulayın
appKey ve appSecret değerlerinin doğru yapılandırıldığını doğrulayın
Gateway’in çalıştığını doğrulayın: openclaw gateway status
Günlükleri denetleyin: openclaw logs --follow

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

Yapay zekâ modelinin geçerli içerik döndürüp döndürmediğini denetleyin
Varsayılan yedek yanıt: “暂时无法解答，你可以换个问题问问我哦”
channels.yuanbao.fallbackReply ile özelleştirin

App Secret sızdırıldı:

Yuanbao uygulamasındaki App Secret değerini sıfırlayın
Yapılandırmanızdaki değeri güncelleyin
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: "Birincil bot",
        },
        backup: {
          appKey: "key_yyy",
          appSecret: "secret_yyy",
          name: "Yedek bot",
          enabled: false,
        },
      },
    },
  },
}

defaultAccount, giden API’ler bir accountId belirtmediğinde hangi hesabın kullanılacağını denetler.

Mesaj sınırları

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

Akış

Yuanbao blok düzeyinde akış çıktısını destekler; bot metni oluştururken parçalar hâlinde gönderir.

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // blok akışı etkin (varsayılan)
    },
  },
}

Yanıtın tamamını tek bir mesajda göndermek için disableBlockStreaming: true olarak ayarlayın.

Grup sohbeti geçmişi bağlamı

{
  channels: {
    yuanbao: {
      historyLimit: 100, // varsayılan: 100, devre dışı bırakmak için 0 olarak ayarlayın
    },
  },
}

Grup sohbetleri için yapay zekâ bağlamına kaç geçmiş mesajın ekleneceğini denetler.

Yanıtlama modu

{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (varsayılan: "first")
    },
  },
}

Değer	Davranış
`off`	Alıntılı yanıt yok
`first`	Her gelen mesaj için yalnızca ilk yanıtı alıntıla (varsayılan)
`all`	Her yanıtı alıntıla

Markdown ipucu ekleme

Bot, varsayılan olarak modelin yanıtın tamamını bir markdown kod bloğuna sarmasını önlemek için sistem istemine bir talimat ekler.

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // varsayılan: true
    },
  },
}

Hata ayıklama modu

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

Listelenen bot kimlikleri için temizlenmemiş günlük çıktısını etkinleştirir.

Çok aracılı yönlendirme

Yuanbao DM’lerini veya gruplarını farklı aracılara 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" },
      },
    },
  ],
}

match.channel: "yuanbao"
match.peer.kind: "direct" (DM) veya "group" (grup sohbeti)
match.peer.id: kullanıcı kimliği veya grup kodu

Yapılandırma başvurusu

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

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.<id>.appKey`	App Key (imzalama + bilet oluşturma)	-
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (imzalama)	-
`channels.yuanbao.accounts.<id>.token`	Önceden imzalanmış belirteç (otomatik bilet imzalamayı atlar)	-
`channels.yuanbao.accounts.<id>.name`	Hesabın görünen adı	-
`channels.yuanbao.accounts.<id>.enabled`	Belirli bir hesabı etkinleştir/devre dışı bırak	`true`
`channels.yuanbao.dm.policy`	DM politikası	`open`
`channels.yuanbao.dm.allowFrom`	DM izin listesi (kullanıcı kimliği listesi)	-
`channels.yuanbao.requireMention`	Gruplarda @bahsetme gerektir	`true`
`channels.yuanbao.overflowPolicy`	Uzun mesaj işleme (`split` veya `stop`)	`split`
`channels.yuanbao.replyToMode`	Grup yanıtlama stratejisi (`off`, `first`, `all`)	`first`
`channels.yuanbao.outboundQueueStrategy`	Giden strateji (`merge-text` veya `immediate`)	`merge-text`
`channels.yuanbao.minChars`	Metin birleştirme: göndermeyi tetikleyecek en az karakter sayısı	`2800`
`channels.yuanbao.maxChars`	Metin birleştirme: mesaj başına en fazla karakter sayısı	`3000`
`channels.yuanbao.idleMs`	Metin birleştirme: otomatik göndermeden ö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ş bağlamı girdileri	`100`
`channels.yuanbao.disableBlockStreaming`	Blok düzeyinde akış çıktısını devre dışı bırak	`false`
`channels.yuanbao.fallbackReply`	Model içerik döndürmediğinde kullanılacak yedek yanıt	`暂时无法解答，你可以换个问题问问我哦`
`channels.yuanbao.markdownHintEnabled`	Markdown sarmalamayı önleme talimatları ekle	`true`
`channels.yuanbao.debugBotIds`	Hata ayıklama izin listesindeki bot kimlikleri (temizlenmemiş günlükler)	`[]`

Desteklenen mesaj türleri

Alma: metin, görseller, dosyalar, ses/sesli mesaj, video, çıkartmalar/özel emojiler, özel öğeler (bağlantı kartları). Gönderme: metin (markdown), görseller, dosyalar, ses, video, çıkartmalar. İş parçacıkları ve yanıtlar: alıntılı yanıtlar (replyToMode aracılığıyla yapılandırılabilir); iş parçacığı 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 denetimi
Kanal Yönlendirme - iletiler için oturum yönlendirmesi
Güvenlik - erişim modeli ve sağlamlaştırma

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Hızlı başlangıç

Etkileşimli kurulum (alternatif)

Erişim denetimi

Doğrudan mesajlar

Grup sohbetleri

Yapılandırma örnekleri

Yaygın komutlar

Sorun giderme

Gelişmiş yapılandırma

Birden çok hesap

Mesaj sınırları

Akış

Grup sohbeti geçmişi bağlamı

Yanıtlama modu

Markdown ipucu ekleme

Hata ayıklama modu

Çok aracılı yönlendirme

Yapılandırma başvurusu

Desteklenen mesaj türleri

İlgili

​Hızlı başlangıç

​Etkileşimli kurulum (alternatif)

​Erişim denetimi

​Doğrudan mesajlar

​Grup sohbetleri

​Yapılandırma örnekleri

​Yaygın komutlar

​Sorun giderme

​Gelişmiş yapılandırma

​Birden çok hesap

​Mesaj sınırları

​Akış

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

​Yanıtlama modu

​Markdown ipucu ekleme

​Hata ayıklama modu

​Çok aracılı yönlendirme

​Yapılandırma başvurusu

​Desteklenen mesaj türleri

​İlgili

Hızlı başlangıç

Etkileşimli kurulum (alternatif)

Erişim denetimi

Doğrudan mesajlar

Grup sohbetleri

Yapılandırma örnekleri

Yaygın komutlar

Sorun giderme

Gelişmiş yapılandırma

Birden çok hesap

Mesaj sınırları

Akış

Grup sohbeti geçmişi bağlamı

Yanıtlama modu

Markdown ipucu ekleme

Hata ayıklama modu

Çok aracılı yönlendirme

Yapılandırma başvurusu

Desteklenen mesaj türleri

İlgili