Yuanbao

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.

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

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

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

# Pemecahan masalah

# Bot tidak merespons dalam obrolan grup

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

# Bot tidak menerima pesan

1. Pastikan bot dibuat dan disetujui di aplikasi Yuanbao
2. Pastikan appKey dan appSecret dikonfigurasi dengan benar
3. Pastikan Gateway berjalan: openclaw gateway status
4. Periksa log: openclaw logs --follow

# Bot mengirim balasan kosong atau fallback

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

# App Secret bocor

1. Reset App Secret di YuanBao APP
2. Perbarui nilainya di konfigurasi Anda
3. 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")
    },
  },
}

# 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

# 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