OpenClaw 是基于 Node.js 开发的本地 AI 智能体网关部署核心是先装Node.js ≥ 22再用 npm 全局安装并完成配置向导。以下是完整部署流程一、环境准备必做1. 安装 Node.js 22OpenClaw 要求 Node.js ≥ 22推荐 24.x 版本。Windows官网下载.msi安装勾选Add to PATH。macOSbrew install node22。Linux (Ubuntu)curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejs验证node -v输出 ≥ v22.0.0。2. 安装 Git可选源码部署用# Windows: 官网下载安装# macOS: brew install git# Linux: sudo apt install git二、安装 OpenClaw3 种方式方式1一键脚本推荐自动装依赖# macOS/Linuxcurl-fsSLhttps://openclaw.ai/install.sh|bash# WindowsWSL2 推荐curl-fsSLhttps://openclaw.ai/install.sh|bash脚本自动安装 Node.js、pnpm 与 OpenClaw。方式2npm 全局安装手动# 全局安装npminstall-gopenclawlatest# 或 pnpm更快pnpmadd-gopenclawlatest# 验证openclaw--version方式3Docker 部署容器化# 拉取镜像dockerpull openclaw/openclaw:latest# 启动容器映射端口与配置目录dockerrun-d\--nameopenclaw\-p3000:3000\-v~/.openclaw:/root/.openclaw\openclaw/openclaw:latest访问http://localhost:3000。三、配置与启动核心步骤1. 初始化配置向导openclaw onboard --install-daemon按提示完成选择网关类型本地/远程配置 AI 密钥OpenAI / Anthropic API Key绑定聊天平台WhatsApp / Telegram / Discord 等。2. 启动网关服务# 启动openclaw gateway start# 查看状态openclaw gateway status# 停止openclaw gateway stop3. 访问 Web 控制台浏览器打开http://localhost:3000管理会话、配置与节点。四、常见问题Windows 命令不可用确保 Node.js 已加入 PATH重启终端。安装失败用管理员权限运行终端或切换pnpm安装。端口占用修改.openclaw/config.json中的端口默认 3000。模型密钥错误检查 Anthropic / OpenAI API Key 有效性。五、部署完成网关启动后即可在绑定的聊天平台如 Telegram发送消息AI 会通过 OpenClaw 网关响应并执行本地操作。OpenClaw 官方提供了分平台的一键安装脚本可自动检测并安装 Node.js 22、全局安装 OpenClaw 并启动配置向导。一、官方一键脚本推荐macOS / Linux / WSL2curl-fsSLhttps://openclaw.ai/install.sh|bashWindowsPowerShell管理员权限iwr-useb https://openclaw.ai/install.ps1|iex二、脚本功能与参数自动检测检查 Node.js ≥ 22缺失则自动安装自动安装npm install -g openclawlatest自动引导安装后自动启动openclaw onboard配置向导常用参数静默/跳过引导# macOS/Linux跳过引导仅安装curl-fsSLhttps://openclaw.ai/install.sh|bash-s-- --no-onboard# Windows跳过引导仅安装([scriptblock]::Create((iwr-useb https://openclaw.ai/install.ps1)))-NoOnboard三、国内加速版社区# macOS/Linux 国内镜像加速curl-fsSLhttps://openclaw.cn/scripts/install.sh|bash四、安装后验证openclaw--versionopenclaw onboard --install-daemon# 启动配置向导