위안바오

Tencent Yuanbao는 Tencent의 AI 어시스턴트 플랫폼입니다. 커뮤니티에서 유지 관리하는 openclaw-plugin-yuanbao Plugin은 WebSocket을 통해 Yuanbao 봇을 OpenClaw에 연결하여 다이렉트 메시지와 그룹 채팅을 지원합니다.

상태: 봇 DM과 그룹 채팅에 프로덕션 환경에서 사용할 수 있습니다. 지원되는 연결 모드는 WebSocket뿐입니다. 이 Plugin은 OpenClaw 코어가 아닌 Tencent Yuanbao 팀이 외부 카탈로그 항목으로 유지 관리합니다. 아래의 구성 및 동작 세부 정보(설치 및 일반 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): 그룹에서 봇이 응답하기 전에 @멘션이 필요합니다. 봇 자체 메시지에 답장하면 암시적 멘션으로 처리됩니다.

구성 예시

기본 설정과 개방형 DM 정책:

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

특정 사용자로 DM을 제한합니다.

{  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, // 유휴 시간 제한 후 자동 플러시(ms)    },  },}

버퍼링하지 않고 각 청크를 전송하려면 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. Yuanbao 앱에서 App Secret을 재설정합니다
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,        },      },    },  },}

발신 API에서 accountId를 지정하지 않을 때 사용할 계정은 defaultAccount가 제어합니다.

메시지 한도

• 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 DM 또는 그룹을 서로 다른 에이전트로 라우팅합니다.

{  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"(DM) 또는 "group"(그룹 채팅)
• match.peer.id: 사용자 ID 또는 그룹 코드

구성 참조

전체 구성: Gateway 구성

지원되는 메시지 유형

수신: 텍스트, 이미지, 파일, 오디오/음성, 동영상, 스티커/사용자 지정 이모지, 사용자 지정 요소(링크 카드).

전송: 텍스트(Markdown), 이미지, 파일, 오디오, 동영상, 스티커.

스레드와 답장: 인용 답장(replyToMode로 구성 가능)을 지원합니다. 플랫폼은 스레드 답장을 지원하지 않습니다.

관련 문서

• 채널 개요 - 지원되는 모든 채널
• 페어링 - DM 인증 및 페어링 흐름
• 그룹 - 그룹 채팅 동작 및 멘션 제어
• 채널 라우팅 - 메시지의 세션 라우팅
• 보안 - 액세스 모델 및 보안 강화