夜雨聆风本文展示「新手首选一键脚本安装」和「进阶手动源码安装」两种方式，
全程跟着操作即可完成部署，适配 Windows、macOS、Linux 全平台，新手也能轻松上手～
文末有福利
一、前置准备（必须先完成）
1. 必备基础环境
部署前需准备好以下依赖，缺一不可，版本建议严格遵循：
Git：最新版即可，作用是拉取项目源码
Node.js：≥20 LTS 版本，是项目运行的核心环境
模型访问权限（二选一，相当于 OpenClaw 的 AI 大脑）：
2. 新手前置避坑
Windows 用户：后续所有操作，必须以管理员身份打开 PowerShell/终端，否则会出现权限不足报错。
macOS 用户：后续需给终端开启「完全磁盘访问权限」「辅助功能权限」，否则无法操控电脑文件/软件。
网络问题：国内用户建议给 Git、npm 配置国内镜像源，避免拉取源码/依赖超时。
二、新手首选：一键脚本安装（3步搞定，零代码）
这是官方提供的最简安装方式，自动完成环境校验、源码拉取、依赖安装、服务启动，全程只需要复制粘贴命令，不用写一行代码。
1. macOS / Linux 一键安装
打开系统「终端」，直接复制下面的命令，回车执行即可（等待几分钟，全程自动完成）：
curl -fsSL https://install.openclaw.dev | bash2. Windows 一键安装
步骤稍微多一步，重点是「管理员身份」打开终端：
右键开始菜单，选择「Windows PowerShell (管理员)」，打开管理员终端；
若首次执行脚本报错（提示执行策略限制），先执行下面的命令，输入 Y 回车确认，开启脚本权限：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser3. 再复制下面的一键安装命令，回车执行，等待安装完成：
irm https://install.openclaw.dev | iex3. 安装完成提示
脚本执行完毕后，终端会显示「服务启动成功」，默认访问地址为：http://localhost:3000，直接在浏览器打开即可进入 OpenClaw 的管理界面。
三、进阶方案：手动源码安装（适合二次开发/自定义配置）
适合想修改源码、自定义功能的用户，全程可控，步骤清晰，跟着操作也不会出错。
1. 拉取官方源码
打开终端，执行以下命令，拉取 GitHub 官方仓库代码，并进入项目目录：
git clone https://github.com/openclaw/openclaw.gitcd openclaw
2. 安装项目依赖
在项目根目录（cd openclaw 之后的目录），执行下面的命令，安装所有运行所需的依赖包：
npm install3. 核心配置：填写模型参数
这一步是关键，配置正确才能正常调用 AI 模型，步骤如下：
复制项目根目录的 .env.example 文件，重命名为 .env；
用记事本/代码编辑器（如记事本、VS Code）打开 .env 文件，填写你的 AI 模型配置（二选一即可）：
保存并关闭 .env 文件。
4. 构建并启动服务
在项目根目录，依次执行以下两条命令，构建项目并启动服务：
构建项目npm run build启动正式服务npm run start
如果是开发调试，可直接用 npm run dev 命令启动，启动成功后，同样在浏览器打开 http://localhost:3000 即可访问。
四、部署后：首次初始化配置
打开 Web 界面（http://localhost:3000）后，按引导完成 3 步核心配置，即可正常使用 OpenClaw：
模型校验：确认你的 API Key/本地模型能正常调用，测试连通性；
系统权限开启：按提示给 OpenClaw 开启文件读写、终端执行、浏览器控制等权限，这是它能操控电脑的核心；
可选配置：绑定 Telegram、Discord、微信等交互渠道，绑定后可直接通过聊天软件给 OpenClaw 下发任务。
五、常见问题 & 避坑指南
打不开localhost:3000
检查终端是否有报错，确认服务启动成功； 查看 3000 端口是否被其他软件占用，可在.env文件中修改PORT=3001换端口重启。
云端方案：检查 API Key 是否正确、账户是否有余额、网络能否正常访问对应接口；
本地方案：确认 Ollama 已启动，对应模型已提前通过ollama pull命令下载完成。
Windows：必须用管理员身份运行终端 / 服务；
macOS：在「系统设置 - 隐私与安全性」中，给终端 / OpenClaw 开启「完全磁盘访问」「辅助功能」权限。
如何获取资料：
全部资料已经打包完毕 ！【无偿分享 】有需要的读者