OpenClaw实战指南01：安装踩坑完全指南

作者：数据饕餮
OpenClaw 安装指南

选择你的系统和安装方式，获取 OpenClaw 完整的分步安装说明
一、选择你的操作系统

1. macOS
Apple macOS 12+
2. Windows【已经实测-不推荐】
Windows 10/11 + WSL2
3. Linux 【实测-推荐】
Ubuntu22.04【推荐】、Debian、Fedora 等
二、选择安装方式

2.1 命令行标准

通过 npm 标准安装
安装 Node.js 22+ 【实测-已踩坑：注意版本必须22+】

（1）使用 nvm 或包管理器：
通过 nvm 安装（推荐）【实测-已踩坑-会有npm权限问题】

1. $ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
2. $ source ~/.bashrc
3. $ nvm install 22

复制代码

2.2 安装 OpenClaw

选择以下方式安装 OpenClaw
一键安装（推荐）

1. curl -fsSL https://openclaw.ai/install.sh | bash

复制代码

或通过 npm 安装【实测-没问题】

1. npm install -g openclaw@latest

复制代码

2.3 运行配置向导【已踩坑-不建议自动启动】

向导将设置网关、认证和聊天平台
openclaw onboard  --install-daemon【小心】

2.4 启动网关

如果在向导中安装了服务，网关应该已经运行
检查网关状态
$ openclaw gateway status
手动运行（前台）
$ openclaw gateway --port 18789 --verbose
访问仪表盘（本地回环）
http://127.0.0.1:18789/
2.5 启用 systemd 服务

将网关作为后台服务启动
$ systemctl --user enable --now openclaw-gateway.service
2.6 验证安装

快速验证服务是否正常运行
$ openclaw status
$ openclaw health
$ openclaw security audit --deep
2.7 重要指令【已实测】

openclaw doctor 修复模式，万物皆可修
不推荐使用 Bun，WhatsApp 和 Telegram 渠道存在已知问题。
OpenClaw 安装完成！

OpenClaw 已安装完成，可以开始使用了。

原文地址：https://blog.csdn.net/zhangziliang09/article/details/158388554