一、最终架构（先理解）
完整系统其实是 3 层：
OpenClaw (AI Agent)
│
└── OpenAI Compatible API
│
└── Ollama (本地模型服务)
│
└── Qwen2.5 / Qwen3 / Llama3
关键点：
- OpenClaw → Agent 框架（调工具、执行任务）
- Ollama → 本地 LLM 服务
- Qwen → 真正的大模型
OpenClaw 不会直接加载模型，必须通过 API。
二、系统环境准备
1. 确认 Node 版本
OpenClaw 要求 Node ≥ 22。
检查：
node -v
应该是：
v22.x.x
如果不是：
nvm install 22
nvm use 22
2. 安装 pnpm
OpenClaw 推荐：
npm install -g pnpm
检查：
pnpm -v
三、安装 OpenClaw
安装：
pnpm add -g openclaw
或者
npm install -g openclaw
验证：
openclaw --version
如果输出版本说明安装成功。
四、第一次初始化 OpenClaw
运行：
openclaw onboard
你会看到类似界面：
I understand this is personal-by-default...
选择：
Yes
Onboarding Mode
选择：
QuickStart
原因：
- 自动生成配置
- 后面可以再改
Gateway
选择：
Local gateway
默认：
ws://127.0.0.1:18789
这是 OpenClaw Agent 端口。
Network Binding
选择：
Loopback (127.0.0.1)
原因：
- 只允许本机访问
- 最安全
五、安装本地模型服务
安装 Ollama：
curl -fsSL https://ollama.ai/install.sh | bash
验证：
ollama -v
六、下载 Qwen 本地模型
推荐先下载小模型测试。
ollama pull qwen2.5:7b
如果内存小：
ollama pull qwen2.5:3b
查看模型：
ollama list
示例输出：
NAME qwen2.5:7b
七、测试本地模型
直接运行：
ollama run qwen2.5:7b
输入：
hello
如果模型回答说明正常。
退出：
Ctrl + C
八、启动 Ollama API
运行：
ollama serve
默认 API：
http://127.0.0.1:11434
测试：
curl http://127.0.0.1:11434
如果返回：
Ollama is running
说明正常。
九、配置 OpenClaw 使用 Ollama
打开配置文件：
nano ~/.openclaw/config.yaml
示例配置：
models:
providers:
ollama:
baseUrl: http://127.0.0.1:11434/v1
agents:
default:
model:
primary: ollama/qwen2.5:7b
保存退出：
CTRL + X Y
十、启动 OpenClaw Gateway
运行：
openclaw gateway start
如果成功会显示：
Gateway started ws://127.0.0.1:18789
十一、测试 OpenClaw
方式 1：
openclaw chat
输入：
解释一下 Redis
如果返回回答说明成功。
方式 2：
浏览器访问：
http://127.0.0.1:18789
十二、常见问题
问题 1：Node 版本错误
错误：
Node version too low
解决：
nvm install 22
nvm use 22
问题 2：OpenClaw 命令不存在
原因：PATH 没有更新。
解决：
npm config get prefix
加入 PATH。
或者重新安装：
npm install -g openclaw
问题 3：Gateway 启动失败
检查端口：
lsof -i :18789
杀掉进程：
kill -9 PID
重新启动：
openclaw gateway start
问题 4：Ollama 连接失败
检查：
curl http://127.0.0.1:11434
如果失败：
重新启动：
ollama serve
问题 5：模型不存在
检查：
ollama list
没有模型：
ollama pull qwen2.5:7b
问题 6：AI 回复特别慢
本地模型推理慢。
解决：
换小模型：
qwen2.5:3b
十三、推荐模型（Mac）
如果是 M 系列：
推荐：
qwen2.5:7b
或者：
llama3:8b
如果内存 ≥ 32GB：
qwen2.5:14b
十四、进阶玩法
OpenClaw 真正的强大是 Tools + Agent。
例如：
AI 自动写 SQL：
用户：查今天订单量
AI：SELECT count(*) FROM orders WHERE date=curdate();
执行数据库。
完整架构：
OpenClaw
├── MySQL Tool
├── WebSearch Tool
├── File Tool
└── Shell Tool
▼
本地大模型