Tencent Yuanbao는 Tencent의 AI 어시스턴트 플랫폼입니다. OpenClaw 채널 Plugin은 Yuanbao 봇을 WebSocket을 통해 OpenClaw에 연결하여 직접 메시지와 그룹 채팅으로 사용자와 상호작용할 수 있게 합니다. 상태: 봇 DM + 그룹 채팅에 프로덕션 사용 가능. WebSocket이 유일하게 지원되는 연결 모드입니다.Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
빠른 시작
OpenClaw 2026.4.10 이상이 필요합니다.openclaw --version을 실행해 확인하세요.openclaw update로 업그레이드하세요.
자격 증명으로 Yuanbao 채널 추가
--token 값은 콜론으로 구분된 appKey:appSecret 형식을 사용합니다. Yuanbao 앱의 애플리케이션 설정에서 로봇을 생성해 이 값을 얻을 수 있습니다.대화형 설정(대안)
대화형 마법사도 사용할 수 있습니다.접근 제어
직접 메시지
dmPolicy를 구성하여 봇에게 DM을 보낼 수 있는 사용자를 제어하세요.
"pairing"- 알 수 없는 사용자는 페어링 코드를 받으며, CLI로 승인합니다."allowlist"-allowFrom에 나열된 사용자만 채팅할 수 있습니다."open"- 모든 사용자를 허용합니다(기본값)."disabled"- 모든 DM을 비활성화합니다.
그룹 채팅
멘션 요구 사항(channels.yuanbao.requireMention):
true- @mention 필요(기본값)false- @mention 없이 응답
구성 예시
열린 DM 정책을 사용하는 기본 설정
특정 사용자로 DM 제한
그룹에서 @mention 요구 사항 비활성화
발신 메시지 전달 최적화
merge-text 전략 조정
일반 명령
| 명령 | 설명 |
|---|---|
/help | 사용 가능한 명령 표시 |
/status | 봇 상태 표시 |
/new | 새 세션 시작 |
/stop | 현재 실행 중지 |
/restart | OpenClaw 재시작 |
/compact | 세션 컨텍스트 압축 |
Yuanbao는 네이티브 슬래시 명령 메뉴를 지원합니다. Gateway가 시작될 때 명령이 플랫폼에 자동으로 동기화됩니다.
문제 해결
봇이 그룹 채팅에서 응답하지 않음
- 봇이 그룹에 추가되었는지 확인하세요.
- 봇을 @mention했는지 확인하세요(기본적으로 필요).
- 로그를 확인하세요:
openclaw logs --follow
봇이 메시지를 받지 못함
- Yuanbao 앱에서 봇이 생성되고 승인되었는지 확인하세요.
appKey와appSecret이 올바르게 구성되었는지 확인하세요.- Gateway가 실행 중인지 확인하세요:
openclaw gateway status - 로그를 확인하세요:
openclaw logs --follow
봇이 빈 응답이나 fallback 응답을 보냄
- AI 모델이 유효한 콘텐츠를 반환하는지 확인하세요.
- 기본 fallback 응답은 다음과 같습니다. “暂时无法解答,你可以换个问题问问我哦”
channels.yuanbao.fallbackReply로 사용자 지정하세요.
App Secret 유출
- YuanBao APP에서 App Secret을 재설정하세요.
- 구성의 값을 업데이트하세요.
- Gateway를 재시작하세요:
openclaw gateway restart
고급 구성
여러 계정
defaultAccount는 발신 API가 accountId를 지정하지 않을 때 사용할 계정을 제어합니다.
메시지 제한
maxChars- 단일 메시지 최대 문자 수(기본값:3000자)mediaMaxMb- 미디어 업로드/다운로드 제한(기본값:20MB)overflowPolicy- 메시지가 제한을 초과할 때의 동작:"split"(기본값) 또는"stop"
스트리밍
Yuanbao는 블록 수준 스트리밍 출력을 지원합니다. 활성화하면 봇은 텍스트를 생성하는 동안 청크 단위로 전송합니다.disableBlockStreaming: true를 설정하세요.
그룹 채팅 기록 컨텍스트
그룹 채팅의 AI 컨텍스트에 포함할 이전 메시지 수를 제어합니다.답장 대상 모드
그룹 채팅에서 답장할 때 봇이 메시지를 인용하는 방식을 제어합니다.| 값 | 동작 |
|---|---|
"off" | 인용 답장 없음 |
"first" | 수신 메시지당 첫 번째 답장만 인용(기본값) |
"all" | 모든 답장을 인용 |
Markdown 힌트 주입
기본적으로 봇은 AI 모델이 전체 답변을 markdown 코드 블록으로 감싸지 않도록 시스템 프롬프트에 지침을 주입합니다.디버그 모드
특정 봇 ID에 대해 정제되지 않은 로그 출력을 활성화합니다.멀티 에이전트 라우팅
bindings를 사용하여 Yuanbao DM 또는 그룹을 다른 에이전트로 라우팅합니다.
match.channel:"yuanbao"match.peer.kind:"direct"(DM) 또는"group"(그룹 채팅)match.peer.id: 사용자 ID 또는 그룹 코드
구성 참조
전체 구성: Gateway 구성| 설정 | 설명 | 기본값 |
|---|---|---|
channels.yuanbao.enabled | 채널 활성화/비활성화 | true |
channels.yuanbao.defaultAccount | 발신 라우팅의 기본 계정 | default |
channels.yuanbao.accounts.<id>.appKey | App Key(서명 및 티켓 생성에 사용) | - |
channels.yuanbao.accounts.<id>.appSecret | App Secret(서명에 사용) | - |
channels.yuanbao.accounts.<id>.token | 사전 서명된 토큰(자동 티켓 서명 건너뜀) | - |
channels.yuanbao.accounts.<id>.name | 계정 표시 이름 | - |
channels.yuanbao.accounts.<id>.enabled | 특정 계정 활성화/비활성화 | true |
channels.yuanbao.dm.policy | DM 정책 | open |
channels.yuanbao.dm.allowFrom | DM 허용 목록(사용자 ID 목록) | - |
channels.yuanbao.requireMention | 그룹에서 @mention 필요 | true |
channels.yuanbao.overflowPolicy | 긴 메시지 처리(split 또는 stop) | split |
channels.yuanbao.replyToMode | 그룹 답장 대상 전략(off, first, all) | first |
channels.yuanbao.outboundQueueStrategy | 발신 전략(merge-text 또는 immediate) | merge-text |
channels.yuanbao.minChars | Merge-text: 전송을 트리거할 최소 문자 수 | 2800 |
channels.yuanbao.maxChars | Merge-text: 메시지당 최대 문자 수 | 3000 |
channels.yuanbao.idleMs | Merge-text: 자동 플러시 전 유휴 시간 제한(ms) | 5000 |
channels.yuanbao.mediaMaxMb | 미디어 크기 제한(MB) | 20 |
channels.yuanbao.historyLimit | 그룹 채팅 기록 컨텍스트 항목 | 100 |
channels.yuanbao.disableBlockStreaming | 블록 수준 스트리밍 출력 비활성화 | false |
channels.yuanbao.fallbackReply | AI가 콘텐츠를 반환하지 않을 때의 fallback 응답 | 暂时无法解答,你可以换个问题问问我哦 |
channels.yuanbao.markdownHintEnabled | markdown 래핑 방지 지침 주입 | true |
channels.yuanbao.debugBotIds | 디버그 허용 목록 봇 ID(정제되지 않은 로그) | [] |
지원되는 메시지 유형
수신
- ✅ 텍스트
- ✅ 이미지
- ✅ 파일
- ✅ 오디오 / 음성
- ✅ 비디오
- ✅ 스티커 / 사용자 지정 이모지
- ✅ 사용자 지정 요소(링크 카드 등)
발신
- ✅ 텍스트(markdown 지원 포함)
- ✅ 이미지
- ✅ 파일
- ✅ 오디오
- ✅ 비디오
- ✅ 스티커
스레드와 답장
- ✅ 인용 답장(
replyToMode로 구성 가능) - ❌ 스레드 답장(플랫폼에서 지원하지 않음)