Agent Zero 的卖点一句话:给 Agent 一台完整的 Linux 电脑。它能用终端、浏览器、桌面应用,还能开 Blender、LibreOffice 跟你一起改文档。我先给判断:这跟「套个 shell 让模型跑命令」不是一回事,它给的是一个带沙箱、能回滚、你能随时插手的完整工作区。这篇记我装它的过程。
我在本机(Apple M2 Pro,32 GB,macOS 14.6.1)真去装了一遍。官方给了三条路:A0 Launcher 桌面版、curl -fsSL bash.agent-zero.ai | bash 的 shell 安装器、还有一条最直接的 docker run。三条路殊途同归,最终都落在 Docker 上。这是它跟别的 Agent 框架最大的分水岭。
先跑 Docker 那条最短的路
README 里给了一条不用装任何东西的命令,前提是你已经有 Docker:
docker run -d -p 127.0.0.1:5080:80 -v a0_usr:/a0/usr agent0ai/agent-zero
我跑了 1 遍这条命令,返回的是 failed to connect to the docker API at unix:///Users/zhangcheng/.docker/run/docker.sock ... no such file or directory。Docker 客户端在,daemon 没起。我又试了 1 遍 curl -fsSL bash.agent-zero.ai,28 秒超时,进度停在 0 字节,这条安装器也没走通。两条路都卡在同一个地方:Docker。
这里我记一个判断。Agent Zero 把 Linux 工作区做成容器,是有意的。它的浏览器、桌面、终端全跑在容器里,所以出问题能回滚,不会污染宿主机。代价是它吃死了 Docker。你不想装 Docker,就别碰它。这条记牢。
透明到能改的 prompts 和 tools
跑不通,我就改抓源码看它怎么长的。Agent Zero 最大的特点是「几乎不藏东西」。prompt 模板全在 prompts/ 目录,工具全在 tools/ 目录,行为可以查、可以改、可以换。我把 prompts/ 列了 1 遍,四十多个 markdown 文件,从 agent.system.main.role.md 到 agent.system.mcp_tools.md,每一个都对应一块行为。
工具也是 Python 文件,我抓了 1 遍 tools/ 目录:browser_open、call_subordinate、knowledge_tool、skills_tool、parallel、vision_load。这跟那些把工具塞进二进制的框架完全两个路子。你想要什么行为,改对应文件就行。
# tools/call_subordinate.py 的核心:注册一个子 Agent 到父 Agent 名下
def _register_subordinate(parent, subordinate, slot):
subordinates = parent.get_data(SUBORDINATES_DATA_KEY) or {}
subordinates[subordinate.context.id] = subordinate
parent.set_data(SUBORDINATES_DATA_KEY, subordinates)
subordinate.set_data(Agent.DATA_NAME_SUPERIOR, parent)
这段是我按它源码的思路写的简版,不是照抄。它解决的事很具体:主 Agent 把任务拆出去,交给不同 profile 的子 Agent 各干各的,干完回报。多 Agent 协作在 Agent Zero 里是原生能力,不是插件。
依赖表里能看出它的野心
我把 requirements.txt 打开核了 1 遍,这份 2393 字节的清单暴露了它的全貌。litellm==1.104.0 管多供应商模型接入,openai==2.54.0 直接对 OpenAI 和 ChatGPT 账号,fastmcp==3.2.4 加 mcp==1.27.0 接 MCP 工具,faiss-cpu==1.11.0 加 sentence-transformers==3.0.1 做向量记忆和召回,patchright==1.61.2 驱动浏览器,docker==7.1.0 就是它跟宿主的通道。
这套依赖说明它想做的不是「聊天」,是一个能浏览、能查资料、能跑代码、能记记忆、还能写文档的通用 Agent。文档里管这叫「研究、写代码、建文档」。它要的模型也不挑,云供应商、AI 账号、本地模型三条路都行。
项目隔离和 Time Travel
它把工作区管理也做得细。Projects 把工作区、指令、记忆、密钥、知识库、模型预设按项目隔离,clone 一个 Git 仓库进去,就只给这个项目喂它自己的上下文。Skills 按需加载,Agent Profiles 改当前会话的工作风格,Model Presets 是模型配置的快捷切换。这几样我核了 1 遍,都是它「让 Agent 适配你」的拼图。
Time Travel 是它给自己加的安全层。它把工作区的快照存在 /a0/usr 下,能看改了什么、对比文件、回滚。官方原话是它不替代 Git,是给「Agent 正在改文件」这件事加一层保险。这个定位很诚实。还有个 A0 CLI 连接器,能把宿主机上的终端接到运行中的实例:
# 装在你要让 Agent 操作的那台机器上,不是容器里
curl -LsSf https://cli.agent-zero.ai/install.sh | sh
a0 # 连接一个本地或远程的 Agent Zero 实例
我核了 1 遍它的说明,这条命令是给「让 Agent 碰你自己电脑上的文件」用的,装错了地方会白搭。安全模型那节也反复强调别把整个 home 目录挂进去。这些边界它写得比我见过的多数框架都清楚。
该不该用它,给个分界
值不值得,我给个分界。你要一个能自己开浏览器、自己改文件、出了岔子能回滚的通用 Agent,而且不介意装 Docker,Agent Zero 是眼下最开放的选择。你只是想在代码里调个模型跑任务,那这套 Linux 工作区是纯额外开销,用 litellm 直连模型更快。
还有个判断。它的 Time Travel 功能在 /a0/usr 下留快照,能看历史、能回滚。官方自己都说它不是 Git 的替代品,是给「Agent 正在改文件」这件事加的一层安全垫。这个定位很诚实,我照它原意理解,不夸大。
Docker 这关过了,它值得装一次。装不动,就说明你的机器跑不了这套沙箱,硬上也没意义。这是硬伤,别绕。