AutoGPT 安装、使用方法详细全解

AutoGPT 安装、使用方法详细全解项目地址https://github.com/Significant-Gravitas/AutoGPT官方文档https://docs.agpt.co一、项目概述AutoGPT 是一个强大的 AI Agent 平台允许用户创建、部署和管理持续运行的 AI 智能体以自动化复杂的工作流。它是历史上增长最快的开源项目之一2023年Q2。1.1 项目架构演变AutoGPT 经历了从经典版到平台版的重大演进版本说明许可证AutoGPT Classic原始的命令行版 AI Agent位于classic/目录MITAutoGPT Platform全新的可视化平台2025-2026主推位于autogpt_platform/Polyform Shield1.2 核心能力自主目标分解与任务规划网页搜索与信息收集文件读写与代码执行插件/扩展生态持久化记忆与状态管理可视化 Agent 构建Platform 版二、仓库结构AutoGPT/ ├── autogpt_platform/ # 新版平台主推 │ ├── backend/ # Python FastAPI 后端 │ │ ├── blocks/ # Agent 功能块核心模块 │ │ ├── copilot/ # Copilot 功能 │ │ └── ... │ ├── frontend/ # Next.js 前端 │ ├── db/ # 数据库配置Supabase │ ├── installer/ # 安装脚本 │ ├── docker-compose.yml # 完整编排 │ ├── docker-compose.platform.yml # 平台服务 │ └── .env.default # 环境变量模板 ├── classic/ # 经典版 │ ├── original_autogpt/ # 原始 AutoGPT Agent │ │ ├── autogpt/ │ │ ├── .env.template │ │ └── autogpt.sh │ ├── forge/ # Agent 构建工具包 │ ├── benchmark/ # 性能基准测试 │ └── frontend/ # 经典版前端 ├── docs/ # 文档 └── run # 根目录 CLI 工具三、安装方法3.1 系统要求硬件要求CPU4 核心推荐RAM最低 8GB推荐 16GB存储至少 10GB 可用空间软件要求操作系统Linux推荐 Ubuntu 20.04macOS 10.15Windows 10/11需 WSL2Docker Engine 20.10.0Docker Compose 2.0.0Git 2.30Node.js 16.x前端开发需要npm 8.xPython 3.10Classic 版或本地开发PoetryPython 依赖管理3.2 安装方式一一键自动安装脚本推荐这是官方推荐的快速安装方式适合本地开发和测试。macOS/Linuxcurl-fsSLhttps://setup.agpt.co/install.sh-oinstall.shbashinstall.shWindows (PowerShell)powershell-ciwr https://setup.agpt.co/install.bat -o install.bat; ./install.bat该脚本会自动安装依赖含 Docker、克隆最新代码、配置环境并启动应用。3.3 安装方式二手动安装 AutoGPT Platform新版步骤 1克隆仓库gitclone https://github.com/Significant-Gravitas/AutoGPT.gitcdAutoGPT/autogpt_platform步骤 2配置环境变量cp.env.default .env编辑.env文件主要修改以下关键配置# 必需修改生产环境 POSTGRES_PASSWORDyour-super-secret-and-long-postgres-password JWT_SECRETyour-super-secret-jwt-token-with-at-least-32-characters-long VAULT_ENC_KEYyour-encryption-key-32-chars-min # 访问地址 SITE_URLhttp://localhost:3000 API_EXTERNAL_URLhttp://localhost:8000 # OpenAI API可选用于 SQL 编辑器助手等 OPENAI_API_KEYsk-...后端.envautogpt_platform/backend/.env中的加密密钥可单独生成cdautogpt_platform/backend poetry run cli gen-encrypt-key步骤 3启动服务dockercompose up-d--build步骤 4访问打开浏览器访问http://localhost:3000各服务端口服务端口前端 UI3000WebSocket Server8001执行 API (REST)8006Kong API 代理8000 / 8443PostgreSQL5432步骤 5验证运行dockercomposeps3.4 安装方式三Classic 版手动安装Classic 版适合命令行用户和需要深度定制的场景。步骤 1克隆仓库gitclone https://github.com/Significant-Gravitas/AutoGPT.gitcdAutoGPT/classic步骤 2安装依赖poetryinstall步骤 3配置 .envcp.env.template .env编辑classic/.env# 必需 OPENAI_API_KEYsk-... # LLM 模型设置 SMART_LLMgpt-4o # 复杂推理 FAST_LLMgpt-4o-mini # 简单任务 # 搜索提供商可选 TAVILY_API_KEYtvly-... SERPER_API_KEY... # 其他可选 LOG_LEVELDEBUG PORT8000 FILE_STORAGE_BACKENDlocal # local, s3, 或 gcs支持的 LLM 提供商提供商配置项示例模型OpenAIOPENAI_API_KEYgpt-4o, gpt-4o-miniAnthropicANTHROPIC_API_KEYclaude-3-opus-20240229GroqGROQ_API_KEYllama3-70b-8192Llamafile本地LLAMAFILE_API_BASEmistral-7b-instruct-v0.2AzureUSE_AZURETrueazure.yaml自定义部署步骤 4运行cdclassic ./autogpt.sh--help3.5 Docker 专用部署Classic 版Classic 版也支持 Docker 部署cdAutoGPT/classic/original_autogptdockercompose up-d3.6 开发模式后端开发cdautogpt_platformmakestart-core# 启动核心服务makerun-backend# 运行后端 FastAPI 服务或手动cdautogpt_platform/backend poetryinstall--withdev poetry run app前端开发cdautogpt_platformdockercompose--profilelocalup deps_backend--build--detachcdfrontendpnpminstallpnpmgenerate:api-clientpnpmdev四、使用方法详解AutoGPT 有两种主要的使用范式Platform可视化平台和Classic命令行。4.1 AutoGPT Platform 使用方法新版主推Platform 版本提供可视化界面通过积木块方式构建 Agent。4.1.1 Agent Builder可视化构建Platform 提供了低代码/无代码的 Agent 构建界面Block功能块系统每个 Block 执行一个单一操作通过连接不同 Block 构建 Agent 工作流内置 Block 包括但不限于Web Search网络搜索Text Summarizer文本摘要Email Sender邮件发送Execute Code代码执行File I/O文件读写以及各类第三方集成Discord, GitHub, Google, Twitter 等 30 服务构建步骤打开http://localhost:3000进入 Agent Builder 界面拖拽 Block 到画布连接 Block 之间的输入/输出配置每个 Block 的参数保存并测试示例自动新闻收集工作流[Web Search Block] → [Text Summarizer Block] → [Email Sender Block]实现自动收集新闻并发送早报的完整流程无需编写代码。4.1.2 Workflow Management工作流管理在 Platform 中创建、修改和优化自动化工作流支持版本管理和部署控制从测试到生产的生命周期管理4.1.3 Ready-to-Use Agents预置 AgentPlatform 提供预配置的 Agent 库可直接选择并使用从 Marketplace 浏览和部署预构建的 Agent无需从头构建适合快速上手4.1.4 Agent InteractionAgent 交互通过友好界面运行和交互无论是自建还是预置 Agent均可统一管理实时查看 Agent 执行状态和日志4.1.5 Monitoring Analytics监控与分析跟踪 Agent 性能获取洞察以持续改进自动化流程日志和指标可视化4.1.6 Copilot 功能Platform 内置 Copilot 模式提供自然语言对话交互目标分解Decompose GoalMCPModel Context Protocol工具调用Discord 集成可通过 Discord Bot 交互4.2 Classic 版使用方法Classic 版通过命令行交互更适合技术用户。4.2.1 基本运行run 模式./autogpt.sh run启动后交互流程命名你的 AI例如MarketResearcherGPT定义 AI 角色例如An AI designed to research market trends设置目标Goals输入目标 1按回车输入目标 2按回车…按空回车结束观察 Agent 自主执行Agent 会自言自语思考下一步显示计划和行动每次行动前询问你是否继续输入y继续4.2.2 运行参数详解./autogpt.sh run[OPTIONS]参数说明示例-c, --continuous启用连续模式无需每次确认./autogpt.sh run -c-y, --skip-reprompt跳过初始提示./autogpt.sh run -y-l, --continuous-limit N连续模式下限定步数./autogpt.sh run -c -l 20--speak启用语音输出./autogpt.sh run --speak--debug启用调试模式./autogpt.sh run --debug--skip-news跳过启动时的新闻输出./autogpt.sh run --skip-news--ai-name TEXT指定 AI 名称./autogpt.sh run --ai-name MyAgent--ai-role TEXT指定 AI 角色./autogpt.sh run --ai-role Researcher--constraint TEXT添加约束条件./autogpt.sh run --constraint Only use English--resource TEXT添加可用资源./autogpt.sh run --resource Web browser--best-practice TEXT添加最佳实践./autogpt.sh run --best-practice Think step by step--override-directives覆盖指令而非追加配合上述参数使用--component-config-file TEXT指定 JSON 配置文件路径./autogpt.sh run --component-config-file config.json4.2.3 服务模式serve 模式./autogpt.sh serve启动 Agent Protocol 兼容的服务器默认运行在http://localhost:8000暴露标准 Agent Protocol API提供 Web 前端界面每个任务创建自定义 Agent可通过 API 远程调用4.2.4 交互式批准流程Classic 版采用交互式安全控制确认模式每次 Agent 行动前会暂停等待用户确认输入y继续输入y -N如y -10自动批准后续 N 步输入其他内容可给出反馈/指导注意事项全自动模式y -N需密切监控 API 费用可以像指导员工一样指导 Agent“你已经搜过了试试不同的关键词”4.2.5 Workspace工作空间系统Agent 在隔离的工作空间内运行{workspace}/ ├── .autogpt/ │ ├── autogpt.yaml # 工作空间级权限 │ ├── ap_server.db # Agent Protocol 数据库 │ └── agents/ │ └── AutoGPT-{agent_id}/ │ ├── state.json # Agent 配置文件 │ ├── permissions.yaml # Agent 级权限 │ └── workspace/ # Agent 沙箱工作目录多个 Agent 可共存于同一工作空间文件访问被限制在 Agent 的workspace/子目录状态跨会话持久化4.3 权限系统AutoGPT 使用分层权限系统模式匹配检查顺序首次匹配优先Agent 拒绝列表 → 阻止工作空间拒绝列表 → 阻止Agent 允许列表 → 允许工作空间允许列表 → 允许提示用户 → 交互批准模式语法格式command_name(glob_pattern)模式描述read_file({workspace}/**)读取工作空间内任何文件execute_shell(python:**)执行 Python 命令web_search(*)所有网络搜索execute_shell(sudo:*)所有 sudo 命令建议拒绝交互批准范围当被提示权限时Once仅允许这一次Agent对此 Agent 永久允许保存至permissions.yamlWorkspace对此工作空间所有 Agent 允许保存至autogpt.yamlDeny拒绝默认拒绝敏感文件.env,.key,.pem破坏性命令rm -rf,sudo工作空间外的操作4.4 Makefile 常用命令在autogpt_platform目录下命令功能make help查看所有可用命令make start-core启动核心服务Supabase Redis RabbitMQmake stop-core停止核心服务make logs-core查看核心服务日志make format格式化后端Python和前端TypeScript代码make migrate运行后端数据库迁移make run-backend运行后端 FastAPI 服务make run-frontend运行前端 Next.js 开发服务4.5 Docker Compose 常用命令命令功能docker compose up -d后台启动所有服务docker compose stop停止服务不删除容器docker compose rm移除已停止的容器docker compose build构建/重建服务docker compose down停止并移除容器、网络、卷docker compose watch监听代码变化并自动更新docker compose ps查看所有服务状态docker compose logs -f api_srv查看并跟随指定服务日志五、实际使用场景示例5.1 场景一市场调研 AgentName: MarketResearcherGPT Role: 研究市场趋势并生成报告的 AI Goals: 1. 搜索 2026 年最热门的咖啡趋势 2. 识别每个趋势的目标人群 3. 将结果保存到 coffee_trends_2026.txt 4. 关闭执行过程Agent 思考“我需要先搜索 Google 上的 2026 年咖啡趋势”计划“使用 google_search 工具”行动执行搜索…分析搜索结果浏览网页获取详细信息调用 write_to_file 将报告保存到磁盘5.2 场景二自动生成热门话题视频Agent 读取 Reddit 话题识别热门话题基于内容自动生成短视频5.3 场景三YouTube 视频亮点提取订阅 YouTube 频道新视频发布时自动转录AI 识别最有影响力的金句自动生成社交媒体帖子并发布5.4 场景四Platform 可视化构建在 Platform 中拖入 “Web Search” Block连接到 “Text Summarizer” Block连接到 “Email Sender” Block配置参数部署运行六、常见陷阱与解决方案6.1 无限循环症状Agent 反复搜索相同内容解决按CtrlC中断或在确认时反馈你已经搜过了试试不同关键词6.2 API 费用失控症状GPT-4 每次运行可能产生数百/数千次 API 调用解决在 OpenAI 面板设置费用上限避免长时间使用全自动模式6.3 文件保存位置Docker 模式下文件通常保存在workspace目录Classic 模式下在 Agent 的workspace/子目录6.4 Windows 安装注意强烈推荐使用 WSL 2 而非 Hyper-VDocker Desktop 中启用 “Use the WSL 2 based engine”不支持 Podman必须使用 Docker6.5 Raspberry Pi 5 特殊处理默认 16K 页面大小会导致supabase-vector容器问题编辑/boot/firmware/config.txt添加kernelkernel8.img重启后确认getconf PAGESIZE返回40964K七、自定义开发7.1 添加新的 Agent Block创建继承自Block的新类代码放在backend.blocks模块下必须实现input_schemaPydantic 输入模式output_schemaPydantic 输出模式run方法主逻辑test_inputtest_output测试数据测试poetry run pytest backend/blocks/test/test_block.py -s7.2 Forge构建你自己的 AgentForge 是 Agent 应用开发工具包位于classic/forge/处理大部分样板代码可单独使用forge.sdk组件加速开发支持 Benchmark 测试和 UI 集成7.3 Benchmark性能基准agbenchmark可测试任何支持 Agent Protocol 的 Agentpipinstallagbenchmark八、许可证说明部分许可证说明autogpt_platform/Polyform Shield新平台限制商业使用classic/及以外MIT原始 Agent、Forge、Benchmark、前端九、社区与支持Discordhttps://discord.gg/autogpt社区成员 40万GitHub Issueshttps://github.com/Significant-Gravitas/AutoGPT/issues文档https://docs.agpt.co官方域名https://agpt.co十、总结与建议选择哪个版本需求推荐版本快速搭建可视化 AgentAutoGPT Platform新版命令行/技术用户Classic 版构建自定义 AgentForgeClassic 子项目生产部署等待云端 Beta或自托管 Platform本地隐私优先Classic Llamafile 本地模型快速上手建议最快上手使用一键安装脚本curl -fsSL https://setup.agpt.co/install.sh -o install.sh bash install.sh最低成本Classic 版 Groq 或 Llamafile免费本地模型最佳体验Platform 版 OpenAI GPT-4o需付费安全使用始终设置 API 费用上限避免长时间无人看管运行