หยวนเป่า

Tencent Yuanbao เป็นแพลตฟอร์มผู้ช่วย AI ของ Tencent โดย Plugin openclaw-plugin-yuanbao ที่ดูแลโดยชุมชนจะเชื่อมต่อบอต Yuanbao กับ OpenClaw ผ่าน WebSocket สำหรับข้อความส่วนตัวและแชตกลุ่ม

สถานะ: พร้อมใช้งานจริงสำหรับข้อความส่วนตัวถึงบอตและแชตกลุ่ม WebSocket เป็นโหมดการเชื่อมต่อเดียวที่รองรับ Plugin นี้ดูแลโดยทีม Tencent Yuanbao ในฐานะรายการแค็ตตาล็อกภายนอก ไม่ได้ดูแลโดยแกนหลักของ OpenClaw รายละเอียดการกำหนดค่าและพฤติกรรมด้านล่าง (นอกเหนือจากการติดตั้งและส่วนติดต่อ CLI ทั่วไป) มาจากเอกสารของ Plugin เอง และยังไม่ได้ตรวจสอบเทียบกับซอร์สของแกนหลัก OpenClaw

เริ่มต้นอย่างรวดเร็ว

ต้องใช้ OpenClaw 2026.4.10 ขึ้นไป ตรวจสอบด้วย openclaw --version และอัปเกรดด้วย openclaw update

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

openclaw gateway restart

การตั้งค่าแบบโต้ตอบ (ทางเลือก)

openclaw channels login --channel yuanbao

ทำตามข้อความแจ้งเพื่อป้อน App ID และ App Secret ของคุณ

การควบคุมการเข้าถึง

ข้อความส่วนตัว

channels.yuanbao.dm.policy:

อนุมัติคำขอจับคู่:

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

แชตกลุ่ม

channels.yuanbao.requireMention (ค่าเริ่มต้น true): กำหนดให้ต้อง @กล่าวถึงก่อนที่บอตจะตอบในกลุ่ม การตอบกลับข้อความของบอตเองจะถือเป็นการกล่าวถึงโดยปริยาย

ตัวอย่างการกำหนดค่า

การตั้งค่าพื้นฐานพร้อมนโยบายข้อความส่วนตัวแบบเปิด:

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

จำกัดข้อความส่วนตัวไว้เฉพาะผู้ใช้ที่ระบุ:

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

ปิดข้อกำหนดการ @กล่าวถึงในกลุ่ม:

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

ปรับแต่งการส่งขาออก:

{  channels: {    yuanbao: {      outboundQueueStrategy: "merge-text",      minChars: 2800, // พักข้อมูลจนกว่าจะมีจำนวนอักขระเท่านี้      maxChars: 3000, // บังคับแบ่งเมื่อเกินขีดจำกัดนี้      idleMs: 5000, // ส่งข้อมูลที่พักไว้โดยอัตโนมัติหลังหมดเวลาว่าง (มิลลิวินาที)    },  },}

ตั้งค่า outboundQueueStrategy: "immediate" เพื่อส่งแต่ละส่วนทันทีโดยไม่พักข้อมูล

คำสั่งทั่วไป

Yuanbao รองรับเมนูคำสั่งแบบสแลชดั้งเดิม โดยคำสั่งจะซิงค์ไปยังแพลตฟอร์มโดยอัตโนมัติเมื่อ Gateway เริ่มทำงาน

การแก้ไขปัญหา

บอตไม่ตอบในแชตกลุ่ม:

1. ยืนยันว่าเพิ่มบอตลงในกลุ่มแล้ว
2. ยืนยันว่าคุณ @กล่าวถึงบอต (จำเป็นโดยค่าเริ่มต้น)
3. ตรวจสอบบันทึก: openclaw logs --follow

บอตไม่ได้รับข้อความ:

1. ยืนยันว่าสร้างและอนุมัติบอตในแอป Yuanbao แล้ว
2. ยืนยันว่ากำหนดค่า appKey และ appSecret อย่างถูกต้อง
3. ยืนยันว่า Gateway กำลังทำงาน: openclaw gateway status
4. ตรวจสอบบันทึก: openclaw logs --follow

บอตส่งคำตอบว่างหรือคำตอบสำรอง:

1. ตรวจสอบว่าโมเดล AI ส่งคืนเนื้อหาที่ถูกต้องหรือไม่
2. คำตอบสำรองเริ่มต้น: "暂时无法解答，你可以换个问题问问我哦"
3. ปรับแต่งด้วย channels.yuanbao.fallbackReply

App Secret รั่วไหล:

1. รีเซ็ต App Secret ในแอป Yuanbao
2. อัปเดตค่าในการกำหนดค่าของคุณ
3. รีสตาร์ต Gateway: openclaw gateway restart

การกำหนดค่าขั้นสูง

หลายบัญชี

{  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 ควบคุมว่าจะใช้บัญชีใดเมื่อ API ขาออกไม่ได้ระบุ accountId

ขีดจำกัดข้อความ

• maxChars: จำนวนอักขระสูงสุดต่อข้อความ (ค่าเริ่มต้น 3000)
• mediaMaxMb: ขีดจำกัดการอัปโหลด/ดาวน์โหลดสื่อ (ค่าเริ่มต้น 20 MB)
• overflowPolicy: พฤติกรรมเมื่อข้อความเกินขีดจำกัด ได้แก่ "split" (ค่าเริ่มต้น) หรือ "stop"

การสตรีม

Yuanbao รองรับเอาต์พุตแบบสตรีมระดับบล็อก โดยบอตจะส่งข้อความเป็นส่วน ๆ ระหว่างที่สร้างข้อความ

{  channels: {    yuanbao: {      disableBlockStreaming: false, // เปิดใช้งานการสตรีมแบบบล็อก (ค่าเริ่มต้น)    },  },}

ตั้งค่า disableBlockStreaming: true เพื่อส่งคำตอบที่สมบูรณ์ในข้อความเดียว

บริบทประวัติแชตกลุ่ม

{  channels: {    yuanbao: {      historyLimit: 100, // ค่าเริ่มต้น: 100 ตั้งเป็น 0 เพื่อปิดใช้งาน    },  },}

ควบคุมจำนวนข้อความย้อนหลังที่จะรวมไว้ในบริบท AI สำหรับแชตกลุ่ม

โหมดตอบกลับข้อความ

{  channels: {    yuanbao: {      replyToMode: "first", // "off" | "first" | "all" (ค่าเริ่มต้น: "first")    },  },}

การแทรกคำแนะนำ Markdown

โดยค่าเริ่มต้น บอตจะแทรกคำสั่งในพรอมต์ระบบเพื่อป้องกันไม่ให้โมเดลครอบคำตอบทั้งหมดไว้ในบล็อกโค้ด Markdown

{  channels: {    yuanbao: {      markdownHintEnabled: true, // ค่าเริ่มต้น: true    },  },}

โหมดแก้ไขข้อบกพร่อง

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

เปิดใช้งานเอาต์พุตบันทึกที่ไม่ได้กรองข้อมูลละเอียดอ่อนสำหรับ ID บอตที่ระบุ

การกำหนดเส้นทางหลายเอเจนต์

ใช้ bindings เพื่อกำหนดเส้นทางข้อความส่วนตัวหรือกลุ่มของ Yuanbao ไปยังเอเจนต์ต่าง ๆ:

{  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" (ข้อความส่วนตัว) หรือ "group" (แชตกลุ่ม)
• match.peer.id: ID ผู้ใช้หรือรหัสกลุ่ม

ข้อมูลอ้างอิงการกำหนดค่า

การกำหนดค่าฉบับเต็ม: การกำหนดค่า Gateway

ประเภทข้อความที่รองรับ

รับ: ข้อความ รูปภาพ ไฟล์ เสียง/ข้อความเสียง วิดีโอ สติกเกอร์/อีโมจิที่กำหนดเอง และองค์ประกอบที่กำหนดเอง (การ์ดลิงก์)

ส่ง: ข้อความ (Markdown) รูปภาพ ไฟล์ เสียง วิดีโอ และสติกเกอร์

เธรดและการตอบกลับ: รองรับการตอบกลับแบบอ้างอิงข้อความ (กำหนดค่าได้ผ่าน replyToMode) แต่แพลตฟอร์มไม่รองรับการตอบกลับในเธรด

ที่เกี่ยวข้อง

• ภาพรวมช่องทาง - ช่องทางทั้งหมดที่รองรับ
• การจับคู่ - การยืนยันตัวตนข้อความส่วนตัวและขั้นตอนการจับคู่
• กลุ่ม - พฤติกรรมแชตกลุ่มและการควบคุมด้วยการกล่าวถึง
• การกำหนดเส้นทางช่องทาง - การกำหนดเส้นทางเซสชันสำหรับข้อความ
• ความปลอดภัย - โมเดลการเข้าถึงและการเสริมความปลอดภัย