OpenClaw 一键安装实操指南：3分钟搞定本地AI Agent开发环境（Windows/macOS/Linux全适配）

卡在哪了

想跑 OpenClaw——调本地大模型（比如 Ollama 的 llama3），自动操作浏览器、读写文件。但第一步就卡住：装不上。
手动装 Node.js、配 PATH、git clone、npm install、改配置……光查报错就两小时。你缺的不是算力，是能直接跑起来的环境。

脚本怎么用

用官方 install.sh（macOS/Linux）或 install.ps1（Windows）。它不叫“一键安装”，而是“智能搭台”：自动识别系统、按需补装 Node.js、写对 PATH、启动交互式新手向导。
实测 Win11 / Intel Mac / Ubuntu 22.04，全程不用输命令，纯回车+确认。

✅ 效果：从双击脚本到看到 Welcome to OpenClaw! 文字界面，平均 2分47秒（含 Node 下载）。装完立刻执行 claw run demo，调本地 qwen2:7b 自动生成周报。

操作步骤

1. 下载并执行官方安装脚本

打开终端（macOS/Linux）或 PowerShell（Windows，右键 → “以管理员身份运行”）：

# macOS / Linux（复制粘贴执行）
curl -fsSL https://raw.githubusercontent.com/OpenClaw/openclaw/main/install.sh | bash

# Windows（PowerShell 中执行，需允许脚本运行）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser; iwr -useb https://raw.githubusercontent.com/OpenClaw/openclaw/main/install.ps1 | iex

为什么必须用这个地址？
脚本托管在 GitHub 主分支，每次更新都同步最新兼容逻辑。比如 v0.8.3 修复了 M1 Mac 的 Node 架构识别。用镜像站或旧 ZIP 包会跳过自动 Node 补装。

2. 脚本自动做的事（你不用管）

• ✅ 检测系统：uname -s（Linux/macOS）或 $PSVersionTable.OS（Windows）
• ✅ 检查 Node.js：node -v 失败则自动下载对应平台二进制包（Win: .msi，Mac: .pkg，Linux: .tar.xz）
• ✅ 写入 PATH：Linux/macOS 追加 ~/.openclaw/bin 到 ~/.bashrc 或 ~/.zshrc；Windows 注入系统级环境变量（避免用户级权限问题）
• ✅ 安装 OpenClaw CLI：npm create openclaw@latest --yes
• ✅ 启动新手向导：openclaw onboarding（纯文字界面，方向键选择，回车确认）

为什么 PATH 必须自动写？
claw 命令需要全局可用。手动配 PATH 容易漏掉 shell 配置文件（比如 zsh 用户改了 .bashrc 却没生效）。脚本会自动判断当前 shell 类型，写入对应配置文件，重启终端即生效。

3. 验证安装

脚本退出后，新开一个终端窗口（Windows 重启 PowerShell），执行：

claw --version
# 输出类似：openclaw v0.8.3

claw list-tools
# 应显示内置工具：browser, file, shell, ollama（说明本地大模型已接入）

再跑个最小验证任务：

claw run "用中文写一段50字的天气预报，今天北京晴，气温22℃"

✅ 正常输出文字，代表 Agent 已激活，且默认连上了你的 Ollama（如果还没装 Ollama，向导会提示一键安装）。

👉 Binance · OKX · Gate.io · HTX · Bitget

常见问题

Q：PowerShell 报错 “无法加载脚本”？
A：Windows 默认禁止执行本地脚本。运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 即可——只影响当前用户，不降低系统安全。

Q：脚本卡在 “Installing Node.js…” 超过5分钟？
A：检查能否访问 https://nodejs.org/dist/。国内用户建议提前开代理；脚本本身已内置淘宝镜像源 fallback 逻辑，但首次检测失败后才会切换。

Q：claw 命令仍提示 “command not found”？
A：关闭所有终端窗口，重新打开——PATH 变更只对新会话生效。macOS 用户若用 zsh，脚本会自动写入 ~/.zshrc，无需手动干预。

下一步

装好只是开始。接下来可以：
→ 用 OpenClaw + Ollama 实现「自动抓取招聘页→提取JD→生成简历匹配度报告」
→ 把 OpenClaw 接入 Dify，做成网页版 AI 助手
→ 修改 claw.yaml 让 Agent 能读取本地 Excel 并画图表

💡 真正省下的不是3分钟，而是反复重装 Node、查 PATH、debug npm 权限的 17次无效尝试。你的时间，该花在调 prompt 和优化 workflow 上。