OpenClaw 接入腾讯元宝Yuanbao频道WebSocket 机器人配置、访问控制与高级调优指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw腾讯元宝Yuanbao是腾讯推出的 AI 智能助手平台通过社区维护的openclaw-plugin-yuanbao外部插件OpenClaw 可以与元宝机器人建立 WebSocket 连接实现私聊DM与群聊场景下的 AI 自动化对话。本文将基于 docs/channels/yuanbao.md 的完整内容结合仓库内频道、配对、群组、路由与 CLI 相关文档从快速接入、访问控制、配置参数、常用命令到多账号与多 Agent 路由系统讲解在 OpenClaw 中启用和调优元宝频道的完整方案读完即可落地一个生产可用的元宝机器人。适用前提与状态说明元宝频道要求 OpenClaw 2026.4.10 及以上版本WebSocket 是唯一受支持的连接方式。该插件由腾讯元宝团队作为外部目录条目维护并非 OpenClaw 核心自带除安装步骤与通用 CLI 面之外下述配置与行为细节来自插件自身文档未在 OpenClaw 核心源码中逐一验证配置时请以实际插件版本行为为准。快速开始三步接入元宝机器人接入前先确认 OpenClaw 版本满足要求openclaw --version # 确认版本 2026.4.10 openclaw update # 版本过低时升级方式一非交互式添加频道推荐脚本化使用openclaw channels add直接写入凭据并添加频道openclaw channels add --channel yuanbao --token appKey:appSecret--token采用冒号分隔的appKey:appSecret格式。这两个值需要在元宝应用中创建机器人后从应用设置中获取。添加完成后必须重启网关使新账号生效openclaw gateway restartopenclaw gateway restart会保留既有的安全safe、强制forced与有界等待bounded-wait行为具体机制可参考 网关重启与守护文档。方式二交互式登录openclaw channels login --channel yuanbao按提示依次输入 App KeyappKey与 App SecretappSecret即可。关于频道账号管理openclaw channels还提供一系列配套命令见 CLI 频道参考openclaw channels list # 查看已配置账号与启用状态 openclaw channels status --probe # 对网关上的账号做实时探测 openclaw channels logs --channel yuanbao # 查看该频道子系统日志默认 200 行访问控制私聊策略与群聊 提及私聊DM访问策略通过channels.yuanbao.dm.policy控制谁可以向机器人发送私聊消息值行为open默认允许所有用户pairing未知用户会获得配对码需通过 CLI 审批allowlist仅allowFrom中列出的用户可以对话disabled完全禁用私聊当策略为pairing时未知发送者会收到一个 8 位大写配对码不含0O1I等易混淆字符配对码 1 小时过期且每个频道账号待审批请求上限为 3 个该消息在你审批之前不会被处理。审批命令如下openclaw pairing list yuanbao openclaw pairing approve yuanbao CODE配对流程的完整安全模型见 配对文档。需要留意CLI 审批在未配置命令拥有者时会自动把首个被批准者引导为commands.ownerAllowFrom的拥有者便于后续执行特权命令而手动加入allowFrom的发送者不会自动成为命令拥有者。open策略仅在有效 DM 白名单包含*通配符时才真正对所有用户开放若open同时配置了具体的allowFrom条目运行时仍只放行这些发送者。群聊 提及要求channels.yuanbao.requireMention默认true要求机器人在群聊中必须被 提及后才响应。回复机器人自己的消息会被视为隐式提及。这与 OpenClaw 跨频道的群组规则一致默认群聊是受限的回复需要提及mention gating最终回复文本自动发布到房间详见 群组文档。配置示例从基础到出站调优以下 JSON5 配置统一写入 OpenClaw 的网关配置文件中完整配置结构见 Gateway 配置。基础配置开放私聊策略{ 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) }, }, }merge-text策略会把多个文本块合并缓冲达到minChars或空闲超过idleMs后自动发送单条消息超过maxChars则强制拆分若希望每个块生成后立即发送设置outboundQueueStrategy: immediate即可。这类缓冲参数与 OpenClaw 核心的 block streaming 合并策略blockStreamingCoalesce.idleMs等理念一致可参考 配置示例文档 中的完整模型调优样板。常用命令元宝支持平台原生斜杠命令菜单网关启动时命令会自动同步到平台命令说明/help显示可用命令/status显示机器人状态/new开启新会话/stop停止当前运行/restart重启 OpenClaw/compact压缩会话上下文故障排查机器人在群聊中无响应确认机器人已加入群聊确认你 提及了机器人默认必需查看日志openclaw logs --follow机器人收不到消息确认机器人已在元宝应用中创建并通过审批确认appKey与appSecret配置正确确认网关正在运行openclaw gateway status查看日志openclaw logs --follow机器人返回空回复或兜底回复检查 AI 模型是否返回了有效内容默认兜底回复为「暂时无法解答你可以换个问题问问我哦」通过channels.yuanbao.fallbackReply自定义兜底文案App Secret 泄露在元宝应用中重置 App Secret更新配置文件中的对应值重启网关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单条消息最大字符数默认3000mediaMaxMb媒体上传/下载大小限制默认20MBoverflowPolicy消息超限时的处理策略split默认拆分或stop停止发送分块流式输出元宝支持块级block-level流式输出机器人生成过程中以文本块形式逐段发送{ channels: { yuanbao: { disableBlockStreaming: false, // block streaming enabled (default) }, }, }设置disableBlockStreaming: true则整条回复合并为一条消息发送。群聊历史上下文{ channels: { yuanbao: { historyLimit: 100, // default: 100, set 0 to disable }, }, }控制群聊中纳入 AI 上下文的历史消息条数设为0可完全关闭。引用回复模式{ channels: { yuanbao: { replyToMode: first, // off | first | all (default: first) }, }, }值行为off不发送引用回复first每条入站消息仅第一条回复带引用默认all每条回复都带引用Markdown 防包裹提示注入默认情况下机器人会向系统提示中注入一条指令防止模型把整条回复包进 markdown 代码块{ channels: { yuanbao: { markdownHintEnabled: true, // default: true }, }, }调试模式{ channels: { yuanbao: { debugBotIds: [bot_user_id_1, bot_user_id_2], }, }, }为列出的机器人 ID 输出未脱敏的日志便于排查问题。多 Agent 路由bindings使用bindings把元宝的私聊或群聊路由到不同 Agent{ agents: { entries: { main: { default: true }, agent-a: { workspace: /home/user/agent-a }, 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.channelyuanbaomatch.peer.kinddirect私聊或group群聊match.peer.id用户 ID 或群组编码bindings 是 OpenClaw 将入站频道/账号/对端映射到具体 Agent 的通用机制会话键、精确对端匹配peer.kindpeer.id与通配匹配的完整说明见 频道路由文档。配置参考完整参数表设置说明默认值channels.yuanbao.enabled启用/禁用频道truechannels.yuanbao.defaultAccount出站路由的默认账号defaultchannels.yuanbao.accounts.id.appKeyApp Key签名 票据生成-channels.yuanbao.accounts.id.appSecretApp Secret签名-channels.yuanbao.accounts.id.token预签名 token跳过自动票据签名-channels.yuanbao.accounts.id.name账号显示名称-channels.yuanbao.accounts.id.enabled启用/禁用指定账号truechannels.yuanbao.dm.policy私聊策略openchannels.yuanbao.dm.allowFrom私聊白名单用户 ID 列表-channels.yuanbao.requireMention群聊要求 提及truechannels.yuanbao.overflowPolicy长消息处理split或stopsplitchannels.yuanbao.replyToMode群聊引用回复策略off、first、allfirstchannels.yuanbao.outboundQueueStrategy出站策略merge-text或immediatemerge-textchannels.yuanbao.minCharsmerge-text触发发送的最小字符数2800channels.yuanbao.maxCharsmerge-text单条消息最大字符数3000channels.yuanbao.idleMsmerge-text自动冲刷的空闲超时毫秒5000channels.yuanbao.mediaMaxMb媒体大小限制MB20channels.yuanbao.historyLimit群聊历史上下文条数100channels.yuanbao.disableBlockStreaming禁用块级流式输出falsechannels.yuanbao.fallbackReply模型无内容时的兜底回复暂时无法解答你可以换个问题问问我哦channels.yuanbao.markdownHintEnabled注入 markdown 防包裹指令truechannels.yuanbao.debugBotIds调试白名单机器人 ID未脱敏日志[]支持的消息类型接收文本、图片、文件、语音、视频、表情包/自定义表情、自定义元素链接卡片。发送文本markdown、图片、文件、语音、视频、表情包。线程与回复支持引用回复通过replyToMode配置平台不支持线程回复。延伸阅读频道总览 —— 全部受支持频道元宝为外部插件条目配对机制 —— 私聊认证与配对流程群组行为 —— 群聊行为与提及门控频道路由 —— 消息的会话路由与 bindings 匹配安全模型 —— 访问模型与加固建议CLI 频道参考 ——openclaw channels全量命令CLI 配对参考 ——openclaw pairing全量命令【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenClaw 接入腾讯元宝（Yuanbao）频道：WebSocket 机器人配置、访问控制与高级调优指南
OpenClaw 接入腾讯元宝Yuanbao频道WebSocket 机器人配置、访问控制与高级调优指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw腾讯元宝Yuanbao是腾讯推出的 AI 智能助手平台通过社区维护的openclaw-plugin-yuanbao外部插件OpenClaw 可以与元宝机器人建立 WebSocket 连接实现私聊DM与群聊场景下的 AI 自动化对话。本文将基于 docs/channels/yuanbao.md 的完整内容结合仓库内频道、配对、群组、路由与 CLI 相关文档从快速接入、访问控制、配置参数、常用命令到多账号与多 Agent 路由系统讲解在 OpenClaw 中启用和调优元宝频道的完整方案读完即可落地一个生产可用的元宝机器人。适用前提与状态说明元宝频道要求 OpenClaw 2026.4.10 及以上版本WebSocket 是唯一受支持的连接方式。该插件由腾讯元宝团队作为外部目录条目维护并非 OpenClaw 核心自带除安装步骤与通用 CLI 面之外下述配置与行为细节来自插件自身文档未在 OpenClaw 核心源码中逐一验证配置时请以实际插件版本行为为准。快速开始三步接入元宝机器人接入前先确认 OpenClaw 版本满足要求openclaw --version # 确认版本 2026.4.10 openclaw update # 版本过低时升级方式一非交互式添加频道推荐脚本化使用openclaw channels add直接写入凭据并添加频道openclaw channels add --channel yuanbao --token appKey:appSecret--token采用冒号分隔的appKey:appSecret格式。这两个值需要在元宝应用中创建机器人后从应用设置中获取。添加完成后必须重启网关使新账号生效openclaw gateway restartopenclaw gateway restart会保留既有的安全safe、强制forced与有界等待bounded-wait行为具体机制可参考 网关重启与守护文档。方式二交互式登录openclaw channels login --channel yuanbao按提示依次输入 App KeyappKey与 App SecretappSecret即可。关于频道账号管理openclaw channels还提供一系列配套命令见 CLI 频道参考openclaw channels list # 查看已配置账号与启用状态 openclaw channels status --probe # 对网关上的账号做实时探测 openclaw channels logs --channel yuanbao # 查看该频道子系统日志默认 200 行访问控制私聊策略与群聊 提及私聊DM访问策略通过channels.yuanbao.dm.policy控制谁可以向机器人发送私聊消息值行为open默认允许所有用户pairing未知用户会获得配对码需通过 CLI 审批allowlist仅allowFrom中列出的用户可以对话disabled完全禁用私聊当策略为pairing时未知发送者会收到一个 8 位大写配对码不含0O1I等易混淆字符配对码 1 小时过期且每个频道账号待审批请求上限为 3 个该消息在你审批之前不会被处理。审批命令如下openclaw pairing list yuanbao openclaw pairing approve yuanbao CODE配对流程的完整安全模型见 配对文档。需要留意CLI 审批在未配置命令拥有者时会自动把首个被批准者引导为commands.ownerAllowFrom的拥有者便于后续执行特权命令而手动加入allowFrom的发送者不会自动成为命令拥有者。open策略仅在有效 DM 白名单包含*通配符时才真正对所有用户开放若open同时配置了具体的allowFrom条目运行时仍只放行这些发送者。群聊 提及要求channels.yuanbao.requireMention默认true要求机器人在群聊中必须被 提及后才响应。回复机器人自己的消息会被视为隐式提及。这与 OpenClaw 跨频道的群组规则一致默认群聊是受限的回复需要提及mention gating最终回复文本自动发布到房间详见 群组文档。配置示例从基础到出站调优以下 JSON5 配置统一写入 OpenClaw 的网关配置文件中完整配置结构见 Gateway 配置。基础配置开放私聊策略{ 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) }, }, }merge-text策略会把多个文本块合并缓冲达到minChars或空闲超过idleMs后自动发送单条消息超过maxChars则强制拆分若希望每个块生成后立即发送设置outboundQueueStrategy: immediate即可。这类缓冲参数与 OpenClaw 核心的 block streaming 合并策略blockStreamingCoalesce.idleMs等理念一致可参考 配置示例文档 中的完整模型调优样板。常用命令元宝支持平台原生斜杠命令菜单网关启动时命令会自动同步到平台命令说明/help显示可用命令/status显示机器人状态/new开启新会话/stop停止当前运行/restart重启 OpenClaw/compact压缩会话上下文故障排查机器人在群聊中无响应确认机器人已加入群聊确认你 提及了机器人默认必需查看日志openclaw logs --follow机器人收不到消息确认机器人已在元宝应用中创建并通过审批确认appKey与appSecret配置正确确认网关正在运行openclaw gateway status查看日志openclaw logs --follow机器人返回空回复或兜底回复检查 AI 模型是否返回了有效内容默认兜底回复为「暂时无法解答你可以换个问题问问我哦」通过channels.yuanbao.fallbackReply自定义兜底文案App Secret 泄露在元宝应用中重置 App Secret更新配置文件中的对应值重启网关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单条消息最大字符数默认3000mediaMaxMb媒体上传/下载大小限制默认20MBoverflowPolicy消息超限时的处理策略split默认拆分或stop停止发送分块流式输出元宝支持块级block-level流式输出机器人生成过程中以文本块形式逐段发送{ channels: { yuanbao: { disableBlockStreaming: false, // block streaming enabled (default) }, }, }设置disableBlockStreaming: true则整条回复合并为一条消息发送。群聊历史上下文{ channels: { yuanbao: { historyLimit: 100, // default: 100, set 0 to disable }, }, }控制群聊中纳入 AI 上下文的历史消息条数设为0可完全关闭。引用回复模式{ channels: { yuanbao: { replyToMode: first, // off | first | all (default: first) }, }, }值行为off不发送引用回复first每条入站消息仅第一条回复带引用默认all每条回复都带引用Markdown 防包裹提示注入默认情况下机器人会向系统提示中注入一条指令防止模型把整条回复包进 markdown 代码块{ channels: { yuanbao: { markdownHintEnabled: true, // default: true }, }, }调试模式{ channels: { yuanbao: { debugBotIds: [bot_user_id_1, bot_user_id_2], }, }, }为列出的机器人 ID 输出未脱敏的日志便于排查问题。多 Agent 路由bindings使用bindings把元宝的私聊或群聊路由到不同 Agent{ agents: { entries: { main: { default: true }, agent-a: { workspace: /home/user/agent-a }, 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.channelyuanbaomatch.peer.kinddirect私聊或group群聊match.peer.id用户 ID 或群组编码bindings 是 OpenClaw 将入站频道/账号/对端映射到具体 Agent 的通用机制会话键、精确对端匹配peer.kindpeer.id与通配匹配的完整说明见 频道路由文档。配置参考完整参数表设置说明默认值channels.yuanbao.enabled启用/禁用频道truechannels.yuanbao.defaultAccount出站路由的默认账号defaultchannels.yuanbao.accounts.id.appKeyApp Key签名 票据生成-channels.yuanbao.accounts.id.appSecretApp Secret签名-channels.yuanbao.accounts.id.token预签名 token跳过自动票据签名-channels.yuanbao.accounts.id.name账号显示名称-channels.yuanbao.accounts.id.enabled启用/禁用指定账号truechannels.yuanbao.dm.policy私聊策略openchannels.yuanbao.dm.allowFrom私聊白名单用户 ID 列表-channels.yuanbao.requireMention群聊要求 提及truechannels.yuanbao.overflowPolicy长消息处理split或stopsplitchannels.yuanbao.replyToMode群聊引用回复策略off、first、allfirstchannels.yuanbao.outboundQueueStrategy出站策略merge-text或immediatemerge-textchannels.yuanbao.minCharsmerge-text触发发送的最小字符数2800channels.yuanbao.maxCharsmerge-text单条消息最大字符数3000channels.yuanbao.idleMsmerge-text自动冲刷的空闲超时毫秒5000channels.yuanbao.mediaMaxMb媒体大小限制MB20channels.yuanbao.historyLimit群聊历史上下文条数100channels.yuanbao.disableBlockStreaming禁用块级流式输出falsechannels.yuanbao.fallbackReply模型无内容时的兜底回复暂时无法解答你可以换个问题问问我哦channels.yuanbao.markdownHintEnabled注入 markdown 防包裹指令truechannels.yuanbao.debugBotIds调试白名单机器人 ID未脱敏日志[]支持的消息类型接收文本、图片、文件、语音、视频、表情包/自定义表情、自定义元素链接卡片。发送文本markdown、图片、文件、语音、视频、表情包。线程与回复支持引用回复通过replyToMode配置平台不支持线程回复。延伸阅读频道总览 —— 全部受支持频道元宝为外部插件条目配对机制 —— 私聊认证与配对流程群组行为 —— 群聊行为与提及门控频道路由 —— 消息的会话路由与 bindings 匹配安全模型 —— 访问模型与加固建议CLI 频道参考 ——openclaw channels全量命令CLI 配对参考 ——openclaw pairing全量命令【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考