OpenClaw 對接本地 Gemma 4：完整配置指南

Wed, 08 Apr 2026 18:18:00 +0800

這篇文章示範如何把 OpenClaw 對接到本地 Gemma 4 模型（透過 Ollama 提供介面）。

如果你還沒完成本地部署，可先參考：

第 1 步：啟動 Ollama API 服務

先啟動 Ollama 服務：

`1`	`ollama serve`

你可以用下面的命令快速測試 API 是否正常：

curl http://localhost:11434/api/generate -d '{
  "model": "gemma4:12b",
  "prompt": "你好"
}'

如果能返回模型輸出，代表本地 API 已可用。

OpenClaw 配置檔路徑通常為：

`1`	`~/.openclaw/config.yaml`

編輯 config.yaml，在 models 中新增一個本地模型條目：

models:
  # 你已有的模型配置...

  gemma4-local:
    provider: ollama
    base_url: http://localhost:11434
    model: gemma4:12b
    timeout: 120s

如果你希望預設走 Gemma 4，可新增：

`1`	`default_model: gemma4-local`

重啟 OpenClaw：

`1`	`openclaw restart`

查看模型列表：

`1`	`openclaw models list`

發起一次對話測試：

`1`	`openclaw chat --model gemma4-local "你好"`

如果對話回傳正常，代表 OpenClaw 已成功接入本地 Gemma 4。