Yuanbao

기준일: 2026-07-26
공식 기준: Yuanbao

Yuanbao 문서는 OpenClaw 공식 문서(channels/yuanbao)를 한국어로 정리한 가이드입니다. Yuanbao bot overview, features, and configuration 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Yuanbao bot overview, features, and configuration

한국어 가이드 범위: channels/yuanbao 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• 빠른 시작
• Interactive setup (alternative)
• 접근 제어
• Direct messages
• Group chats
• Configuration examples
• Common commands
• 트러블슈팅
• Advanced configuration
• Multiple accounts
• Message limits
• Streaming
• Group chat history context
• Reply-to mode
• Markdown hint injection
• Debug mode
• Multi-agent routing
• Configuration reference
• Supported message types
• 관련 문서

상세 내용

본문

Tencent Yuanbao is Tencent's AI assistant platform. The community-maintained openclaw-plugin-yuanbao plugin connects Yuanbao bots to OpenClaw over WebSocket for direct messages and group chats.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

빠른 시작

Requires OpenClaw 2026.4.10 or above. Check with openclaw --version; upgrade with openclaw update.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

openclaw gateway restart

Interactive setup (alternative)

Follow the prompts to enter your App ID and App Secret.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw channels login --channel yuanbao

접근 제어

이 섹션의 세부 항목은 공식 문서 접근 제어를 참고하세요.

Direct messages

Value	Behavior
open (default)	Allow all users
pairing	Unknown users get a pairing code; approve via CLI
allowlist	Only users in allowFrom can chat
disabled	Disable all DMs

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

Group chats

channels.yuanbao.requireMention (default true): require an @mention before the bot responds in a group. Replying to the bot's own message is treated as an implicit mention.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Configuration examples

Disable the @mention requirement in groups:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  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, // buffer until this many chars
      maxChars: 3000, // force split above this limit
      idleMs: 5000, // auto-flush after idle timeout (ms)
    },
  },
}

Common commands

Yuanbao supports native slash-command menus; commands sync to the platform automatically when the gateway starts.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Command	Description
/help	Show available commands
/status	Show bot status
/new	Start a new session
/stop	Stop the current run
/restart	Restart OpenClaw
/compact	Compact the session context

트러블슈팅

1. Confirm the bot is added to the group 2. Confirm you @mention the bot (required by default) 3. Check logs: openclaw logs --follow

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Advanced configuration

이 섹션의 세부 항목은 공식 문서 Advanced configuration를 참고하세요.

Multiple accounts

defaultAccount controls which account is used when outbound APIs do not specify an accountId.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  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,
        },
      },
    },
  },
}

Message limits

주요 항목:

• maxChars: single message max character count (default 3000)
• mediaMaxMb: media upload/download limit (default 20 MB)
• overflowPolicy: behavior when a message exceeds the limit, "split" (default) or "stop"

Streaming

Yuanbao supports block-level streaming output; the bot sends text in chunks as it generates.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // block streaming enabled (default)
    },
  },
}

Group chat history context

Controls how many historical messages are included in the AI context for group chats.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  channels: {
    yuanbao: {
      historyLimit: 100, // default: 100, set 0 to disable
    },
  },
}

Reply-to mode

Value	Behavior
off	No quote reply
first	Quote only the first reply per inbound message (default)
all	Quote every reply

{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (default: "first")
    },
  },
}

Markdown hint injection

By default, the bot injects a system-prompt instruction to prevent the model from wrapping the entire reply in a markdown code block.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // default: true
    },
  },
}

Debug mode

Enables unsanitized log output for the listed bot IDs.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

Multi-agent routing

Use bindings to route Yuanbao DMs or groups to different agents:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• match.channel: "yuanbao"
• match.peer.kind: "direct" (DM) or "group" (group chat)
• match.peer.id: user ID or group code

{
  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" },
      },
    },
  ],
}

Configuration reference

Full configuration: Gateway configuration

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Setting	Description	Default
channels.yuanbao.enabled	Enable/disable the channel	true
channels.yuanbao.defaultAccount	Default account for outbound routing	default
channels.yuanbao.accounts.<id>.appKey	App Key (signing + ticket generation)	-
channels.yuanbao.accounts.<id>.appSecret	App Secret (signing)	-
channels.yuanbao.accounts.<id>.token	Pre-signed token (skips automatic ticket signing)	-
channels.yuanbao.accounts.<id>.name	Account display name	-
channels.yuanbao.accounts.<id>.enabled	Enable/disable a specific account	true
channels.yuanbao.dm.policy	DM policy	open
channels.yuanbao.dm.allowFrom	DM allowlist (user ID list)	-
channels.yuanbao.requireMention	Require @mention in groups	true
channels.yuanbao.overflowPolicy	Long message handling (split or stop)	split
channels.yuanbao.replyToMode	Group reply-to strategy (off, first, all)	first
channels.yuanbao.outboundQueueStrategy	Outbound strategy (merge-text or immediate)	merge-text
channels.yuanbao.minChars	Merge-text: min chars to trigger send	2800
channels.yuanbao.maxChars	Merge-text: max chars per message	3000
channels.yuanbao.idleMs	Merge-text: idle timeout before auto-flush (ms)	5000
channels.yuanbao.mediaMaxMb	Media size limit (MB)	20
channels.yuanbao.historyLimit	Group chat history context entries	100
channels.yuanbao.disableBlockStreaming	Disable block-level streaming output	false
channels.yuanbao.fallbackReply	Fallback reply when the model returns no content	暂时无法解答，你可以换个问题问问我哦
channels.yuanbao.markdownHintEnabled	Inject markdown anti-wrapping instructions	true
channels.yuanbao.debugBotIds	Debug allowlist bot IDs (unsanitized logs)	[]

Supported message types

Receive: text, images, files, audio/voice, video, stickers/custom emoji, custom elements (link cards).

Send: text (markdown), images, files, audio, video, stickers.

Threads and replies: quote replies (configurable via replyToMode); thread replies are not supported by the platform.

관련 문서

주요 항목:

• Channels Overview - all supported channels
• Pairing - DM authentication and pairing flow
• Groups - group chat behavior and mention gating
• Channel Routing - session routing for messages
• Security - access model and hardening

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/channels/yuanbao
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

openclaw gateway restart

openclaw channels login --channel yuanbao

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

{
  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
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.