OpenClaw一键安装教程:5分钟本地部署AI模型管理工具(含Node.js环境配置)

OpenClaw 一键安装实测:5分钟跑通本地AI模型管理(新手零踩坑指南)
你试过装 OpenClaw 吗?
——下载、查 Node 版本、手动配 PATH、npm install 报错、端口被占、.env 文件写错一行……最后卡在“localhost:3000 打不开”。
这不是你的问题。是环境配置太容易出错了。
为什么 OpenClaw 对新手不友好?
OpenClaw 是个本地大模型管理工具(类似 Ollama 的图形界面 + 模型调度中心),但它依赖 Node.js、Python 环境、特定端口权限和系统路径配置。Windows 用户常卡在 node not found,Mac 用户遇到 xcode-select --install 缺失,Linux 新手直接复制粘贴 curl | bash 又怕权限风险——90% 的放弃,发生在启动前。
官方一键安装脚本(实测可用)
龙虾官网(yitb.com)提供的 openclaw-installer.sh(macOS/Linux)和 install.ps1(Windows)不是“一键解压”,而是真·智能安装器:
- 自动识别系统类型(Win/macOS/Ubuntu/Debian/CentOS)
- 检查 Node.js:没装就自动下载 LTS 版(v20.13.1),装完立刻验证
node -v && npm -v - 把
openclaw命令写进系统 PATH(Windows 加注册表,macOS 写入~/.zshrc,Linux 写入~/.bashrc) - 启动交互式新手向导(文字引导 + 回车确认,不敲命令也能选模型、设端口、开 Web UI)
它不是“帮你装好”,而是“替你思考完所有分支”。
5 分钟实操(全程复制粘贴)
第一步:下载并运行安装脚本
macOS / Linux 用户(终端执行):
curl -fsSL https://yitb.com/install-openclaw.sh | bash脚本自带 SHA256 校验,且只读取 https://yitb.com/ 域名下的文件,不会联网下载其他内容。Windows 用户(PowerShell 以管理员身份运行):
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser; iwr https://yitb.com/install-openclaw.ps1 | iex必须管理员权限:脚本要往 C:\Program Files\OpenClaw 写文件,并修改系统环境变量。第二步:等待自动完成(约 2–3 分钟)
你会看到类似输出:
[✓] 检测到 macOS Sonoma 14.5
[✓] Node.js v20.13.1 已安装(/usr/local/bin/node)
[✓] OpenClaw v0.8.2 已部署到 ~/.openclaw
[✓] PATH 已更新(重启终端生效)
→ 正在启动新手向导...第三步:跟着向导走(纯键盘操作)
按回车跳过欢迎页 → 输入想用的端口(默认 3000,回车即可)→ 选择本地模型源(推荐 Ollama,回车)→ 输入 qwen2:7b 或 phi-3:mini(支持 Tab 补全)→ 回车启动 Web UI。
向导会自动检测 Ollama 是否运行;没启动就帮你执行 ollama serve,再加载模型到 OpenClaw 管理面板——你只负责选,不负责修。验证:真的跑起来了吗?
打开浏览器访问 http://localhost:3000,你会看到:
- 左侧模型列表(已显示
qwen2:7b在线) - 中间聊天窗口(输入“你好”,模型秒回)
- 右侧资源监控(CPU/内存/显存实时曲线)
✅ 成功标志:不报 ERR_CONNECTION_REFUSED,不弹 Command 'openclaw' not found,不卡在“Loading models…”。
👉 Binance · OKX · Gate.io · HTX · Bitget
常见问题(真实用户反馈)
Q:Mac 执行后提示 command not found: openclaw?
A:脚本已改 ~/.zshrc,但当前终端未重载。关掉终端重开,或运行 source ~/.zshrc 即可。
Q:Windows 安装完打不开网页?
A:检查 Windows Defender 防火墙是否放行 node.exe(向导会提示,但有时被跳过)。手动放行:设置 → 防火墙 → 允许应用通过防火墙 → 勾选 Node.js。
Q:能连 ChatGPT/Claude 吗?
A:OpenClaw 专注本地模型。但 yitb.com 教程已打通链路:装完 OpenClaw 后,《Dify + OpenClaw 调用本地 Qwen》 教你把本地模型当 API 接入 Dify 工作流,再用 Claude 做结果润色——这才是 AI 工具链的真实用法。
下一步建议
你现在有了一个随时可调用的本地模型管理中心。接下来:
- ✅ 《Ollama 本地部署 3 个实用模型(Qwen/Phi-3/Llama3)》 —— 用 OpenClaw 管理它们
- ✅ 《用 Cursor 写第一个 AI Agent:调用 OpenClaw API 自动总结会议录音》 —— 把本地模型变成你的编程助手
- ✅ 《MCP 协议入门:让 Claude 和本地 Qwen 在同一工作流里协作》 —— 真正跨模型协同