夜雨聆风 本地部署 OpenClaw 主要有两种推荐方式：官方一键脚本部署（适合新手，最快捷）和 Docker 容器化部署（适合追求环境隔离和稳定性的用户）。
在开始之前，请务必了解，
OpenClaw 拥有极高的系统权限，目前仍处于早期发展阶段，存在一定的安全风险。请确保在安全的环境中部署，并妥善保管好你的 API 密钥。
📋 部署前准备
无论选择哪种方式，你都需要提前准备以下两项：
1. Node.js 环境：OpenClaw 的核心依赖，要求版本 ≥ 22。你可以前往 Node.js 官网下载并安装最新稳定版。
2. 大模型 API Key：OpenClaw 需要一个“大脑”来驱动。国内用户推荐使用阿里云百炼或MiniMax等，它们通常提供免费的初始额度，适合入门。你需要在其官网注册并创建一个 API Key。
🚀 方式一：官方一键脚本部署（推荐）
这是最简单、最快速的方法，脚本会自动帮你完成环境检测和依赖安装。
Windows 系统
1. 在开始菜单搜索 PowerShell，右键点击并选择 “以管理员身份运行”。
2. 复制并执行以下命令：
iwr-useb https://openclaw.ai/install.ps1 | iex
3. 耐心等待 5-10 分钟，脚本会自动完成安装。
macOS / Linux 系统
1. 打开系统自带的 终端 (Terminal)。
2. 复制并执行以下命令：
curl-fsSL https://openclaw.ai/install.sh | bash
3. 安装过程中，脚本会引导你进行初始化设置。
安装后配置
安装完成后，终端会启动一个交互式向导，请按提示操作：
1. 选择 QuickStart 快速开始。
2. 在模型选择步骤，选择你的模型服务商（如 Qwen 或 Alibaba Cloud），并根据提示输入你准备好的 API Key。
3. 对于 Channel（通信渠道）、Skills（技能）等配置，初次使用可以先选择 Skip for now 跳过。
4. 启动服务后，在浏览器中访问 http://127.0.0.1:18789 即可打开 OpenClaw 的 Web 控制台。
🐳 方式二：Docker 容器化部署
这种方式将 OpenClaw 运行在一个独立的容器中，不会污染你的主机环境，也便于迁移和管理。
前置要求
你需要先在电脑上安装好 Docker Desktop (Windows/macOS) 或 Docker Engine (Linux)。
部署步骤
1. 打开终端（Windows 下为 PowerShell 或 CMD）。
2. 复制并执行以下命令来拉取镜像并启动容器：
docker run -d --name openclaw -p 18789:18789
-v~/.openclaw:/root/.openclaw openclaw/openclaw:latest-d: 后台运行容器。
✨ --name openclaw: 将容器命名为 "openclaw"。
✨ -p 18789:18789: 将容器的 18789 端口映射到你本机的 18789 端口。
✨-v ~/.openclaw:/root/.openclaw: 将你本地的 ~/.openclaw 目录挂载到容器中，用于持久化保存配置和数据。
3. 启动后，同样在浏览器中访问 http://127.0.0.1:18789 进行后续配置。
⚠️ 常见问题与提示
✨网络问题：如果安装过程中下载缓慢或失败，很可能是网络原因。可以尝试使用国内的镜像源来加速。
✨端口占用：如果启动服务时提示端口 18789 被占用，你需要先关闭占用该端口的程序。
✨权限问题：在 macOS/Linux 上执行脚本时，如果遇到权限错误，请确保脚本具有可执行权限。在 Windows 上，务必使用管理员权限运行 PowerShell。