一行命令,将你最喜欢的 AI 编程智能体接入腾讯元宝,支持群聊、多实例、文件收发,开箱即用。
痛点:好工具太多,入口太散
作为一个开发者,你可能同时在使用多个 AI 智能体:
- Claude Code 用来做代码审查和重构
- GitHub Copilot 用来做实时补全
- Gemini CLI 用来做技术调研
- Codex 用来做复杂任务规划
每个智能体一个入口,每次切换都要打开不同的终端、输入不同的命令——工具越多,效率越低。

而如果你想在微信里用这些智能体?微信机器人的生态早就收紧了,群聊更是遥不可及的梦。
解决方案:yuanbao-acp
今天介绍一个我刚开源的项目——yuanbao-acp,它能把你喜欢的任意 ACP 兼容智能体桥接到腾讯元宝,让智能体在元宝里直接为你工作。
npx -y yuanbao-acp@latest --agent copilot \
--yuanbao-app-id YOUR_APP_ID \
--yuanbao-app-secret YOUR_APP_SECRET
就这一行命令,Copilot 就出现在元宝里了。你在元宝发消息,它在背后干活,结果直接回传给你。

为什么是元宝?
很多人第一反应是"为什么不桥接到微信"。确实,微信的用户基数更大,但元宝有几个微信做不到的优势:
| 特性 | 微信 | 元宝 |
|---|---|---|
| 机器人加入群聊 | ❌ 几乎不可能 | ✅ 原生支持 |
| 多机器人并行 | ❌ 受限严格 | ✅ 随意添加 |
| 深度 AI 集成 | ❌ 封闭生态 | ✅ 开放 API |
简单说:微信适合触达用户,元宝适合承载智能体。

核心能力一览
🧠 内置 11 个智能体预设
不用记复杂的命令行,内置了最常用的智能体预设:
copilot— GitHub Copilot CLIclaude— Anthropic Claude Codegemini— Google Gemini CLIqwen— 通义千问codex— OpenAI Codexopencode/openclaw/kiro/hermes/kimi/pi
一条命令启动:
npx -y yuanbao-acp@latest --agent claude
💬 群聊 & 私聊双模式
不只是私聊,智能体可以加入群聊。你的团队可以在群里 @元宝机器人,让它直接调用后端的 Claude Code 或 Copilot 做代码评审——多人协作,一人配置,全员受益。
📁 文件收发,原生支持
用户发送 PDF 、图片、ZIP 等文件,yuanbao-acp 会自动下载保存到本地,智能体通过文件路径直接读取。发文件给智能体,就像发给本地终端一样自然。
🔄 多部分消息缓冲
元宝不支持单条消息里同时发图片和文字?没关系。用 /acp-prompt-start 进入缓冲模式,随意发送文本、图片、文件,最后 /acp-prompt-done 一键合并发送。
👤 多实例并行
一台机器、多个元宝账号、多个项目——--instance 参数让每个实例完全隔离:

# 终端 1:项目 A 用 Copilot
npx -y yuanbao-acp@latest --instance projA --agent copilot
# 终端 2:项目 B 用 Claude
npx -y yuanbao-acp@latest --instance projB --agent claude
⏰ 本地注入,自动化利器
通过 inject 命令从 cron 任务或脚本向元宝机器人发消息,实现每日 AI 资讯推送、定时代码检查等自动化场景:
npx yuanbao-acp inject --text "今日 AI 资讯"
🎛️ 运行时配置
不用重启,直接在元宝里通过 /acp-config 命令调整智能体的模型、模式、推理强度等参数。还支持自定义命令别名,把 /acp-cancel 改成 /取消,让非技术同事也能用。
快速上手
前置条件
- Node.js 20+
- 已安装元宝 App
- 从元宝开放平台获取 App ID 和 App Secret
三步启动
# 1. 一键启动(以 Copilot 为例)
npx -y yuanbao-acp@latest --agent copilot \
--yuanbao-app-id YOUR_APP_ID \
--yuanbao-app-secret YOUR_APP_SECRET
# 2. 后台运行
npx -y yuanbao-acp@latest --agent claude --daemon
# 3. 自定义智能体
npx -y yuanbao-acp@latest --agent "npx my-agent --acp" \
--yuanbao-app-id YOUR_APP_ID \
--yuanbao-app-secret YOUR_APP_SECRET
就这么简单。不需要搭建服务器,不需要配置数据库,不需要写一行代码。
隐私与安全
yuanbao-acp 在设计上充分考虑了隐私:
- 遥测可选:通过环境变量
YUANBAO_ACP_TELEMETRY=0一键关闭 - 数据最小化:遥测仅收集事件类型和哈希化的用户 ID ,不收集消息内容、文件名、令牌等任何敏感信息
- 本地存储:所有配置和状态数据保存在本地
~/.yuanbao-acp/目录下
适用场景
- 开发者个人效率:在元宝里直接用 Claude Code 做代码审查,不用切终端
- 团队智能协作:智能体加入项目群,成员随时 @ 它做技术讨论
- 自动化工作流:结合 cron + inject 实现定时 AI 日报、代码巡检
- 多智能体编排:一个元宝账号驱动多个智能体,各司其职
写在最后
yuanbao-acp 的核心理念很简单:让智能体去用户所在的地方,而不是让用户去智能体所在的地方。

ACP 协议正在成为 AI 智能体的标准接口( Agent Client Protocol ),越来越多的工具开始支持它。yuanbao-acp 是这个生态中的一座桥梁——把强大的智能体能力,带到元宝这个触手可及的入口。
项目已开源,MIT 协议,欢迎 Star 、Fork 和提 PR:
👉 https://github.com/shiye515/yuanbao-acp
如果你觉得这个项目有用,不妨分享给同样在用元宝的朋友。一个人的智能体是效率,一群人的智能体是生产力。