Yuanbao - OpenClaw

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.

Kimlik bilgilerinizle Yuanbao kanalını ekleyin

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.

Kurulum tamamlandıktan sonra değişiklikleri uygulamak için gateway'i yeniden başlatın

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

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

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

Bot mesaj almıyor

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

Bot boş veya yedek yanıtlar gönderiyor

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

App Secret sızdırıldı

YuanBao APP içinde 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: "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")
    },
  },
}

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.

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

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 ve bilet üretimi için kullanılır)	-
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (imzalama için kullanılır)	-
`channels.yuanbao.accounts.<id>.token`	Önceden imzalanmış token (otomatik bilet imzalamayı atlar)	-
`channels.yuanbao.accounts.<id>.name`	Hesap görünen adı	-
`channels.yuanbao.accounts.<id>.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ış - 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

Documentation Index

​Hızlı başlangıç

​Etkileşimli kurulum (alternatif)

​Erişim denetimi

​Doğrudan mesajlar

​Grup sohbetleri

​Yapılandırma örnekleri

​Açık DM ilkesiyle temel kurulum

​DM’leri belirli kullanıcılarla sınırla

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

​Giden mesaj teslimini iyileştir

​Metin birleştirme stratejisini ayarla

​Yaygın komutlar

​Sorun giderme

​Bot grup sohbetlerinde yanıt vermiyor

​Bot mesaj almıyor

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

​App Secret sızdırıldı

​Gelişmiş yapılandırma

​Birden çok hesap

​Mesaj sınırları

​Akış

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

​Yanıt-hedef modu

​Markdown ipucu ekleme

​Hata ayıklama modu

​Çoklu ajan yönlendirme

​Yapılandırma başvurusu

​Desteklenen mesaj türleri

​Alma

​Gönderme

​Konular ve yanıtlar

​İlgili