agent0ai/agent-zero

Agent Zero – 一个开源 AI 代理工作台

它是什么 – Agent Zero 是一个基于 Docker 的框架，为语言模型驱动的代理提供完整的 Linux 桌面环境。代理可以操作 GUI 应用、内置浏览器、LibreOffice 编辑器和终端，而您可以通过名为 Canvas 的 Web UI 观看和干预。

关键组件

• Linux 桌面（XFCE） 在容器内 – 代理可以打开任何 GUI 程序（例如 Blender、VS Code、终端）并像人类用户一样操作文件。
• 带 DOM 注释的浏览器 – 点击元素以检查、修改、“提取”（捕获）组件，或留下代理可以执行的注释。
• 实时文档协作 – Markdown、ODT/ODS/ODP 编辑器在您和代理之间实时共享。
• 插件中心 – 超过 100 个社区插件，用于技能、记忆后端、开发框架、UI 调整等。
• 项目与记忆 – 隔离的工作区，按任务分别保存文件、密钥、Git 仓库和模型预设。
• A0 CLI 连接器 – 一个轻量客户端，将 Docker 化的代理桥接到您的主机，让同一代理编辑本地仓库或运行主机端工具。
• 多代理协作 – 代理可以生成子代理以专业化（研究、编码、分析）并汇总其结果。
• 时间旅行快照 – 自动版本化 /a0/usr 工作区，便于差异比较/回滚（作为 Git 的补充）。

安装

• A0 启动器（GUI）– 下载平台特定的二进制文件（macOS、Linux、Windows），处理 Docker 检查、实例创建和端口管理。
• A0 安装（脚本）– 单行 curl/PowerShell 命令，设置 Docker 容器并可选择以快速启动模式运行。
• 直接 Docker 运行 – docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero 用于手动控制。

典型工作流程

1. 通过启动器或脚本启动实例。
2. 打开 Web UI，配置 LLM 提供商（OpenAI Codex、Gemini、Claude 等）。
3. 创建 项目（可选克隆 Git 仓库）。代理现在拥有自己的隔离文件系统。
4. 要求代理执行任务 – 例如，“在 Blender 中设计 3D 标志”、“注释此网页并用 React 重新实现英雄组件”或“构建预算电子表格”。
5. 在 Canvas 桌面或浏览器中观看代理操作；通过输入、点击或直接编辑文件进行干预。
6. 使用插件或自定义技能扩展功能，或为更大的任务生成子代理。
7. 完成后，快照工作区或通过 时间旅行 回滚。

用例亮点

• 软件工程 – 代理可以在您监督下打开代码库、运行测试、编辑文件并提交更改。
• 设计与 UI 迭代 – 浏览竞争对手网站、注释元素，并让代理生成匹配的组件。
• 财务分析 – 收集数据、构建 ODS 电子表格并生成可编辑图表。
• 文档制作 – 无需离开聊天即可共同编写 Markdown、ODT 或演示文稿文件。
• 自动化与编排 – 安排定期检查、通过 A0 连接器在主机上运行 CLI 工具，或链接多个专业子代理。

安全注意事项

• 在 Docker（或其他容器）内运行以隔离代理。
• 限制主机目录挂载；仅在需要时授予读写权限。
• 将凭据存储在项目密钥中，而不是提示中。
• 审查任何影响生产系统、资金或私人数据的操作。

了解更多

• 完整文档：./docs/（快速入门、浏览器指南、桌面指南、插件、记忆、MCP 等）
• 社区：Discord、YouTube 频道、Skool 社区和 GitHub Issues。
• 开源代码和插件中心在 GitHub 上的 agent0ai 组织下。

底线 – Agent Zero 是一个全面、可扩展的平台，让 LLM 代理在真实的 Linux 桌面环境中操作，弥合了纯文本聊天与实际软件开发、设计和数据工作之间的差距。