codecamp

Ollama Goose

Goose 是 Block 开源的可扩展 AI 代理,同时提供桌面应用和 CLI 两种形态。它的接入方式是图形界面里点几下,比命令行工具更适合不想碰配置文件的人。

版本基线 v0.40.12,官方 docs.ollama.com/integrations/goose。

一、Goose Desktop(桌面版)

先安装 Goose Desktop。

接本地 Ollama

  1. 打开 Goose → Settings → Configure Provider
  2. 找到 Ollama,点 Configure
  3. 确认 API Host 是 http://localhost:11434,点 Submit

三步就完了,不需要改任何配置文件。

接 ollama.com 云端

  1. 在 ollama.com/settings/keys 生成 API Key,存到 .env 文件
  2. Goose 里把 API Host 设为 https://ollama.com

二、Goose CLI(命令行版)

先装 Goose CLI。

接本地 Ollama

goose configure

然后按提示操作:

  1. 选 Configure Providers
  2. 选 Ollama
  3. 输入模型名,比如 qwen3

接 ollama.com 云端

  1. 生成 API Key 存到 .env
  2. 运行 goose configure
  3. 选 Configure Providers → Ollama
  4. 把 OLLAMA_HOST 改成 https://ollama.com

三、桌面版 vs CLI 配置对照

配置项 Desktop CLI
入口 Settings → Configure Provider goose configure
本地地址 http://localhost:11434 同上
云端地址 https://ollama.com OLLAMA_HOST=https://ollama.com
模型选择 图形下拉 命令行输入模型名
认证 .env 里的 API Key 同左

注意云端场景下的字段名差异:桌面版叫 API Host,CLI 里叫 OLLAMA_HOST,值都是 https://ollama.com——不带 /v1。

四、常见问题

现象 原因 处理
Provider 列表里没有 Ollama Goose 版本过旧 升级 Goose
连不上本地服务 Ollama 未启动 先 ollama serve
模型名报错 名称与本地不一致 ollama list 核对
云端 401 .env 里的 key 未加载 确认 .env 位置和变量名
改了 Host 不生效 需重启 Goose 重启应用

动手试

## ① 确认本地模型
ollama list

## ② 确认服务在跑
curl http://localhost:11434/api/version

两条都正常,就在 Goose 里直接把 API Host 填 http://localhost:11434,秒连。

Ollama Droid
Ollama Oh My Pi
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

Ollama Cloud

Ollama CLI 命令行参考

Ollama Modelfile 参考

Ollama 上下文长度

Ollama 导入自定义模型

Ollama 常见问题

Ollama 硬件支持

Ollama 故障排查

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }