装好 OpenClaw，接上本地 Ollama 模型

第 1 步：确认 Node.js 版本

OpenClaw 是一个 Node.js 程序。官方 Getting Started 写明需要 Node 24.16.0 以上（24.x）或 26.1.0 以上，并建议用 24.22.1+ 或 26.12.1+ 以拿到安全修复：

node -v
npm -v

对照结果：

v24.22.2
11.19.1

版本太低（例如系统自带的 Node 20）时，按官方 Node setup 页面（https://docs.openclaw.ai/install/node）用 nvm、fnm 或官方安装包换成 Node 24 或 26，再继续。

第 2 步：安装 OpenClaw

官方给了两种常用装法，任选其一：

# 方式一：官方安装脚本（会顺带检查 Node）
curl -fsSL https://openclaw.ai/install.sh | bash

# 方式二：npm 全局安装（npm 11.16 及以上要带 --allow-scripts）
npm install -g openclaw@latest --allow-scripts=openclaw

本课实测用的是方式二。npm 12 和 11.16 以后默认拦截第三方包的安装脚本，--allow-scripts=openclaw 只放行 OpenClaw 自己的脚本；装完时 npm 还会对 esbuild、koffi 等依赖打印 install-scripts 警告，不影响使用。装好后看版本：

openclaw --version

对照结果：

OpenClaw 2026.10.9 (8b18b55)

第 3 步：准备一个本地 Ollama 模型

OpenClaw 对 Ollama 模型有两个硬要求：支持工具调用（tools），上下文至少 16K。先从 https://ollama.com/download 装好 Ollama，再拉一个小模型。本课先用最小的 qwen3:0.6b（约 522 MB）跑通流程：

ollama --version
ollama pull qwen3:0.6b
ollama list

对照结果：

ollama version is 0.40.13
NAME          ID              SIZE      MODIFIED
qwen3:0.6b    7df6b6e09427    522 MB    29 seconds ago

用 Ollama 的 /api/show 接口确认模型能力和上下文长度：

curl -s localhost:11434/api/show -d '{"model":"qwen3:0.6b"}' \
  | python3 -c "import json,sys; d=json.load(sys.stdin); \
print(d['capabilities'], d['model_info']['qwen3.context_length'])"

对照结果：

['completion', 'tools', 'thinking'] 40960

tools 在列表里、上下文 40960 大于 16K，符合要求。官方文档默认推荐的是 gemma4，电脑内存够的话可以直接换成它；0.6B 只是为了在普通笔记本上也能很快跑通，第 2 课会看到它的局限。

实测说明：实测主机所在网络拦截了 Ollama 下载模型时的跳转地址，ollama pull 报错，最后是从 Ollama 官方模型仓库（registry.ollama.ai）手动下载、按 sha256 校验后放进模型目录的。正常网络下直接 ollama pull 即可。

第 4 步：用 onboard 一条命令完成初始化

openclaw onboard 是官方的引导式配置，直接运行会一步步问你选什么。想一次配好，可以用官方 Ollama 页面给的非交互写法：

openclaw onboard --non-interactive --accept-risk \
  --flow quickstart --auth-choice ollama \
  --custom-base-url http://127.0.0.1:11434 \
  --custom-model-id qwen3:0.6b \
  --no-install-daemon --skip-channels --skip-search \
  --skip-skills --skip-ui --skip-health

对照结果：

Default Ollama model: qwen3:0.6b
Workspace OK: ~/.openclaw/workspace
Sessions OK: ~/.openclaw/agents/main/sessions
Updated config: ~/.openclaw/openclaw.json
  Backup: ~/.openclaw/openclaw.json.bak

几个参数的意思：

配置写在 ~/.openclaw/openclaw.json。和本课相关的几段（节选，token 已打码）：

"agents": { "defaults": {
  "model": { "primary": "ollama/qwen3:0.6b" } } },
"gateway": {
  "mode": "local",
  "auth": { "mode": "token", "token": "<已打码>" },
  "port": 18789,
  "bind": "loopback" },
"tools": { "profile": "full" }

bind: loopback 表示网关只监听本机 127.0.0.1，别人从网络上连不进来；auth.token 是连网关用的口令，不要贴到聊天群里。

第 5 步：启动网关并体检

网关是 OpenClaw 的常驻进程，聊天渠道、网页控制台和命令行都通过它和智能体说话。官方推荐用 openclaw gateway install 装成系统服务（macOS 用 launchd，Linux 用 systemd）；想先看看效果，可以在一个单独的终端里前台运行：

openclaw gateway run

保持这个终端开着，在另一个终端里检查：

openclaw gateway status
openclaw gateway health
openclaw models list --provider ollama

对照结果（gateway status 为节选，模型列表的列间空格有压缩）：

Gateway: bind=loopback (127.0.0.1), port=18789 (env/config)
Check target: ws://127.0.0.1:18789
Dashboard: http://127.0.0.1:18789/
Gateway version: 2026.10.9
Connectivity check: ok
Listening: 127.0.0.1:18789

Gateway Health
OK (34ms)

Model                Input   Ctx       Local Auth  Tags
ollama/qwen3:0.6b    text    33k/41k   yes   yes   default

Connectivity check: ok 和 Gateway Health OK 说明网关已就绪；模型列表里 Local yes 表示走本机推理，default 表示它是默认模型。Ctx 33k/41k 的意思是 OpenClaw 实际给会话用 32K（33k），模型上限是 40960（41k）。

用 openclaw gateway run 前台运行时，gateway status 会额外提示「Native service is not installed」，这是正常的。装成系统服务后可以用 openclaw gateway restart 重启。

小结

• OpenClaw 需要 Node 24.16+ 或 26.1+，用安装脚本或 npm install -g openclaw@latest 安装。
• 本地模型必须支持 tools、上下文 ≥16K，用 /api/show 可以自己核对。
• openclaw onboard 写好 ~/.openclaw/openclaw.json，并建好工作区 ~/.openclaw/workspace。
• 网关默认只监听本机 18789 端口，用 gateway status、gateway health 体检。
• 下一课和智能体对话，改它的「人格」文件，并看看小模型能不能真的动手干活。