ACP Setup Chinese

🤖 AionUi 多Agent模式配置教程

本教程将详细介绍如何在 AionUi 中配置和使用多Agent模式，包括 Claude Code、Qwen Code、CodeX、iFlow CLI 等外部 CLI 工具的集成。这些外部工具通过 ACP（Agent Client Protocol，代理客户端协议）协议接入，实现统一的界面管理。

English | 简体中文

🎯 多Agent模式概览

多Agent模式是一个可选功能，允许您集成已安装的外部 CLI 工具。如果您已使用 Claude Code、Codex 或 Qwen Code，AionUi 会自动检测并让您与它们协同工作 — 与内置 Agent 一起。这些外部 CLI 工具通过 ACP（Agent Client Protocol，代理客户端协议）协议接入，具有以下特点：

• 自动检测：自动识别已安装的 CLI 工具
• 统一界面：一个 Cowork 平台管理所有 AI Agent
• 自动化任务执行：AI Agent 可独立执行任务、运行脚本、读写文件、操作工具，自动完成任务
• 工作流自动化：完整的工作流自动化能力，支持文件系统操作和任务自动完成
• 独立功能：每个代理保持其原有的功能和特性
• 协议标准化：通过 ACP 协议实现标准化的通信
• 灵活扩展：支持接入更多符合 ACP 协议的 CLI 工具

支持的外部 Agent

代理	CLI 命令	状态
内置 Agent（Gemini CLI）	内置在 AionUi 中	✅ 默认启用
Claude Code	claude	✅ 已支持
Qwen Code	qwen	✅ 已支持
CodeX	codex	✅ 已支持
iFlow CLI	iflow	✅ 已支持
Goose	goose	✅ 已支持
Augment Code	auggie	✅ 已支持
Kimi CLI	kimi	✅ 已支持
OpenCode	opencode	✅ 已支持
Factory Droid	droid	✅ 已支持
CodeBuddy	codebuddy	✅ 已支持
GitHub Copilot	copilot	✅ 已支持
Qoder CLI	qodercli	✅ 已支持
Mistral Vibe	vibe-acp	✅ 已支持
Nano Bot	nanobot	✅ 已支持
OpenClaw	openclaw	✅ 已支持

💡 提示：AionUi 还支持自定义 Agent，你可以在设置中配置任何符合 ACP 协议的 CLI 工具。

多Agent模式 vs 内置 Agent 模式

特性	内置 Agent 模式	多Agent模式
安装要求	AionUi 内置，安装后默认使用	需要用户自己下载安装 CLI 工具，AionUi 自动检测后集成
技术架构	AionUi 内置 Agent 引擎	通过 ACP 协议集成外部 CLI 工具
功能完整性	完整功能（图像生成、工具调度、多 API Key 轮换等）	目前相对简单，主要通过 GUI 管理对话和工作空间
配置集成	直接享受 AionUi 的所有配置功能	目前无法直接使用 AionUi 的 LLM 配置、图像生成等内置功能
未来发展	功能最完整，持续优化	ACP接入工具将逐步追赶，未来将开发统一管理功能
适用场景	日常使用、完整 AI 功能体验	专业用户、特定 CLI 工具需求

---

🚀 第一步：安装 CLI 工具

在配置多Agent模式之前，你需要先安装相应的 CLI 工具。

Claude Code 安装

1. 安装 Claude CLI

   # 使用 npm 全局安装
   npm install -g @anthropic-ai/claude-code

2. 验证安装

   claude --version

3. 认证配置

   # 登录 Claude 账号
   claude login

📖 官方文档: Claude Code GitHub

Qwen Code 安装

1. 安装 Qwen CLI

   # 使用 npm 全局安装
   npm install -g @qwen-code/qwen-code

2. 验证安装

   qwen --version

3. 认证配置

   # 登录 Qwen 账号
   qwen login

📖 官方文档: Qwen Code GitHub

CodeX 安装

1. 安装 CodeX CLI

   # 使用 npm 全局安装
   npm install -g @openai/codex

2. 验证安装

   # 检查版本
   codex --version

3. 认证配置

   # 登录 OpenAI 账号
   codex login

📖 官方文档: OpenAI Codex CLI

iFlow CLI 安装

1. 安装 iFlow CLI

   # 使用 npm 全局安装
   npm install -g @iflow-ai/iflow-cli

2. 验证安装

   iflow --version

3. 认证配置

   # 登录 iFlow 账号
   iflow login

📖 官方文档: iFlow CLI GitHub

Goose 安装

1. 安装 Goose CLI

   # macOS 使用 Homebrew
   brew install block/tap/goose
   
   # 或使用 pipx
   pipx install goose-ai

2. 验证安装

   goose --version

3. 启动 ACP 模式

   # Goose 使用子命令启动 ACP
   goose acp

📖 官方文档: Goose GitHub

Augment Code 安装

1. 安装 Augment Code CLI

   # 使用 npm 全局安装
   npm install -g @anthropic-ai/augment-code

2. 验证安装

   auggie --version

3. 启动 ACP 模式

   # Auggie 使用 --acp 参数
   auggie --acp

📖 官方文档: Augment Code

Kimi CLI 安装

1. 安装 Kimi CLI

   # 使用 npm 全局安装
   npm install -g @anthropic-ai/kimi-cli

2. 验证安装

   kimi --version

3. 启动 ACP 模式

   # Kimi 使用 --acp 参数
   kimi --acp

📖 官方文档: Kimi CLI (Moonshot)

OpenCode 安装

1. 安装 OpenCode CLI

   # 使用 Go 安装
   go install github.com/opencode-ai/opencode@latest

2. 验证安装

   opencode --version

3. 启动 ACP 模式

   # OpenCode 使用子命令启动 ACP
   opencode acp

📖 官方文档: OpenCode GitHub

Factory Droid 安装

1. 安装 Factory Droid CLI

   # 参考 Factory 官方文档安装
   # 需要配置 FACTORY_API_KEY 环境变量

2. 验证安装

   droid --version

3. 启动 ACP 模式

   # Droid 使用特殊的 exec 命令格式
   droid exec --output-format acp

📖 官方文档: Factory Droid

CodeBuddy 安装

1. 安装 CodeBuddy CLI

   # 使用 npm 全局安装
   npm install -g @tencent-ai/codebuddy-code
   
   # 或使用 npx（无需全局安装）
   npx @tencent-ai/codebuddy-code

2. 验证安装

   codebuddy --version

3. 启动 ACP 模式

   # CodeBuddy 使用 --acp 参数
   codebuddy --acp

📖 官方文档: CodeBuddy GitHub

GitHub Copilot 安装

1. 安装 GitHub Copilot CLI

   # 使用 npm 全局安装
   npm install -g @github/copilot-cli

2. 验证安装

   copilot --version

3. 启动 ACP 模式

   # GitHub Copilot 使用 --acp --stdio 参数
   copilot --acp --stdio

📖 官方文档: GitHub Copilot CLI

Qoder CLI 安装

1. 安装 Qoder CLI

   # 使用 npm 全局安装
   npm install -g @qoder-ai/qoder-cli

2. 验证安装

   qodercli --version

3. 启动 ACP 模式

   # Qoder 使用 --acp 参数
   qodercli --acp

📖 官方文档: Qoder CLI GitHub

Mistral Vibe 安装

1. 安装 Mistral Vibe CLI

   # 使用 pip 安装
   pip install vibe-acp
   
   # 或使用 pipx（推荐）
   pipx install vibe-acp

2. 验证安装

   vibe-acp --version

3. 启动 ACP 模式

   # Mistral Vibe 直接运行 vibe-acp 命令
   vibe-acp

📖 官方文档: Mistral Vibe

Nanobot 安装

1. 安装 Nanobot CLI

   # 使用 npm 全局安装
   npm install -g nanobot

2. 验证安装

   nanobot --version

3. 启动 ACP 模式

   # Nanobot 直接运行即可
   nanobot

📖 官方文档: Nanobot GitHub

OpenClaw 安装

1. 安装 OpenClaw CLI

   # 使用 npm 全局安装
   npm install -g @openclaw/cli

2. 验证安装

   openclaw --version

3. 启动 Gateway 模式

   # OpenClaw 使用 gateway 子命令
   openclaw gateway

📖 官方文档: OpenClaw GitHub

💡 提示: OpenClaw 也可以通过 AionUi 的内置助手进行配置，详见 OpenClaw Setup Assistant

---

💬 第二步：使用多Agent模式

创建多Agent对话

1. 选择代理

   • 在欢迎界面选择要使用的外部 Agent
   • 系统会显示检测到的可用代理（通过 ACP 协议接入）

2. 创建对话

   • 输入消息内容
   • 选择工作目录（可选）
   • 点击发送开始对话

对话特性

1. 实时连接状态

   • 显示代理连接状态
   • 自动重连机制
   • 连接错误提示

2. 权限管理

   • CLI 工具会请求文件操作权限
   • 在 AionUi 中确认或拒绝权限请求
   • 支持一次性或永久授权

3. 工具调用

   • 支持 CLI 工具的原生功能
   • 文件读写操作
   • 代码执行和调试

---

❓ 常见问题

Q: 多Agent模式和内置 Agent 模式有什么区别？

A: 主要区别：

• 内置 Agent 模式: AionUi 内置的核心功能，安装后默认使用，支持图像生成、工具调度等完整功能 - 无需安装 CLI 工具
• 多Agent模式: 如果您已安装外部 CLI 工具，AionUi 会自动检测并通过 ACP 协议集成它们，目前功能相对简单，未来将开发 MCP 设置功能来增强集成

Q: 什么时候选择多Agent模式？

A: 选择建议：

• 日常使用: 推荐内置 Agent 模式，功能最完整，开箱即用 - 无需配置
• 专业需求: 如果您已安装特定 CLI 工具（如 Claude Code、Qwen Code 等），可以使用多Agent模式集成它们
• 未来规划: MCP 功能将让多Agent模式享受更多统一功能

Q: 如何知道多Agent模式是否正常工作？

A: 检查方法：

• 在欢迎界面能看到代理选项
• 创建对话时能正常连接
• 发送消息能收到回复
• 权限请求能正常显示

Q: 多Agent模式支持哪些功能？

A: 当前功能：

• 基本的对话功能
• 文件操作权限管理
• CLI 工具的原生功能
• 工作目录管理

🔧 故障排除

Q: 多Agent模式检测不到？

A: 检查步骤：

1. 确认 CLI 工具已正确安装

   # macOS/Linux
   which claude
   which qwen
   which iflow
   which goose
   which auggie
   which kimi
   which opencode
   which droid
   which codebuddy
   which copilot
   which qodercli
   which vibe-acp
   which nanobot
   which openclaw
   
   # Windows
   where claude
   where qwen
   where iflow
   where goose
   where auggie
   where kimi
   where opencode
   where droid
   where codebuddy
   where copilot
   where qodercli
   where vibe-acp
   where nanobot
   where openclaw

2. 验证 CLI 在系统 PATH 中

   • 确保 CLI 工具在系统环境变量 PATH 中
   • 重启终端或命令行窗口

3. 检查 CLI 工具版本

   claude --version
   qwen --version
   iflow --version
   goose --version
   auggie --version
   kimi --version
   opencode --version
   droid --version
   codebuddy --version
   copilot --version
   qodercli --version
   vibe-acp --version
   nanobot --version
   openclaw --version

4. 重启 AionUi 重新检测

   • AionUi 启动时会自动扫描系统 PATH
   • 检测已安装的外部 CLI 工具
   • 在欢迎界面显示可用的多Agent选项

Q: 认证失败？

A: 解决方案：

1. 在终端中运行 claude login 或 qwen login
2. 完成 CLI 工具的认证流程
3. 重启 AionUi 重新连接

Q: 连接超时？

A: 可能原因：

1. 网络连接问题
2. CLI 工具服务不可用
3. 防火墙阻止连接
4. CLI 工具版本过旧

Q: 权限请求不显示？

A: 检查配置：

1. 确认多Agent模式已正确连接
2. 检查 AionUi 权限设置
3. 重启对话重新建立连接

---

📚 相关文档

• 快速入门: 快速入门
• 大模型配置: 大模型配置
• 图像生成配置: 图像生成配置指南
• 常见问题: 常见问题

---

需要帮助？

• 🐛 报告问题
• 💬 社区讨论
• 📖 完整文档

ACP 代理让你在 AionUi 中享受多种 AI 工具的强大功能！