aaif-goose / goose

#12

44,4914,555+390 todayRust

View on GitHub

an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM

📊 Project Info

Language: Rust
Stars: ⭐ 44,491
Forks: 4,555
Today: +390
Ranking: #12
Collection: Overall
Trending Date: May 7, 2026
Last Push: 5/8/2026

🏷️ Topics

acpaiai-agentsmcp

Goose 5分钟快速开始

Goose 是一个开源的 AI 智能体，支持通过 CLI 在本地运行，可连接多种大语言模型并执行代码、自动化等任务。

🖥️ OS

macOSWindowsLinux

⚙️ Runtime

Rust1.70+

🔧 Tools

curl— 下载安装脚本

📝 Steps

安装 Goose CLI

使用官方安装脚本一键安装 Goose CLI。

下载并执行安装脚本

$ curl -fsSL https://raw.githubusercontent.com/aaif-goose/goose/main/install.sh | bash

✓Expected: 安装完成后显示 'Goose installed successfully' 或类似信息。

💡如果遇到权限问题，可以尝试在命令前加 sudo。

验证安装

检查 Goose 是否安装成功并查看版本。

显示 Goose 版本号

$ goose --version

✓Expected: 输出类似 'goose 0.1.0' 的版本信息。

配置 API 密钥

设置你的大语言模型 API 密钥（以 OpenAI 为例）。

设置 OpenAI API 密钥环境变量

$ export OPENAI_API_KEY='your-api-key-here'

✓Expected: 无输出，但后续命令将使用此密钥。

💡也可以使用其他提供商，如 Anthropic、Ollama 等，详见文档。

运行 Goose 并执行第一个任务

启动 Goose 交互式会话，并让它执行一个简单任务。

启动 Goose 交互模式

$ goose run

在交互界面中输入任务

$ Hello, Goose! 请告诉我今天的日期。

✓Expected: Goose 会调用 LLM 并返回当前日期。

💡如果使用本地模型（如 Ollama），需先启动 Ollama 服务。

✅ 验证成功

成功看到 Goose 返回日期信息，表示安装和配置正确。

✓Goose 响应了你的请求
✓返回了正确的日期

⚡ Quick Tips

CLI使用 goose --help 查看所有可用命令

扩展可以通过 goose install 安装扩展

使用在交互模式中输入 'exit' 退出

🔍 Troubleshooting

❓ 安装脚本执行失败

→ 检查网络连接，或手动从 GitHub Releases 下载二进制文件。

❓ API 密钥错误导致请求失败

→ 确认环境变量已正确设置，且 API 密钥有效。

❓ Goose 命令未找到

→ 确保安装路径在 PATH 中，或重新运行安装脚本。

🎯 Next Steps

阅读官方文档

访问 https://block.github.io/goose 了解更多高级用法。

尝试更多任务

让 Goose 帮你写代码、分析数据或自动化工作流。

加入社区

在 Discord 或 GitHub 上参与讨论和贡献。

Difficulty

入门

Est. Time

1-2天

Target Audience

对AI智能体感兴趣的开发者，包括零基础或Rust新手

🎯 What You'll Learn

学会安装和使用goose桌面应用与CLI，连接多种大语言模型，执行代码编辑、自动化任务等基本操作。

📋 Prerequisites

基本命令行操作了解

能使用终端执行命令，理解文件路径和环境变量

编程基础（任意语言）了解(optional)

理解变量、函数、条件等概念，便于理解AI智能体的工作流

Rust基础知识了解(optional)

goose用Rust编写，了解基础语法有助于理解文档和调试

📚 Resources

必看

goose文档首页

包含安装、配置、使用教程和API参考

必看

Quickstart指南

快速上手步骤，适合初学者

🗺️ Learning Phases

环境准备

⏱ 30分钟

安装goose桌面应用

根据操作系统（macOS/Linux/Windows）从官网或GitHub下载并安装桌面版

💡确保系统满足最低要求，Windows用户可能需要安装WebView2

安装goose CLI

使用提供的命令行安装脚本安装CLI工具，并验证安装成功（运行goose --version）

💡如果遇到权限问题，尝试使用sudo或检查PATH环境变量

快速入门

⏱ 1小时

配置大语言模型提供商

在goose设置中添加API密钥（如Anthropic、OpenAI等），或通过ACP连接已有订阅

💡推荐先使用免费或试用额度，如Ollama本地模型

运行第一个AI智能体任务

在桌面应用或CLI中输入自然语言指令（如“列出当前目录文件”），观察goose执行

💡从简单任务开始，逐步增加复杂度

探索扩展（Extensions）

通过Model Context Protocol连接70+扩展，启用文件操作、代码编辑等功能

💡阅读扩展文档了解具体能力，避免启用过多扩展导致混乱

核心功能实践

⏱ 2-3小时

使用goose进行代码编辑

让goose在指定项目中创建、修改或测试代码文件，学习如何给出清晰指令

💡使用版本控制（如git）备份代码，以防误操作

自动化工作流

编写多步骤任务（如“下载数据、分析、生成报告”），让goose自动执行

💡善用goose的上下文记忆功能，分步调试

数据分析和研究

利用goose读取CSV或JSON文件，进行简单统计分析，学习如何提问以获得准确结果

💡明确数据格式和期望输出，减少歧义

进阶探索

⏱ 2小时

自定义goose发行版

学习如何构建自己的goose发行版，预配置提供商、扩展和品牌

💡参考官方文档中“Custom Distributions”部分，从模板开始

嵌入goose API

在自定义应用中使用goose API，实现AI智能体功能集成

💡Rust开发者可深入阅读API文档，其他语言可调用HTTP接口

诊断与报告

学习如何收集诊断信息，排查常见问题，并提交Issue

💡遇到Bug时先查看Known Issues页面

⚠️ Common Mistakes

❌ 未正确配置API密钥，导致goose无法连接大语言模型

✅ 检查环境变量或设置界面，确保密钥有效且未过期；使用Ollama本地模型可避免此问题

❌ 指令过于模糊，导致goose执行结果不符合预期

✅ 逐步细化指令，分步执行；使用具体文件名、路径和明确的操作动词

❌ 启用过多扩展，导致冲突或性能下降

✅ 从少量必要扩展开始，逐一测试；阅读扩展文档了解兼容性

❌ 在未备份的情况下让goose修改重要文件

✅ 始终使用版本控制（如git）或在修改前手动备份文件

🚀 Next Steps

学完基础后，可以探索：构建自定义goose发行版并分享；嵌入goose API到个人项目中；参与AAIF社区贡献代码或文档；研究Model Context Protocol扩展开发。