一个与你共同成长、学习的个性化有机智能体框架

• Agent Zero 并非预定义的智能体框架。它被设计成动态的、有机生长的，并且会随着你的使用不断学习。
• Agent Zero 完全透明、可读、易懂、可定制且高度互动。
• Agent Zero 将计算机作为工具来完成其（你的）任务。

⚙️ 安装

点击观看视频，了解如何安装 Agent Zero：

⚡ 快速入门

macOS / Linux:

curl -fsSL https://bash.agent-zero.ai | bash

Windows (PowerShell):

irm https://ps.agent-zero.ai | iex

Docker:

docker run -p 80:80 agent0ai/agent-zero

关于 Windows、macOS 和 Linux 的详细安装指南，请参阅 Agent Zero 文档中的 此页面。

💡 核心功能

1. 通用型助手

• Agent Zero 并非为特定任务预先编程（但可以）。它旨在成为一个通用的个人助手。只需赋予它一项任务，它便会收集信息、执行命令和代码、与其他智能体实例协作，并尽最大努力完成任务。
• 它拥有持久化记忆，能够记住之前的解决方案、代码、事实、指令等，从而在未来更快、更可靠地解决任务。

2. 计算机作为工具

• Agent Zero 将操作系统用作完成任务的工具。它没有预置任何单一用途的工具。相反，它可以自行编写代码，并利用终端创建和使用所需的工具。
• 其工具库中仅包含在线搜索、记忆功能、与用户及其他智能体沟通以及代码/终端执行等默认工具。其他一切功能均由智能体自身创建，或可由用户扩展。
• 工具使用功能从零开始开发，旨在实现最高兼容性和可靠性，即使在非常小的模型上也能稳定运行。
• 默认工具： Agent Zero 包含知识检索、代码执行和通信等功能。
• 自定义工具： 通过创建自己的自定义工具，进一步扩展 Agent Zero 的功能。
• 技能（SKILL.md 标准）： 技能是根据上下文动态加载的专业知识。它们采用 Anthropic 开发的开放 SKILL.md 标准，因此与 Claude Code、Cursor、Goose、OpenAI Codex CLI 和 GitHub Copilot 等工具兼容。

3. 多智能体协作

• 每个智能体都有一个上级智能体为其分配任务和指令。每个智能体随后会向其上级汇报工作进展。
• 对于链条中的第一个智能体（Agent 0）而言，其上级就是人类用户；该智能体对此并无感知差异。
• 每个智能体都可以创建下属智能体，以帮助分解并解决子任务。这有助于所有智能体保持清晰、专注的工作上下文。

浏览器代理

• 浏览器自动化由内置的 _browser_agent 插件提供。
• 它使用由 _model_config 解析的有效主模型；没有单独的浏览器模型槽位。
• 浏览器视觉遵循主模型的视觉设置。
• Playwright Chromium：Docker 镜像预装了无头 Shell。本地开发会在首次使用浏览器代理时，通过 plugins/_browser_agent/helpers/playwright.py 中的 ensure_playwright_binary() 方法将其安装到 tmp/playwright 目录中；你也可以手动预先安装（参见 开发设置），以避免等待。

4. 完全可定制和可扩展

• 该框架中几乎没有硬编码的部分。没有任何隐藏的内容。用户可以扩展或更改任何部分。
• 整个行为由 prompts/default/agent.system.md 文件中的系统提示定义。修改此提示即可显著改变框架的行为。
• 框架不会以任何方式引导或限制代理。不存在代理必须遵循的硬编码规则。
• 在代理的通信循环中发送的每一个提示、每一个小消息模板都可以在 prompts/ 文件夹中找到并进行修改。
• 内置工具位于核心的 tools/ 文件夹中，或位于 plugins/ 下的内置插件中，可以被调整或扩展。
• 通过 A0_SET_ 环境变量实现自动化配置，便于部署自动化和快速设置。

5. 沟通是关键

• 为你的代理提供合适的系统提示和指令，它就能创造奇迹。
• 代理可以与其上级和下级进行沟通，提出问题、下达指令并提供指导。在系统提示中指导你的代理如何有效地进行沟通。
• 终端界面是实时流式传输且交互式的。你可以在任何时候停止并介入。如果你发现代理正朝着错误的方向发展，只需立即停止并告知它。
• 该框架提供了极大的自由度。你可以指示代理定期向其上级汇报，请求继续执行的许可。你也可以指示它们在决定何时委派子任务时使用积分系统。上级可以对下级的结果进行复核并提出异议。可能性是无限的。

🚀 实际应用场景

• 财务分析与图表绘制 - "查找上个月比特币/美元的价格走势，与主要加密货币新闻事件相关联，生成带有高亮关键日期的注释图表"

• Excel 自动化流水线 - "扫描传入目录中的财务电子表格，验证并清理数据，从多个来源整合数据，生成带有异常标记的高管报告"

• 无需代码的 API 集成 - "使用这段 Google Gemini API 代码片段生成产品图片，记住这次集成以便日后使用" - 代理会学习并将解决方案存储在内存中。

• 自动化服务器监控 - "每 30 分钟检查一次服务器状态：CPU 使用率、磁盘空间、内存。如果指标超过阈值，则发出警报"（具有项目范围凭据的计划任务）

• 多客户项目隔离 - 为每个客户创建独立的项目，拥有隔离的内存、自定义指令和专用密钥——防止敏感工作之间的上下文泄露。

🐳 完全 Docker 化，支持语音转文本和 TTS

• 可定制的设置允许用户根据自身需求调整代理的行为和响应。
• Web UI 的输出非常简洁、流畅、色彩丰富、易读且具有交互性；没有任何隐藏的内容。
• 你可以直接在 Web UI 中加载或保存聊天记录。
• 你在终端中看到的相同输出会自动保存到 logs/ 文件夹中的 HTML 文件中，每次会话都会保存一份。

• 代理的输出是实时流式的，允许用户随时阅读并进行干预。
• 无需编写代码，只需要具备提示和沟通技巧即可。
• 只要有扎实的系统提示，即使使用小型模型，该框架也能可靠运行，包括精确地使用工具。

👀 请注意

1. Agent Zero 可能存在危险！

• 在适当的指导下，Agent Zero 能够完成许多事情，甚至可能涉及对你的计算机、数据或账户的潜在危险操作。请务必在隔离环境中（如 Docker）运行 Agent Zero，并小心你的期望。

2. Agent Zero 基于提示运行。

• 整个框架都由 prompts/ 文件夹中的提示所引导。代理的指导方针、工具说明、消息以及实用的 AI 功能，全部都在这里。

📚 阅读文档

页面	描述
安装	安装、设置和配置
使用	基本及高级用法
指南	分步指南：使用、项目、API 集成、MCP 设置、A2A 设置
开发设置	开发和定制
WebSocket 基础设施	实时 WebSocket 处理程序、客户端 API、过滤语义、封装
扩展	扩展 Agent Zero
连接性	外部 API 端点、MCP 服务器连接、A2A 协议
架构	系统设计和组件
贡献	如何贡献
故障排除	常见问题及其解决方案

🤝 社区和支持

• 加入我们的 Discord 社区（https://discord.gg/B8KZKNsPpj）进行实时讨论，或访问我们的 Skool 社区（https://www.skool.com/agent-zero）。
• 关注我们的 YouTube 频道（https://www.youtube.com/@AgentZeroFW）以获取实践讲解和教程。
• 如需修复 bug 或添加功能，请提交问题至 GitHub（https://github.com/agent0ai/agent-zero/issues）。

Agent Zero 快速上手指南

环境准备

项目	要求
操作系统	macOS / Linux / Windows 10+
Docker	20.10+（推荐，隔离更安全）
Python	3.10+（本地开发时需要）
网络	可访问 GitHub、Docker Hub

国内用户建议使用 清华镜像 加速 Docker 安装。

安装步骤

1. 一键脚本（推荐）

macOS / Linux

curl -fsSL https://bash.agent-zero.ai | bash

Windows（PowerShell 管理员）

irm https://ps.agent-zero.ai | iex

2. Docker 方式（最干净）

docker run -p 80:80 agent0ai/agent-zero

浏览器访问 http://localhost 即可。

3. 国内镜像（可选）

# 使用阿里云镜像加速
docker run -p 80:80 registry.cn-hangzhou.aliyuncs.com/agent0ai/agent-zero

基本使用

1. 启动后，在终端或 Web UI 输入第一条指令：

   帮我创建一个 Python 脚本，列出当前目录下所有 txt 文件
   

2. 观察 Agent 实时输出，可随时按 Ctrl+C 中断并补充说明。

3. 任务完成后，Agent 会将脚本保存到本地，并告知路径。

4. 进阶：创建项目隔离环境

   /project create my_finance
   

   之后所有操作均在 my_finance 独立工作区，避免交叉污染。

首次使用浏览器自动化时，Agent 会自动下载 Playwright 浏览器内核，国内用户可提前设置 PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright 加速。