Yuanbao

Tencent Yuanbao adalah platform asisten AI milik Tencent. Plugin saluran OpenClaw menghubungkan bot Yuanbao ke OpenClaw melalui WebSocket agar bot dapat berinteraksi dengan pengguna melalui pesan langsung dan obrolan grup. Status: siap produksi untuk DM bot + obrolan grup. WebSocket adalah satu-satunya mode koneksi yang didukung.

Mulai cepat

Memerlukan OpenClaw 2026.4.10 atau yang lebih baru. Jalankan openclaw --version untuk memeriksa. Tingkatkan dengan openclaw update.

Tambahkan saluran Yuanbao dengan kredensial Anda

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

Nilai --token menggunakan format appKey:appSecret yang dipisahkan titik dua. Anda bisa mendapatkannya dari aplikasi Yuanbao dengan membuat robot di pengaturan aplikasi Anda.

Setelah penyiapan selesai, mulai ulang gateway untuk menerapkan perubahan

openclaw gateway restart

Penyiapan interaktif (alternatif)

Anda juga dapat menggunakan wizard interaktif:

openclaw channels login --channel yuanbao

Ikuti prompt untuk memasukkan App ID dan App Secret Anda.

Kontrol akses

Pesan langsung

Konfigurasikan dmPolicy untuk mengontrol siapa yang dapat mengirim DM ke bot:

"pairing" — pengguna tidak dikenal menerima kode pairing; setujui melalui CLI
"allowlist" — hanya pengguna yang tercantum di allowFrom yang dapat mengobrol
"open" — izinkan semua pengguna (default)
"disabled" — nonaktifkan semua DM

Setujui permintaan pairing:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

Obrolan grup

Persyaratan mention (channels.yuanbao.requireMention):

true — wajib @mention (default)
false — tanggapi tanpa @mention

Membalas pesan bot dalam obrolan grup dianggap sebagai mention implisit.

Contoh konfigurasi

Penyiapan dasar dengan kebijakan DM terbuka

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

Batasi DM ke pengguna tertentu

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

Nonaktifkan persyaratan @mention di grup

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

Optimalkan pengiriman pesan keluar

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

Sesuaikan strategi merge-text

{
  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)
    },
  },
}

Perintah umum

Perintah	Deskripsi
`/help`	Tampilkan perintah yang tersedia
`/status`	Tampilkan status bot
`/new`	Mulai sesi baru
`/stop`	Hentikan run saat ini
`/restart`	Mulai ulang OpenClaw
`/compact`	Padatkan konteks sesi

Yuanbao mendukung menu perintah garis miring native. Perintah disinkronkan ke platform secara otomatis saat gateway dimulai.

Pemecahan masalah

Bot tidak merespons di obrolan grup

Pastikan bot telah ditambahkan ke grup
Pastikan Anda @mention bot (wajib secara default)
Periksa log: openclaw logs --follow

Bot tidak menerima pesan

Pastikan bot telah dibuat dan disetujui di aplikasi Yuanbao
Pastikan appKey dan appSecret dikonfigurasi dengan benar
Pastikan gateway berjalan: openclaw gateway status
Periksa log: openclaw logs --follow

Bot mengirim balasan kosong atau fallback

Periksa apakah model AI mengembalikan konten yang valid
Balasan fallback default adalah: “暂时无法解答，你可以换个问题问问我哦”
Sesuaikan melalui channels.yuanbao.fallbackReply

App Secret bocor

Reset App Secret di YuanBao APP
Perbarui nilai di konfigurasi Anda
Mulai ulang gateway: openclaw gateway restart

Konfigurasi lanjutan

Beberapa akun

{
  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,
        },
      },
    },
  },
}

defaultAccount mengontrol akun mana yang digunakan saat API keluar tidak menentukan accountId.

Batas pesan

maxChars — jumlah karakter maksimum untuk satu pesan (default: 3000 karakter)
mediaMaxMb — batas unggah/unduh media (default: 20 MB)
overflowPolicy — perilaku saat pesan melebihi batas: "split" (default) atau "stop"

Streaming

Yuanbao mendukung output streaming tingkat blok. Saat diaktifkan, bot mengirim teks dalam potongan saat teks dihasilkan.

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

Tetapkan disableBlockStreaming: true untuk mengirim balasan lengkap dalam satu pesan.

Konteks riwayat obrolan grup

Kontrol berapa banyak pesan historis yang disertakan dalam konteks AI untuk obrolan grup:

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

Mode reply-to

Kontrol cara bot mengutip pesan saat membalas di obrolan grup:

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

Nilai	Perilaku
`"off"`	Tidak ada balasan kutipan
`"first"`	Kutip hanya balasan pertama per pesan masuk (default)
`"all"`	Kutip setiap balasan

Injeksi petunjuk Markdown

Secara default, bot menyisipkan instruksi dalam prompt sistem untuk mencegah model AI membungkus seluruh balasan dalam blok kode markdown.

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

Mode debug

Aktifkan output log yang tidak disanitasi untuk ID bot tertentu:

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

Perutean multi-agen

Gunakan bindings untuk merutekan DM atau grup Yuanbao ke agen berbeda.

{
  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" },
      },
    },
  ],
}

Kolom perutean:

match.channel: "yuanbao"
match.peer.kind: "direct" (DM) atau "group" (obrolan grup)
match.peer.id: ID pengguna atau kode grup

Referensi konfigurasi

Konfigurasi lengkap: Konfigurasi Gateway

Pengaturan	Deskripsi	Default
`channels.yuanbao.enabled`	Aktifkan/nonaktifkan saluran	`true`
`channels.yuanbao.defaultAccount`	Akun default untuk perutean keluar	`default`
`channels.yuanbao.accounts.<id>.appKey`	App Key (digunakan untuk signing dan pembuatan tiket)	—
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (digunakan untuk signing)	—
`channels.yuanbao.accounts.<id>.token`	Token yang telah ditandatangani sebelumnya (melewati signing tiket otomatis)	—
`channels.yuanbao.accounts.<id>.name`	Nama tampilan akun	—
`channels.yuanbao.accounts.<id>.enabled`	Aktifkan/nonaktifkan akun tertentu	`true`
`channels.yuanbao.dm.policy`	Kebijakan DM	`open`
`channels.yuanbao.dm.allowFrom`	Allowlist DM (daftar ID pengguna)	—
`channels.yuanbao.requireMention`	Wajibkan @mention di grup	`true`
`channels.yuanbao.overflowPolicy`	Penanganan pesan panjang (`split` atau `stop`)	`split`
`channels.yuanbao.replyToMode`	Strategi reply-to grup (`off`, `first`, `all`)	`first`
`channels.yuanbao.outboundQueueStrategy`	Strategi keluar (`merge-text` atau `immediate`)	`merge-text`
`channels.yuanbao.minChars`	Merge-text: karakter minimum untuk memicu pengiriman	`2800`
`channels.yuanbao.maxChars`	Merge-text: karakter maksimum per pesan	`3000`
`channels.yuanbao.idleMs`	Merge-text: batas waktu idle sebelum auto-flush (md)	`5000`
`channels.yuanbao.mediaMaxMb`	Batas ukuran media (MB)	`20`
`channels.yuanbao.historyLimit`	Entri konteks riwayat obrolan grup	`100`
`channels.yuanbao.disableBlockStreaming`	Nonaktifkan output streaming tingkat blok	`false`
`channels.yuanbao.fallbackReply`	Balasan fallback saat AI tidak mengembalikan konten	`暂时无法解答，你可以换个问题问问我哦`
`channels.yuanbao.markdownHintEnabled`	Sisipkan instruksi anti-pembungkusan markdown	`true`
`channels.yuanbao.debugBotIds`	ID bot allowlist debug (log tidak disanitasi)	`[]`

Jenis pesan yang didukung

Terima

✅ Teks
✅ Gambar
✅ File
✅ Audio / Suara
✅ Video
✅ Stiker / Emoji khusus
✅ Elemen khusus (kartu tautan, dll.)

Kirim

✅ Teks (dengan dukungan markdown)
✅ Gambar
✅ File
✅ Audio
✅ Video
✅ Stiker

Thread dan balasan

✅ Balasan kutipan (dapat dikonfigurasi melalui replyToMode)
❌ Balasan thread (tidak didukung oleh platform)

Terkait

Ikhtisar Saluran — semua saluran yang didukung
Pairing — autentikasi DM dan alur pairing
Grup — perilaku obrolan grup dan gerbang mention
Perutean Saluran — perutean sesi untuk pesan
Keamanan — model akses dan pengerasan

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Yuanbao

Yuanbao

Mulai cepat

Penyiapan interaktif (alternatif)

Kontrol akses

Pesan langsung

Obrolan grup

Contoh konfigurasi

Penyiapan dasar dengan kebijakan DM terbuka

Batasi DM ke pengguna tertentu

Nonaktifkan persyaratan @mention di grup

Optimalkan pengiriman pesan keluar

Sesuaikan strategi merge-text

Perintah umum

Pemecahan masalah

Bot tidak merespons di obrolan grup

Bot tidak menerima pesan

Bot mengirim balasan kosong atau fallback

App Secret bocor

Konfigurasi lanjutan

Beberapa akun

Batas pesan

Streaming

Konteks riwayat obrolan grup

Mode reply-to

Injeksi petunjuk Markdown

Mode debug

Perutean multi-agen

Referensi konfigurasi

Jenis pesan yang didukung

Terima

Kirim

Thread dan balasan

Terkait

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Documentation Index

​Yuanbao

​Mulai cepat

​Penyiapan interaktif (alternatif)

​Kontrol akses

​Pesan langsung

​Obrolan grup

​Contoh konfigurasi

​Penyiapan dasar dengan kebijakan DM terbuka

​Batasi DM ke pengguna tertentu

​Nonaktifkan persyaratan @mention di grup

​Optimalkan pengiriman pesan keluar

​Sesuaikan strategi merge-text

​Perintah umum

​Pemecahan masalah

​Bot tidak merespons di obrolan grup

​Bot tidak menerima pesan

​Bot mengirim balasan kosong atau fallback

​App Secret bocor

​Konfigurasi lanjutan

​Beberapa akun

​Batas pesan

​Streaming

​Konteks riwayat obrolan grup

​Mode reply-to

​Injeksi petunjuk Markdown

​Mode debug

​Perutean multi-agen

​Referensi konfigurasi

​Jenis pesan yang didukung

​Terima

​Kirim

​Thread dan balasan

​Terkait

Yuanbao

Mulai cepat

Penyiapan interaktif (alternatif)

Kontrol akses

Pesan langsung

Obrolan grup

Contoh konfigurasi

Penyiapan dasar dengan kebijakan DM terbuka

Batasi DM ke pengguna tertentu

Nonaktifkan persyaratan @mention di grup

Optimalkan pengiriman pesan keluar

Sesuaikan strategi merge-text

Perintah umum

Pemecahan masalah

Bot tidak merespons di obrolan grup

Bot tidak menerima pesan

Bot mengirim balasan kosong atau fallback

App Secret bocor

Konfigurasi lanjutan

Beberapa akun

Batas pesan

Streaming

Konteks riwayat obrolan grup

Mode reply-to

Injeksi petunjuk Markdown

Mode debug

Perutean multi-agen

Referensi konfigurasi

Jenis pesan yang didukung

Terima

Kirim

Thread dan balasan

Terkait