
Goose 是 Block 于 2025 年 1 月 28 日开源的本地 AI 智能体 ,2026 年 4 月迁入 Linux 基金会 Agentic AI Foundation(AAIF)治理,仓库从 block/goose 迁移到 aaif-goose/goose,文档迁移到 goose-docs.ai 。它是 Agent 框架分类中“本地开发者智能体平台”的代表作。
官方定位:”Your native open source AI agent. Desktop app, CLI, and API — for code, workflows, and everything in between” 。核心能力:Rust 实现的本地原生智能体,不止于代码——研究、写作、自动化、数据分析统一工作区 ;桌面应用(macOS/Linux/Windows)+ 完整 CLI + 可嵌入 API 三形态 ;70+ MCP 扩展(数据库、API、浏览器、GitHub、Google Drive 等) ;Recipes(YAML 工作流)、MCP Apps(扩展渲染交互 UI)、Subagents(并行执行) ;15+ LLM 提供商 ;四种执行模式(Autonomous/Smart Approval/Manual Approval/Chat-only),Autonomous 为默认 。
产品概述
Goose 的故事始于 Block 内部工具需求——2025 年 1 月 28 日 Block 开源办公室以”Codename Goose”发布,定位”connect LLMs to real-world actions” 。到 2025 年 10 月,Block 已将 Goose 部署至全体 12,000 名员工,工程师报告每周节省 8-10 小时 。
2025 年 12 月 9 日,Linux 基金会宣布成立 Agentic AI Foundation(AAIF),Anthropic 的 MCP、OpenAI 的 AGENTS.md、Block 的 Goose 作为创始贡献 。2026 年 4 月 7 日,Goose 完成基础设施迁移:GitHub 仓库迁至 aaif-goose/goose,文档迁至 goose-docs.ai,旧 URL 仅返回 HTTP 200 客户端重定向 。
为何迁出 Block:AAIF CTO Manik Surtani(Block 前开源负责人)明确表示,Block 保留 Goose 商标”hampering enterprise adoption“——企业担心建立在单一供应商可单方面控制的平台上 。迁入 AAIF 后,Goose 成为 LF Projects, LLC 的 Series,由文档化的 MAINTAINERS/GOVERNANCE 流程治理,而非单一公司路线图 。
核心定位哲学:
官方站点开宗明义——”Goose is a general-purpose AI agent that runs on your machine. Not just for code — use it for research, writing, automation, data analysis, or anything you need to get done” 。三个不可妥协的设计原则:
- 本地原生:Rust 实现,运行在用户机器上——桌面应用、CLI、API 三形态统一
- 模型无关:15+ LLM 提供商,包括 Ollama 本地模型路径——可配置为代码、提示、上下文均不离开网络
- MCP 原生扩展:70+ 扩展 + 整个 MCP 生态系统(AAIF 统计 10,000+ 已发布 MCP 服务器 )
它做什么 / 不做什么(关键归类):
- ✅ 做:作为本地智能体运行 → 用户通过桌面应用/CLI/API 交互 → Goose 自主执行工程任务(读写文件、运行命令、安装依赖、执行测试、调用外部 API、迭代修复);通过 MCP 协议连接 70+ 扩展;通过 Recipes(YAML)定义可复用工作流;通过 Subagents 并行处理任务
- ❌ 不做:不提供 LLM 推理本身(需外接 15+ 提供商 API,或本地 Ollama);无宿主推理、无订阅 ——用户自行承担模型 API 费用
- 本质是本地智能体平台:它必须安装在用户机器上(桌面应用/CLI),或嵌入到用户应用中(API)——与 AutoGPT Platform(远程 SaaS)、Pinecone(远程 SaaS)有根本形态差异。它是 Agent 框架分类中唯一的”本地原生智能体平台”。
技术架构 :
- 实现语言:Rust(核心 58.7%)+ TypeScript(桌面端 33.3%,Tauri 框架)+ Shell/HTML/Python/JavaScript
- 核心引擎:Rust 实现,无运行时依赖,快速启动,低内存占用
- 三形态统一核心:
- Desktop App:Tauri 构建,macOS/Linux/Windows 原生 GUI,支持 MCP Apps(扩展渲染交互 UI)
- CLI:完整终端接口,用于脚本、CI/CD、无头自动化
- API:编程接口,将 Goose 嵌入现有工具与平台
- 智能体循环:基于”感知-规划-执行-验证”闭环——解析任务意图,拆分为可执行步骤,调用相应工具,基于反馈自动重试或调整策略
- MCP 协议架构:外部工具封装为独立 MCP Server,通过 JSON-RPC 通信,LLM 动态发现与调用
- ACP(Agent Client Protocol):Goose 可作为 ACP 服务器,从 Zed/JetBrains/VS Code 连接;也可使用 ACP 智能体(如 Claude Code、Codex)作为子提供商
- 配置:
~/.config/goose/config.yaml定义提供商、模型、扩展 - 会话持久化:
~/.local/share/goose/sessions/*.jsonl本地存储,无服务器端持久化,可恢复 - 部署形态:桌面应用安装 / CLI 安装(
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash)/ Homebrew(brew install goose-cli)/ Cargo(cargo install goose-cli) - 能力矩阵:
- 8 个内置扩展:data visualization、JS execution、computer control、developer tools、memory、subagent delegation、persistent instructions、tutorial system
- 50+ 社区 MCP 扩展:GitHub、MongoDB、Figma、媒体生成等
- 70+ 第一方扩展:覆盖版本控制、通信、数据库、项目管理、云与 DevOps、数据与分析、AI/ML、生产力工具
- 10,000+ MCP 生态系统:任何标准 MCP 服务器均可接入
许可策略:Apache-2.0 许可证 ——允许商用、修改、分发、嵌入或分支而无源代码披露义务(不同于某些 source-available 或非商业条款项目) 。
治理演进(关键):
📌 2026 年 4 月仓库迁移:Goose 从
github.com/block/goose迁移到github.com/aaif-goose/goose,文档从block.github.io/goose迁移到goose-docs.ai。旧 URL 仍返回 HTTP 200 但客户端重定向到新域名 。AAIF 治理:Goose 成为 LF Projects, LLC 的 Series,由文档化的 MAINTAINERS/GOVERNANCE 流程治理 。AAIF 白金会员:AWS、Anthropic、Block、Bloomberg、Cloudflare、Google、Microsoft、OpenAI 。
Block 保留角色:Block 仍是活跃维护者 ,但是现在是在 AAIF 治理框架下,而非单一公司路线图。
安全模型(至关重要):
Goose 文档对默认自主性异常坦诚 ——四种执行模式:
- Completely Autonomous:默认模式,修改文件、运行命令、可删除文件而无需询问
- Smart Approval:基于 LLM 的分类器(PermissionJudge)自动批准其判定为低风险的动作,标记其余
- Manual Approval:每次工具调用需确认
- Chat-only:无工具访问
Goose 的 SECURITY.md 明确承认:”developer agents have the ability to run code and take actions on your computer” 并构成与纯聊天 LLM 不同的风险画像。
社区与生态:
- 52,751 GitHub Stars、6,000+ Forks(2026 年 8 月 13 日)
- 500+ 贡献者
- 每周发布节奏(v1.40–v1.46 在 2026 年 7-8 月密集发布)
- Block 全员 12,000 人部署,工程师每周节省 8-10 小时
- Discord 社区、GitHub 贡献、社区扩展市场
核心能力
-三形态统一(核心差异化)
- Desktop App:Tauri 构建的 macOS/Linux/Windows 原生 GUI,类聊天界面,支持 MCP Apps(扩展渲染交互 UI:按钮、表单、可视化)
- CLI:完整终端接口,用于脚本、CI/CD 流水线、无头自动化
- API:编程接口,将 Goose 嵌入现有工具与平台
- 统一能力面:三种形态暴露完全相同的智能体能力
-MCP 原生扩展(杀手锏特性)
- 70+ 第一方扩展:覆盖版本控制(GitHub/GitLab/Bitbucket)、通信(Slack/Discord/Email)、数据库(PostgreSQL/SQLite/MongoDB)、项目管理(Jira/Linear/Asana/Trello)、云与 DevOps(AWS/GCP/Azure/Docker/K8s/Terraform)、数据与分析(BigQuery/Snowflake/Databricks/Airtable)、AI/ML(HuggingFace/OpenAI/Anthropic/Ollama)、生产力(Google Drive/Notion/Confluence/Obsidian)
- 10,000+ MCP 生态系统:AAIF 统计 10,000+ 已发布 MCP 服务器 ,任何标准 MCP 服务器均可接入
- 8 个内置扩展:data visualization、JS execution、computer control、developer tools、memory、subagent delegation、persistent instructions、tutorial system
- MCP 服务器动态发现:工具在运行时动态发现与调用
- 自定义扩展:可构建自己的 MCP 扩展
-Recipes(可复用工作流)
- YAML 定义的便携式配置:打包 extensions + prompts + settings + parameters + subrecipes
- 版本可控:作为 YAML 文件纳入版本控制,可分享给同事直接启动
- Subrecipes:一个 Recipe 可委派并行 Subagents
- CI 集成:Recipes 可在 CI 中以无头模式运行
- 社区 Recipes:”setup new Node.js project”、”migrate database schema”、”generate and commit changelog” 等常见模式
-Subagents(并行执行)
- 独立子智能体:spawn 独立 subagents 并行处理任务
- 主会话清洁:code review、research、file processing 在不同 lane 并行,主会话保持清洁
- Recipe 委派:通过 subrecipes 在 Recipe 中委派并行 subagents
-全系统自治
- 文件操作:读写、行编辑
- Shell 执行:运行 shell 命令
- 依赖安装:自动安装包
- 测试运行:执行测试套件
- 代码迭代:错误自修复直至交付
- API 调用:调用外部 API
- 对比传统编码助手:Claude Code/Cursor/Aider 仅代码建议、有限文件编辑、无 shell 访问、无包安装、无网页浏览;Goose 具有完全系统级能力
-四种执行模式
- Autonomous(默认):修改文件、运行命令、删除文件而无需询问
- Smart Approval:LLM-based PermissionJudge 分类器自动批准低风险动作,标记其余
- Manual Approval:每次工具调用需确认
- Chat-only:无工具访问
- 切换方式:
goose configure、/mode命令、或GOOSE_MODE环境变量
-模型无关(15+ 提供商)
- Anthropic:Claude Opus、Sonnet(Berkeley Function-Calling Leaderboard 强工具调用)
- OpenAI:GPT-4o、o3-mini(强通用性能)
- Google:Gemini 3.1 Pro、Ultra(2M token 上下文选项)
- Ollama:Llama 4、Qwen3、Gemma 3(完全本地,零 API 成本)
- Mistral:Mistral Large、Codestral(欧洲数据驻留选项)
- xAI:Grok 4
- Azure OpenAI:企业 VNet 支持
- AWS Bedrock:Claude on Bedrock,AWS IAM auth
- 其他:Databricks、Groq、DeepSeek、Cohere、Fireworks、LM Studio、OpenRouter
- ACP 订阅复用:通过 ACP 使用现有 Claude/ChatGPT/Gemini 订阅
- 按任务路由:复杂推理用 Claude,简单任务路由到本地 Llama 以降成本
-安全层
- Prompt Injection Detection:提示注入检测
- Tool Permission Controls:工具权限控制
- Sandbox Mode:沙箱模式
- Adversary Reviewer:对抗审查员监视不安全动作
- 本地优先:敏感操作均在本地完成,代码永不离开用户机器(除非选择云端 API)
-ACP 集成
- 作为 ACP 服务器:从 Zed、JetBrains、VS Code 连接
- 作为 ACP 客户端:使用 Claude Code 或 Codex 作为子提供商
- 编辑器集成:通过 ACP 融入现有开发环境
-会话管理
- 本地持久化:
~/.local/share/goose/sessions/*.jsonl - 会话恢复:
goose session list/goose session resume - 无服务器端持久化:隐私优先
优势亮点
- Apache-2.0 最干净许可:允许商用、修改、分发、嵌入或分支而无源代码披露义务——与 Milvus/Qdrant/Vespa/AG2 同属最宽松许可阵营
- Linux 基金会 AAIF 治理:2026 年 4 月迁入 AAIF,Block 保留商标不再成为采用障碍,企业可放心构建
- 本地原生 + 全系统自治:Rust 实现,运行在用户机器上,具有完全系统级能力(文件编辑、shell 执行、包安装、测试运行)——超越传统编码助手
- 模型完全无关:15+ 提供商 + Ollama 本地路径,无供应商锁定,可按任务路由
- MCP 生态系统最深:70+ 第一方扩展 + 10,000+ MCP 服务器生态 ,是”MCP 参考实现”级别
- 三形态统一:桌面应用 + CLI + API 能力完全一致,适配任何工作流
- Recipes 可复用:YAML 工作流版本可控、可分享、可 CI 集成
- Subagents 并行:多 lane 并行处理,主会话清洁
- MCP Apps:扩展可在桌面应用内渲染交互 UI
- ACP 标准:与 Zed/JetBrains/VS Code 集成,也可使用 Claude Code/Codex 作为子提供商
- 零成本本地路径:Ollama + 本地模型 = 边际成本仅为电费
- 52,751 GitHub Stars:社区认知度极高,500+ 贡献者,每周发布节奏
- Block 全员 12,000 人部署验证:工程师每周节省 8-10 小时
- 安全层完备:Prompt injection detection、tool permission controls、sandbox mode、adversary reviewer
- 无宿主推理、无订阅:用户自行承担模型 API 费用或本地零成本
局限
- ⚠️ Autonomous 默认模式的安全风险:默认 Autonomous 模式会修改文件、运行命令、可删除文件而无需询问 。首次使用者若跳过配置步骤,将以无人值守方式运行具有修改或删除文件权限的智能体。SECURITY.md 明确承认”developer agents have the ability to run code and take actions on your computer” 构成与纯聊天 LLM 不同的风险画像。建议生产环境使用 Smart Approval 或 Manual Approval 模式
- ⚠️ 无商业支持或 SLA:开源社区开发意味着支持依赖 GitHub Issues 和 Discord 响应,无合同约定的运行时间保证
- ⚠️ 无合规认证:社区驱动开发未追求 SOC 2、HIPAA 或其他认证 ,对需要认证供应商的受监管行业是硬约束
- ⚠️ BYOK API 成本需主动管理:用户必须跨提供商监控 LLM API 支出、配置计费限制、自行处理速率限制错误 ——比固定订阅工具操作开销大
- ⚠️ 第三方对比数据过时:由于 2026 年 4 月所有权变更,多数第三方对比、star 计数、评论都是针对
block/goose写的,在所有权和数量上已过时 - 与 OpenManus 对比:OpenManus 是框架型通用智能体(Python,
python main.py即用,开发者向);Goose 是本地智能体产品(Rust,桌面/CLI/API),更偏工具属性 - 与 AutoGPT 对比:AutoGPT Platform 是远程可视化 SaaS(Polyform Shield 许可,Blocks 组装 + Marketplace + 持续运行);Goose 是本地智能体(Apache-2.0),无宿主推理、无订阅、无 Marketplace
- 与 AG2/CrewAI/LangGraph/MAF 对比:这些是开发者框架/SDK(写代码调用库);Goose 是本地智能体产品(终端/桌面/API 交互)
- 与 OpenClaw 对比:OpenClaw 是个人 AI 智能体(通过聊天应用接收指令);Goose 是开发者优先的本地智能体平台,全系统自治能力更强
- 学习曲线:Recipes YAML、MCP 配置、
~/.config/goose/config.yaml手动编辑对纯 GUI 用户有一定门槛 - 资源消耗:Rust 核心虽轻量,但全系统自治 + 多 Subagents 并行 + 本地模型(Ollama)可能需要显著内存与 CPU
适用人群
- 开发者本地日常任务自动化:代码生成、测试运行、依赖管理、bug 修复
- 终端/桌面/API 工作流集成:需要统一智能体能力覆盖三种交互形态
- 隐私敏感/受监管环境:通过 Ollama 本地模型路径确保代码、提示、上下文均不离开网络
- 模型无关诉求:不愿被单一 LLM 厂商锁定,需按任务在 Claude/GPT/Gemini/本地模型间路由
- MCP 生态系统用户:需要连接 GitHub/Slack/Notion/Google Drive/Jira 等 70+ 扩展
- 可复用工作流需求:通过 Recipes YAML 将团队工作流版本化、分享、CI 集成
- 并行任务处理:通过 Subagents 在多 lane 并行执行 code review/research/file processing
- 企业采用(AAIF 治理后):2026 年 4 月后 Linux 基金会治理消除了”单一供应商控制”顾虑
- Block 式全员部署:组织级智能体平台,工程师生产力提升(Block 自身 12,000 人部署,每周节省 8-10 小时)
- 预算敏感开发者:BYOK 模型下典型工作流每月 $5-$50 API 费用,比订阅制工具在中等使用强度下更便宜
- ACP 编辑器集成:Zed/JetBrains/VS Code 用户通过 ACP 接入
⚠️ 不适用场景:
- 需要商业支持或 SLA 的组织(Goose 无合同化支持承诺)
- 受监管行业需要 SOC 2/HIPAA 认证(Goose 无合规认证)
- 不愿手动管理 LLM API 成本与限额的团队
- 纯 GUI 用户不愿编辑 YAML 配置
安装与部署
1. 环境要求
- macOS / Linux / Windows
- 可选:Docker(容器化部署)、Ollama(本地模型)
2. 安装 CLI(推荐)
# macOS / Linux 一行命令 curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash # Homebrew brew install goose-cli # Cargo(从源码) cargo install goose-cli
3. 安装桌面应用
# 从 goose-docs.ai 下载 macOS/Linux/Windows 安装器 # https://goose-docs.ai # 或通过 CLI 安装后启动桌面应用
4. 配置提供商
# 交互式配置 goose configure # 或手动编辑 ~/.config/goose/config.yaml # 15+ 提供商任选: # Anthropic GOOSE_PROVIDER: anthropic GOOSE_MODEL: claude-sonnet-4-7 ANTHROPIC_API_KEY: sk-ant-... # OpenAI GOOSE_PROVIDER: openai GOOSE_MODEL: gpt-5-code OPENAI_API_KEY: sk-... # 本地 Ollama(零 API 成本) GOOSE_PROVIDER: ollama GOOSE_MODEL: qwen3-coder:32b OLLAMA_HOST: http://localhost:11434 # AWS Bedrock GOOSE_PROVIDER: bedrock GOOSE_MODEL: anthropic.claude-sonnet-4-7-v1:0 AWS_PROFILE: default
5. 配置扩展(MCP 服务器)
# ~/.config/goose/config.yaml
extensions:
developer:
name: Developer
type: builtin
enabled: true
filesystem:
type: stdio
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/code"]
enabled: true
github:
type: stdio
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: ${env:GITHUB_PAT}
enabled: true
6. 交互式会话
# 启动会话 goose session # 一次性任务 goose run "Write unit tests for src/auth.py and run them" # 恢复上次会话 goose session --resume # 指定配置文件 goose session --profile devops # 切换执行模式(重要!) goose configure # 选择 Smart Approval 或 Manual Approval # 或通过 /mode 命令 # 或通过 GOOSE_MODE 环境变量
7. 使用 Recipes
# .goose/recipes/test-runner.yaml version: "1.0" title: "Test Runner" description: "Run tests, fix failures, iterate" instructions: | You are a test-fixing agent. Run pnpm test, parse failures, fix the underlying code (not the tests), and iterate until green. If you cannot fix in 5 iterations, return the failure log. prompt: | Run the test suite and fix any failures. parameters: key: project_dir requirement: required extensions: name: developer type: builtin
# 运行 Recipe goose run --recipe test-runner.yaml --params project_dir=/path
8. Docker 容器化部署(隔离执行)
# 使用 Docker Model Runner + MCP Gateway + Goose 容器化部署 # 参考 Docker 官方博客的 Goose + Docker 集成模式 # 通过 agentgateway 路由 LLM 调用,统一审计与限流
9. 部署前必检清单
- 确认仓库位于
github.com/aaif-goose/goose(2026 年 4 月后官方) - 旧仓库
github.com/block/goose仅返回重定向 - 许可:Apache-2.0 ,可商用嵌入或分支而无源代码披露义务
- 严格属于 Agent 框架分类,“本地开发者智能体平台”子类
- 官方定位:”Your native open source AI agent. Desktop app, CLI, and API”
- 开发方:Block 创建,2026 年 4 月捐赠至 Linux 基金会 AAIF 治理
- 语言:Rust(核心 58.7%)+ TypeScript(桌面端 33.3%,Tauri)
- 最新版本:v1.46.0(2026 年 8 月 12 日),每周发布节奏
- 社区规模:约 52,751 GitHub Stars、6,000+ Forks、500+ 贡献者(2026 年 8 月)
相关导航


AutoGPT

OpenManus

Mastra

MAF

CrewAI

LangGraph

