OpenClaw一键安装教程：三平台5分钟部署本地AI工具链（含Node.js/Python环境自动配置）
OpenClaw 一键安装实操指南：三平台5分钟跑通本地AI工具链
你想本地跑大模型、调用API、搭工作流，但卡在环境安装上：Node.js 版本冲突、Python 依赖报错、端口被占、npm install 卡死……这不是你配置不对，是传统流程太折腾。
OpenClaw 官方安装脚本（curl -fsSL https://openclaw.dev/install.sh | sh）不是“简化版”，而是工程层面的开箱即用设计：它清楚你的系统，缺什么补什么，装完直接带你进正题。
✅ 三步完成：零配置、无报错、5分钟内可用
步骤1：运行官方一键安装脚本
所有平台一条命令起步（复制粘贴即可）：
# macOS / Linux（终端中执行）
curl -fsSL https://openclaw.dev/install.sh | sh
# Windows（PowerShell 以管理员身份运行）
iwr -useb https://openclaw.dev/install.ps1 | iex这条命令为什么安全？ curl -fsSL 中 -f 确保失败时返回非零退出码，-s 抑制进度条但保留错误输出，-L 支持重定向。脚本托管在 openclaw.dev，HTTPS 加密传输，源码托管在 GitHub Pages，完全公开可查：github.com/openclaw/install。
步骤2：等待自动执行（约2–4分钟）
脚本按顺序做四件事：
- 识别系统：用
uname -s（Linux/macOS）或Get-ComputerInfo（Windows）判断平台和版本； - 按需安装 Node.js：若缺失 Node 或版本低于 18.17，直接下载对应平台二进制包（不走
nvm，不修改全局 PATH，避免污染）； - 安装 CLI 与后端服务：执行
npm create openclaw@latest初始化项目，再npm run dev启动服务，默认监听http://localhost:3000； - 启动交互式新手向导：浏览器自动打开，引导你选模型源（Ollama / 本地 API / 免费 Claude 代理）、设首个 Agent 角色、发第一条指令。
💡 实测：MacBook M1 Pro（Ventura）、Windows 11（22H2）、Ubuntu 22.04 LTS 全部一次通过。Windows 用户会弹出提示：“是否安装 Hub 托盘应用？”——点“是”，任务栏出现龙虾图标，右键就能重启服务、看日志、切模型，不用再切终端。
步骤3：验证是否成功
打开浏览器访问 http://localhost:3000，你会看到：
- ✅ 左上角显示当前连接的模型（如
ollama:llama3:8b或claude-3-haiku） - ✅ 输入框下方有“Hello, I’m your local AI agent”欢迎语
- ✅ 发送“今天北京天气如何？”——如果已连 Ollama，秒回结构化摘要（无需手写 Prompt 模板）
为什么能立刻响应？
OpenClaw 默认启用轻量缓存与预热机制：安装时已下载基础适配器（Adapter），把原始大模型输出自动转成标准 Tool Calling 格式，省掉你手动写 JSON Schema 的步骤。
👉 Binance · OKX · Gate.io · HTX · Bitget
❗常见问题 & 真实解法
Q：Windows PowerShell 报 “execution policy” 错误？
A：这是系统默认禁止远程脚本执行。只需在 PowerShell 中先运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser然后重试安装命令。这个策略只对当前用户生效，且仅允许已签名脚本（我们的 .ps1 由 GitHub Actions 自动签名）。
Q：浏览器打不开 localhost:3000？
A：90% 是端口被占。脚本会自动检测 3000 是否空闲，不可用就顺延到 3001 → 3002……终端最后一行会明确告诉你：“✅ OpenClaw running on http://localhost:300X”。复制那个地址就行。
Q：Hub 托盘图标不显示？
A：Windows Defender 可能拦截首次启动。右键任务栏 → “任务管理器” → “启动”标签页 → 找到 OpenClaw Hub → 右键启用。之后开机自启就正常了。
下一步建议
你现在已有可交互的本地 AI Agent 基础环境。接下来：
- 🌟 马上试：用
openclaw model list查看已接入模型，openclaw agent create --name weather --tool weather-api快速生成一个查天气 Agent； - 📚 深入学：《Ollama + OpenClaw 搭建离线知识库》 教你把 PDF 喂给本地 LLM；
- ⚙️ 进阶玩：《用 MCP 协议让 OpenClaw 控制你的 Chrome 和 Notion》 实现真正的 AI 自动化办公。
安装不是终点，跑起来才是开始。你刚花的 5 分钟，换来一个随时待命、不联网、不收费、能自己长大的 AI 工作台——现在，它听你的。