养龙虾,本地部署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 系列:

推荐:

复制代码
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
   │
   ▼
本地大模型
相关推荐
锋行天下38 分钟前
langgraph 全栈项目(三)
前端·人工智能·后端
黄啊码1 小时前
【黄啊码】最近面了十几个想转 FDE 的程序员,一个都没招
人工智能
锋行天下1 小时前
langgraph 全栈项目(二)
前端·人工智能·后端
大模型真好玩2 小时前
用 Seedance 2.5 Flash 实现1分钟AI短剧,满足孩子的超级英雄对战梦
人工智能·aigc·deepseek
FengY_HYY2 小时前
从人类组织到人类&大模型组织,我的位置在哪里?
人工智能·程序员·llm
Flynn Liang2 小时前
大模型成本优化:基于 Redis 的可验证语义缓存架构
人工智能·redis·缓存·架构·ai agent·智能体
锋行天下2 小时前
langgraph全栈项目(一)
前端·人工智能·后端
程序员cxuan3 小时前
不得了,Google 造反了,Opus 5.5 又被干了
人工智能·后端·程序员
数字新视界3 小时前
能耗管理系统提升企业能源效率的实践与展望
大数据·人工智能·数据中心·机房管理·模块化机房
郝学胜-神的一滴3 小时前
Effective Python 条款36:优雅拼装迭代器与生成器
开发语言·数据结构·人工智能·python·numpy·scikit-learn