把 Claude Code、Copilot 装进元宝： yuanbao-acp 让 AI 智能体触手可及

[shiye515]

一行命令，将你最喜欢的 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 CLI
• claude — Anthropic Claude Code
• gemini — Google Gemini CLI
• qwen — 通义千问
• codex — OpenAI Codex
• opencode / 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

---

如果你觉得这个项目有用，不妨分享给同样在用元宝的朋友。一个人的智能体是效率，一群人的智能体是生产力。