OpenClaw 安装配置与多平台接入实战

环境准备与安全考量
OpenClaw 具备系统级权限(Agent Mode),这意味着它可以执行 Shell 命令、访问文件系统等。因此,强烈建议在以下环境中运行:
- 推荐:Linux 服务器(如 Ubuntu 22.04)或 macOS。
- Windows 用户:强烈建议使用 WSL2(Linux 子系统),不要直接在原生 Windows 环境中运行(除非你非常了解风险),因为 Windows 的文件系统权限模型较为脆弱,可能导致误删系统文件。
最低硬件要求:
- 内存:8GB(建议 16GB,尤其是使用本地模型时)。
- 磁盘:至少 20GB 可用空间(插件和模型缓存可能占用较多磁盘)。
- CPU:64 位处理器,若运行大型语言模型(LLM)推荐更高频率 CPU。
安装方式
OpenClaw 提供了多种安装方式,你可以根据自己的需求选择。
一键安装脚本(适合 Windows/macOS/Linux)
这是一键式安装,自动检测系统环境并完成安装。
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 配置。
手动安装(适合高级用户或开发者)
如果你想自定义安装路径或贡献代码,可以手动安装。
# 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
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


