Part 3: 部署方案

本地安装

Local Installation

本地安装适合开发者和想完全掌控数据的用户。OpenClaw 是 TypeScript 项目，运行在 Node.js 上。

系统要求 System Requirements

要求	详情
Node.js	>= 22（强制要求）
包管理器	npm / pnpm / bun 均可
macOS	需要 Xcode Command Line Tools
Linux	标准构建工具（gcc, make）
Windows	强烈推荐 WSL2

方式一：npm 全局安装（推荐） npm Global Install

最推荐的安装方式，两条命令搞定：

# 安装 OpenClaw
npm install -g openclaw@latest

# 初始化并安装守护进程
openclaw onboard --install-daemon

onboard 命令会引导你完成初始配置，包括选择模型、配置 API Key、设置消息频道等。--install-daemon 参数会同时安装守护进程，让 OpenClaw 在后台持续运行。

方式二：一键脚本安装 curl Install

如果你不想手动安装 Node.js，可以使用官方提供的一键安装脚本：

curl -sSL https://get.openclaw.ai | bash

脚本会自动检测系统环境、安装 Node.js（如缺失）并完成 OpenClaw 安装。

macOS 额外准备 macOS Setup

macOS 用户在安装前需要确保已安装 Xcode Command Line Tools：

xcode-select --install

如果你需要使用 iMessage 频道或 Apple Notes 技能，这些依赖 macOS 原生的 AppleScript 能力，只有在 macOS 上才能运行。

Windows 用户注意 Windows via WSL2

注意

OpenClaw 官方强烈推荐 Windows 用户通过 WSL2（Windows Subsystem for Linux）运行。直接在 Windows 原生环境下运行可能遇到路径、权限等兼容性问题。

安装 WSL2 后，在 Ubuntu 终端内按 Linux 流程安装即可。

守护进程 Daemon

守护进程让 OpenClaw 在后台持续运行，即使关闭终端也不会中断。不同系统使用不同的进程管理方式：

系统	进程管理	说明
macOS	launchd	macOS 原生服务管理，开机自启
Linux	systemd	Linux 标准服务管理，systemctl 控制

安装守护进程后，OpenClaw Gateway 会在 ws://127.0.0.1:18789 持续监听。