养龙虾，本地部署OpenClaw

一、最终架构（先理解）

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

十四、进阶玩法（重点）

OpenClaw真正的强大是 Tools + Agent。

例如：

AI自动写SQL：

复制代码

用户：
查今天订单量

AI：
SELECT count(*) FROM orders WHERE date=curdate();

执行数据库。

完整架构：

复制代码

OpenClaw
   │
   ├── MySQL Tool
   ├── WebSearch Tool
   ├── File Tool
   └── Shell Tool
   │
   ▼
本地大模型