OpenClaw 安装部署与渠道接入指南

一、环境准备与安全考虑
OpenClaw 具备系统级权限(Agent Mode),这意味着它可以执行 Shell 命令、访问文件系统等。因此,强烈建议在以下环境中运行:
- 推荐:Linux 服务器(如 Ubuntu 22.04)或 macOS。
- Windows 用户:强烈建议使用 WSL2(Linux 子系统)。不要直接在原生 Windows 环境中运行,除非你非常了解风险。因为 Windows 的文件系统权限模型较为脆弱,可能导致误删系统文件。
最低硬件要求:
- 内存:8GB(建议 16GB,尤其是使用本地模型时)。
- 磁盘:至少 20GB 可用空间(插件和模型缓存可能占用较多磁盘)。
- CPU:64 位处理器,若运行大型语言模型(LLM)推荐更高频率 CPU。
二、安装方式
OpenClaw 提供了三种主要安装方式,你可以根据自己的需求选择。
2.1 推荐方式:一键安装脚本
这是一键式安装,自动检测系统环境并完成安装。
Windows PowerShell:
# 设置执行权限
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 运行一键脚本
iwr -useb https://openclaw.ai/install.ps1 | iex
macOS / Linux Terminal:
# 直接运行脚本
curl -fsSL https://openclaw.ai/install.sh | bash
此脚本会自动安装 Node.js(≥22)并完成 CLI 配置。
2.2 手动安装
如果你想自定义安装路径或贡献代码,可以手动安装。
# 1. 安装 Node.js (建议使用 nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# 2. 安装 OpenClaw CLI
npm i -g openclaw@latest
# 或者 pnpm add -g openclaw@latest
2.3 Docker 部署
Docker 是最安全的运行方式,因为它将 OpenClaw 完全隔离在容器中。
docker run -d \
-p 18789:18789 \
-e OPENCLAW_ENDPOINT="http://127.0.0.1:18789" \
--restart unless-stopped \
ghcr.io/openclaw/openclaw:latest
Docker 镜像中已预装了 Node.js,省去了系统环境配置的麻烦。


