夜雨聆风这篇公众号文章覆盖Windows/macOS/Linux全系统，采用一键脚本+手动安装+Docker三种方案，搭配避坑与验证步骤，新手也能轻松上手。
🔥 开源AI助手OpenClaw，一键部署、多平台适配，新手零门槛上手！
一、安装前必备准备
硬件与系统要求
- 系统：Windows 10+/macOS 12+/Linux（Ubuntu/Debian/CentOS）
- 内存：≥4GB，推荐8GB以上
- 环境：Node.js 22+（一键脚本自动安装，无需手动配置）
- 网络：稳定外网，国内用户可配置镜像加速
核心说明
OpenClaw支持一键脚本（推荐）、npm手动安装、Docker容器化三种方式，本文按系统分类，步骤极简、全程无坑！
二、Windows系统安装（2种方案）
方案A：PowerShell一键安装（新手首选）
1. 解锁脚本权限
以管理员身份打开PowerShell，执行：
powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
输入 Y 确认，解锁远程脚本执行权限。
2. 执行一键安装
关闭管理员终端，打开普通PowerShell，粘贴命令：
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
等待自动检测环境、安装Node.js与OpenClaw，出现 OpenClaw installed successfully 即完成。
方案B：WSL2部署（官方推荐，更稳定）
1. 安装WSL2：管理员PowerShell执行 wsl --install ，重启电脑
2. 打开Ubuntu终端，执行macOS/Linux通用一键脚本：
bash
curl -fsSL https://openclaw.ai/install.sh | bash
三、macOS/Linux系统安装（一键直达）
一键脚本安装（全程自动）
1. 打开终端（macOS：启动台→其他→终端；Linux：Ctrl+Alt+T）
2. 粘贴执行官方脚本：
bash
curl -fsSL https://openclaw.ai/install.sh | bash
- macOS需输入开机密码（输入不显示，直接回车）
- Linux需输入sudo密码，自动完成依赖安装与配置
npm手动安装（进阶用户）
1. 安装Node.js 22+，配置npm国内镜像：
bash
npm config set registry https://registry.npmmirror.com
2. 全局安装OpenClaw：
bash
npm i -g openclaw@latest
# 或pnpm（更快）：pnpm add -g openclaw@latest
四、Docker容器化部署（服务器/运维首选）
1. 克隆源码：
bash
git clone https://github.com/openclaw/openclaw && cd openclaw
2. 启动容器：
bash
docker-compose up -d
3. 验证状态： docker compose ps ，显示 Up 即部署成功
五、初始化配置（安装后必做）
安装完成后，执行初始化向导，完成AI模型、端口、权限配置：
bash
# 带守护进程（开机自启）
openclaw onboard --install-daemon
# 纯配置向导
openclaw onboard
配置步骤
1. 设置管理员密码
2. 选择AI模型（云端API/本地模型，新手可跳过）
3. 配置网关端口（默认18789）
4. 连接聊天平台（微信/飞书/钉钉等）
六、验证安装与服务状态
1. 版本验证： openclaw --version ，显示版本号即安装成功
2. 健康检查： curl http://127.0.0.1:18789/api/v1/health ，返回 {"status":"healthy"}
3. 日志查看： openclaw logs -f ，实时排查运行问题
七、常见问题避坑指南
1. Windows脚本执行报错
- 原因：未解锁权限，重新执行方案A第一步
- 解决：关闭杀毒软件，以普通权限运行终端
2. Node.js版本不足
- 一键脚本自动升级，手动安装请卸载旧版，安装v22+
3. 网络超时（国内用户）
- 配置npm镜像： npm config set registry https://registry.npmmirror.com
- 使用国内镜像脚本
bash
# 国内一键脚本
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
4. 权限不足
- macOS/Linux：命令前加 sudo
- Windows：始终以管理员身份运行终端
八、卸载与更新
更新版本
bash
# 全系统通用
openclaw update
# npm手动更新
npm update -g openclaw@latest
卸载程序
bash
npm uninstall -g openclaw
# 清理配置
rm -rf ~/.openclaw
结语
OpenClaw作为开源自托管AI助手，部署简单、功能强大，支持多平台联动与自定义模型接入。按照本文步骤，5分钟即可完成部署，新手也能轻松玩转AI自动化！
如需云端部署、插件配置、多模型对接教程，欢迎留言评论，下期持续更新～
✅ 收藏本文，部署不迷路；转发分享，帮更多小白快速上手OpenClaw！
