介绍如何在本地环境部署 OpenClaw AI Agent 框架。步骤包括配置 Node.js 22+ 和 pnpm，安装 OpenClaw 与 Ollama，下载 Qwen 模型，配置 API 连接，启动网关并测试聊天功能。同时涵盖常见问题排查及进阶工具使用建议，适合希望私有化运行大模型代理的开发人员参考。
完整系统其实是 3 层：
OpenClaw (AI Agent)
│
└── OpenAI Compatible API
│
└── Ollama (本地模型服务)
│
└── Qwen2.5 / Qwen3 / Llama3
关键点：
OpenClaw 不会直接加载模型，必须通过 API。
OpenClaw 要求 Node ≥ 22。
检查：
node -v
应该是：
v22.x.x
如果不是：
nvm install 22
nvm use 22
OpenClaw 推荐：
npm install -g pnpm
检查：
pnpm -v
安装：
pnpm add -g openclaw
或者
npm install -g openclaw
验证：
openclaw --version
如果输出版本说明安装成功。
运行：
openclaw onboard
你会看到类似界面：
I understand this is personal-by-default...
选择：
Yes
选择：
QuickStart
原因：
选择：
Local gateway
默认：
ws://127.0.0.1:18789
这是 OpenClaw Agent 端口。
选择：
Loopback (127.0.0.1)
原因：
安装 Ollama：
curl -fsSL https://ollama.ai/install.sh | bash
验证：
ollama -v
推荐先下载小模型测试。
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 serve
默认 API：
http://127.0.0.1:11434
测试：
curl http://127.0.0.1:11434
如果返回：
Ollama is running
说明正常。
打开配置文件：
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 start
如果成功会显示：
Gateway started ws://127.0.0.1:18789
方式 1：
openclaw chat
输入：
解释一下 Redis
如果返回回答说明成功。
方式 2：
浏览器访问：
http://127.0.0.1:18789
错误：
Node version too low
解决：
nvm install 22
nvm use 22
原因：PATH 没有更新。
解决：
npm config get prefix
加入 PATH。
或者重新安装：
npm install -g openclaw
检查端口：
lsof -i :18789
杀掉进程：
kill -9 PID
重新启动：
openclaw gateway start
检查：
curl http://127.0.0.1:11434
如果失败：
重新启动：
ollama serve
检查：
ollama list
没有模型：
ollama pull qwen2.5:7b
本地模型推理慢。
解决：
换小模型：
qwen2.5:3b
如果是 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
▼
本地大模型
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online