goose 上手：命令行装好开源 AI Agent，内置本地模型、无头任务、会话与 Recipe
按 goose 官方文档（goose 1.56.0 实测）：一行脚本装好命令行，用内置本地推理下载 Gemma 4 小模型、不要 API Key 跑通第一个任务；再无头运行让它写文件、跑命令，管理会话、用 .goosehints 写项目约定并在请求日志里验证；最后把常用任务写成带参数、输出 JSON 的 Recipe，学会校验、预览渲染和 indent() 过滤器。
入门·3 课时·67 分钟·图文实操
免费学习无需登录
你将学会
- 一行命令装好 goose 命令行
- 用内置本地推理免 Key 跑模型
- 无头运行让 goose 写文件跑命令
- 列出、导出与续接会话
- 用 .goosehints 写项目约定并验证
- 写带参数和 JSON 输出的 Recipe
适合谁
- 想试开源 AI Agent 的开发者
- 想离线、不花 API 费用跑智能体的用户
- 想把重复任务做成脚本化流程的工程师
课前准备
- 会用终端基本命令
- 内存 8 GB 以上，磁盘留 3 GB 放模型
- Linux 精简系统需能装 bzip2
课程目录
3 课时 · 67 分钟- 01装好 goose，用内置本地模型跑第一个任务了解 goose 是什么、能接哪些模型，用官方一行脚本安装（附缺 bzip2 的报错与解法），用 goose info 找到配置和会话文件，用 goose local-models 搜索、下载、列出 Gemma 4 小模型，用环境变量或 config.yaml 指定提供商和模型，再用 goose run 跑通第一次问答。图文20 分钟开始本课
- 02无头运行、会话管理与 .goosehints 项目约定认识 developer 扩展和四种权限模式，用 goose run 让 goose 在空目录里写 hello.py 并运行，用 GOOSE_MAX_TURNS 限制轮数、-n 命名、-i 从文件读任务，用 session list / export 查看和导出会话，最后写 .goosehints 并到 llm_request 日志里确认约定已进入系统提示。图文23 分钟开始本课
- 03Recipe：带参数的可复用任务与结构化 JSON 输出写一份带必填、可选参数和 response.json_schema 的 Recipe，用 recipe validate、--explain、--render-recipe 校验和预览，运行拿到固定结构的 JSON 并通过改提示词修正结果，再实测 file 类型参数的多行缩进坑与 indent() 解法，最后用 GOOSE_RECIPE_PATH、deeplink 和 schedule 管理与定时运行。图文24 分钟开始本课
课程说明
goose 是一个开源的通用 AI Agent（Apache-2.0），由 Linux 基金会旗下的 Agentic AI Foundation（AAIF）托管。它能读写文件、执行命令、调用各种扩展，有桌面应用和命令行两种形态。官方 2026 年 4 月的博客宣布它内置了本地推理（基于 llama.cpp），不接任何云端模型、不填 API Key 也能跑起来。
本课按 goose 官方文档（https://goose-docs.ai/docs/quickstart ）整理。2026-10-28 在一台没有显卡的 Linux 云主机上，用 goose 1.56.0 和 Gemma 4 E2B 小模型（Q4_K_M 量化，2.9 GB）逐条实跑，「对照结果」都是真实输出。桌面应用、会话续接与分叉、定时任务等没有在主机上运行的部分取自官方文档，课内会单独注明「未实测」。共 3 课时：
| 课时 | 你会做完的事 | 需要什么 |
|---|---|---|
| 1 | 装好 goose 命令行，下载内置本地模型，指定提供商和模型，跑通第一次问答 | 终端，8 GB 以上内存 |
| 2 | 无头运行让 goose 写文件、跑命令，限制轮数，列出和导出会话，用 .goosehints 写项目约定并验证 | 同上 |
| 3 | 写带参数和 JSON 输出的 Recipe，校验、预览、运行，处理多行参数缩进，列出、分享和定时运行 | 同上 |
适合
- 想动手试试开源 AI Agent 的开发者
- 想离线、不花 API 费用跑智能体的个人用户
- 想把重复的命令行任务做成可复用流程的工程师
先修
- 会用终端基本命令
- 内存 8 GB 以上，磁盘留出约 3 GB 放模型。本地小模型在纯 CPU 上一次任务要 2～4 分钟，换成云端模型会快很多
- 精简版 Linux 需要能安装
bzip2
官方来源：
- goose 文档首页与 Quickstart：https://goose-docs.ai/docs/quickstart
- Install goose：https://goose-docs.ai/docs/getting-started/installation
- Configure LLM Provider：https://goose-docs.ai/docs/getting-started/providers
- 内置本地推理博客：https://goose-docs.ai/blog/2026/04/24/use-goose-with-built-in-local-inference
- CLI Commands：https://goose-docs.ai/docs/guides/goose-cli-commands
- Running Tasks：https://goose-docs.ai/docs/guides/running-tasks
- Headless Mode：https://goose-docs.ai/docs/tutorials/headless-goose
- Session Management：https://goose-docs.ai/docs/guides/sessions/session-management
- Permission Modes：https://goose-docs.ai/docs/guides/managing-tools/goose-permissions
- Providing Hints：https://goose-docs.ai/docs/guides/context-engineering/using-goosehints
- Environment Variables：https://goose-docs.ai/docs/guides/environment-variables
- Recipe Reference：https://goose-docs.ai/docs/guides/recipes/recipe-reference
- Reusable Recipes：https://goose-docs.ai/docs/guides/recipes/session-recipes
- Recipes 教程：https://goose-docs.ai/docs/tutorials/recipes-tutorial
- 源码仓库：https://github.com/aaif-goose/goose
绑定工具： goose（/tools/goose/）