Yuanbao

Tencent Yuanbao là nền tảng trợ lý AI của Tencent. Plugin openclaw-plugin-yuanbao do cộng đồng duy trì kết nối bot Yuanbao với OpenClaw qua WebSocket để nhắn tin trực tiếp và trò chuyện nhóm.

Trạng thái: sẵn sàng cho môi trường sản xuất đối với tin nhắn trực tiếp cho bot và trò chuyện nhóm. WebSocket là chế độ kết nối duy nhất được hỗ trợ. Plugin này do nhóm Tencent Yuanbao duy trì dưới dạng một mục danh mục bên ngoài, không phải bởi phần lõi OpenClaw; các chi tiết về cấu hình/hành vi bên dưới (ngoài phần cài đặt và giao diện CLI chung) đến từ tài liệu riêng của plugin và chưa được xác minh dựa trên mã nguồn lõi OpenClaw.

Bắt đầu nhanh

Yêu cầu OpenClaw 2026.4.10 trở lên. Kiểm tra bằng openclaw --version; nâng cấp bằng openclaw update.

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

openclaw gateway restart

Thiết lập tương tác (phương án thay thế)

openclaw channels login --channel yuanbao

Làm theo lời nhắc để nhập App ID và App Secret.

Kiểm soát truy cập

Tin nhắn trực tiếp

channels.yuanbao.dm.policy:

Phê duyệt yêu cầu ghép nối:

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

Trò chuyện nhóm

channels.yuanbao.requireMention (mặc định true): yêu cầu @đề cập trước khi bot phản hồi trong nhóm. Việc trả lời chính tin nhắn của bot được coi là một lượt đề cập ngầm.

Ví dụ cấu hình

Thiết lập cơ bản, chính sách tin nhắn trực tiếp mở:

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

Giới hạn tin nhắn trực tiếp cho những người dùng cụ thể:

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

Tắt yêu cầu @đề cập trong nhóm:

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

Tinh chỉnh việc gửi đi:

{  channels: {    yuanbao: {      outboundQueueStrategy: "merge-text",      minChars: 2800, // lưu vào bộ đệm cho đến khi đạt số ký tự này      maxChars: 3000, // buộc chia nhỏ khi vượt quá giới hạn này      idleMs: 5000, // tự động đẩy sau thời gian chờ không hoạt động (ms)    },  },}

Đặt outboundQueueStrategy: "immediate" để gửi từng phần mà không lưu vào bộ đệm.

Các lệnh thường dùng

Yuanbao hỗ trợ menu lệnh gạch chéo nguyên bản; các lệnh tự động đồng bộ với nền tảng khi Gateway khởi động.

Khắc phục sự cố

Bot không phản hồi trong trò chuyện nhóm:

1. Xác nhận bot đã được thêm vào nhóm
2. Xác nhận bạn @đề cập bot (được yêu cầu theo mặc định)
3. Kiểm tra nhật ký: openclaw logs --follow

Bot không nhận được tin nhắn:

1. Xác nhận bot đã được tạo và phê duyệt trong ứng dụng Yuanbao
2. Xác nhận appKey và appSecret được cấu hình chính xác
3. Xác nhận Gateway đang chạy: openclaw gateway status
4. Kiểm tra nhật ký: openclaw logs --follow

Bot gửi phản hồi trống hoặc phản hồi dự phòng:

1. Kiểm tra xem mô hình AI có trả về nội dung hợp lệ hay không
2. Phản hồi dự phòng mặc định: "暂时无法解答，你可以换个问题问问我哦"
3. Tùy chỉnh bằng channels.yuanbao.fallbackReply

App Secret bị rò rỉ:

1. Đặt lại App Secret trong ứng dụng Yuanbao
2. Cập nhật giá trị trong cấu hình của bạn
3. Khởi động lại Gateway: openclaw gateway restart

Cấu hình nâng cao

Nhiều tài khoản

{  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 kiểm soát tài khoản được sử dụng khi các API gửi đi không chỉ định accountId.

Giới hạn tin nhắn

• maxChars: số ký tự tối đa của một tin nhắn (mặc định 3000)
• mediaMaxMb: giới hạn tải lên/tải xuống phương tiện (mặc định 20 MB)
• overflowPolicy: hành vi khi tin nhắn vượt quá giới hạn, "split" (mặc định) hoặc "stop"

Truyền phát

Yuanbao hỗ trợ đầu ra truyền phát theo cấp khối; bot gửi văn bản thành từng phần trong quá trình tạo.

{  channels: {    yuanbao: {      disableBlockStreaming: false, // bật truyền phát theo khối (mặc định)    },  },}

Đặt disableBlockStreaming: true để gửi toàn bộ phản hồi trong một tin nhắn.

Ngữ cảnh lịch sử trò chuyện nhóm

{  channels: {    yuanbao: {      historyLimit: 100, // mặc định: 100, đặt thành 0 để tắt    },  },}

Kiểm soát số lượng tin nhắn lịch sử được đưa vào ngữ cảnh AI cho các cuộc trò chuyện nhóm.

Chế độ trả lời tin nhắn

{  channels: {    yuanbao: {      replyToMode: "first", // "off" | "first" | "all" (mặc định: "first")    },  },}

Chèn gợi ý Markdown

Theo mặc định, bot chèn một chỉ dẫn vào lời nhắc hệ thống để ngăn mô hình bao bọc toàn bộ phản hồi trong một khối mã markdown.

{  channels: {    yuanbao: {      markdownHintEnabled: true, // mặc định: true    },  },}

Chế độ gỡ lỗi

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

Bật đầu ra nhật ký chưa được làm sạch cho các ID bot được liệt kê.

Định tuyến đa tác tử

Sử dụng bindings để định tuyến tin nhắn trực tiếp hoặc nhóm Yuanbao đến các tác tử khác nhau:

{  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" (tin nhắn trực tiếp) hoặc "group" (trò chuyện nhóm)
• match.peer.id: ID người dùng hoặc mã nhóm

Tham chiếu cấu hình

Cấu hình đầy đủ: Cấu hình Gateway

Các loại tin nhắn được hỗ trợ

Nhận: văn bản, hình ảnh, tệp, âm thanh/giọng nói, video, nhãn dán/biểu tượng cảm xúc tùy chỉnh, phần tử tùy chỉnh (thẻ liên kết).

Gửi: văn bản (markdown), hình ảnh, tệp, âm thanh, video, nhãn dán.

Luồng và phản hồi: phản hồi trích dẫn (có thể cấu hình qua replyToMode); nền tảng không hỗ trợ phản hồi theo luồng.

Liên quan

• Tổng quan về các kênh - tất cả các kênh được hỗ trợ
• Ghép nối - quy trình xác thực và ghép nối tin nhắn trực tiếp
• Nhóm - hành vi trò chuyện nhóm và kiểm soát bằng yêu cầu đề cập
• Định tuyến kênh - định tuyến phiên cho tin nhắn
• Bảo mật - mô hình truy cập và tăng cường bảo mật