Yuanbao - OpenClaw

Tencent Yuanbao adalah platform asisten AI Tencent. Plugin saluran OpenClaw menghubungkan bot Yuanbao ke OpenClaw melalui WebSocket sehingga 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 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 dapat memperolehnya 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 penyebutan (channels.yuanbao.requireMention):

true - memerlukan @mention (default)
false - merespons tanpa @mention

Membalas pesan bot dalam obrolan grup diperlakukan sebagai penyebutan 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 proses saat ini
`/restart`	Mulai ulang OpenClaw
`/compact`	Ringkas konteks sesi

Yuanbao mendukung menu perintah slash native. Perintah disinkronkan ke platform secara otomatis saat Gateway dimulai.

Pemecahan masalah

Bot tidak merespons dalam obrolan grup

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

Bot tidak menerima pesan

Pastikan bot 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 nilainya 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 yang digunakan saat API keluar tidak menentukan accountId.

Batas pesan

maxChars - jumlah karakter maksimum pesan tunggal (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 dihasilkan.

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

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

Konteks riwayat obrolan grup

Kontrol jumlah 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 tanpa sanitasi untuk ID bot tertentu:

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

Routing multi-agen

Gunakan bindings untuk merutekan DM atau grup Yuanbao ke agen yang 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 routing:

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 routing keluar	`default`
`channels.yuanbao.accounts.<id>.appKey`	App Key (digunakan untuk penandatanganan dan pembuatan ticket)	-
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (digunakan untuk penandatanganan)	-
`channels.yuanbao.accounts.<id>.token`	Token pra-tanda tangan (melewati penandatanganan ticket 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 min untuk memicu pengiriman	`2800`
`channels.yuanbao.maxChars`	Merge-text: karakter maks per pesan	`3000`
`channels.yuanbao.idleMs`	Merge-text: batas waktu idle sebelum auto-flush (ms)	`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 tanpa sanitasi)	`[]`

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 gating penyebutan
Routing Saluran - routing sesi untuk pesan
Keamanan - model akses dan hardening

Documentation Index

​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 dalam 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

​Routing multi-agen

​Referensi konfigurasi

​Jenis pesan yang didukung

​Terima

​Kirim

​Thread dan balasan

​Terkait