一、最终架构（先理解）

完整系统其实是 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

 

十二、常见问题（100%会遇到）

 

问题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
   │
   ▼
本地大模型