OpenClaw龙虾本地一键部署方案,打造你的私有化AI助理.

掌控你的AI助手，让数据牢牢锁在自己的硬盘里？本地部署OpenClaw，是开发者和隐私控用户的不二之选。

手把手带你完成一次“所有权完整”的安装之旅。

本地安装

如果你是一位开发者，或者对数据主权有极致要求，那么本地安装模式就是为你量身打造的。

OpenClaw本身是一个基于TypeScript构建的项目，运行在Node.js环境之上，让你能获得从底层代码到上层数据的完全控制权。

系统要求

工欲善其事，必先利其器。

在开始之前，请确保你的系统满足以下要求，这是成功安装的第一步。

要求	详情
Node.js	>= 22（强制要求，版本过低无法运行）
包管理器	npm、pnpm、bun 均可，任选其一
macOS	需要预装 Xcode Command Line Tools
Linux	需安装标准构建工具（如 gcc, make）
Windows	官方强烈推荐使用 WSL2

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

这是最推荐、最快捷的安装方式，两条命令就能搞定一切。

1. 安装

OpenClawnpm install -g openclaw@latest#

2. 初始化并安装守护进程

openclaw onboard -install-daemon

重点说一下第二条命令：

openclaw onboard

是一个交互式初始化向导，它会亲切地引导你完成选择AI模型、配置API密钥、设置消息接收频道等一系列初始配置。

而加上 -install-daemon参数后，它会同时为你安装并启动守护进程，确保OpenClaw在后台7x24小时持续待命。

方式二：一键脚本安装

如果你连Node.js都还没安装，或者不想操心环境问题，那么官方贴心准备的一键安装脚本就是你的“懒人福音”。

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

只需执行这一条命令，脚本就会自动为你检测系统环境。

如果发现缺少Node.js，它会自动帮你安装，然后一气呵成地完成OpenClaw的部署，真正做到开箱即用。

macOS 额外准备

macOS用户请注意，在开始上述安装前，请务必在终端中执行以下命令，确保已安装Xcode命令行工具：

xcode-select -install

另外有个“苹果独享”的福利：如果你希望使用 iMessage消息同步 或 Apple Notes（备忘录）集成 这些炫酷技能，

它们依赖于macOS原生的AppleScript能力，因此仅在macOS系统上才能完美运行。

Windows 用户注意

重要提示！

OpenClaw官方强烈不建议在Windows原生环境（如PowerShell或CMD）中直接安装。

你可能会遇到各种路径、权限等兼容性“玄学”问题。

正确姿势是使用 WSL2（Windows Subsystem for Linux）。

你只需要先安装好WSL2（比如选择一个Ubuntu发行版），然后在打开的Ubuntu终端里，按照上面提到的Linux安装流程操作即可，一切都会变得非常顺畅。

守护进程

Daemon

守护进程（Daemon）是让OpenClaw化身“隐形管家”的关键。

安装后，它会以后台服务的形式持续运行，即使你关掉了终端窗口，它也不会中断工作。

不同操作系统使用不同的原生服务管理工具，稳定性有保障：

系统	进程管理	说明
macOS	launchd	macOS原生服务管理器，支持开机自启
Linux	systemd	Linux标准服务管理器，可使用 systemctl命令控制

守护进程安装完成后，OpenClaw的核心网关（Gateway）

就会在 ws://127.0.0.1:18789 这个地址上持续监听，等待你的连接与调遣。