最近在折腾个人 AI 助手时，我接触到了 OpenClaw。它的定位很明确：把一个长期在线、可在多个渠道里响应的个人 AI assistant 跑在你自己的设备上。
这篇文章记录一下我整理后的安装流程，尽量按“第一次接触也能跑起来”的思路来写。
OpenClaw 是什么
根据官方仓库的描述，OpenClaw 是一个运行在你自己设备上的个人 AI assistant。它可以接入多个聊天渠道，也提供本地控制界面，适合作为个人自动化助手或长期运行的 AI 工作流入口。
如果你只是想先快速体验，不一定要一开始就接第三方消息渠道。先把本地 Gateway 和 Dashboard 跑起来，是更稳妥的第一步。
安装前先确认要求
官方文档当前给出的基础要求是：
- Node.js 22 或更高版本
- macOS、Linux，或者 Windows
- 如果你要从源码构建，再额外准备
pnpm
需要特别注意的是，官方对 Windows 的建议很明确：优先通过 WSL2 安装和运行。如果你是 Windows 用户，我也建议直接走 WSL2，不要一开始就折腾原生环境。
官方推荐安装方式
官方目前最推荐的是安装脚本方式。它会处理 Node 检测、安装 OpenClaw CLI，并直接进入初始化向导。
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
如果安装脚本顺利执行完，一般就已经把 CLI 准备好了。
初始化 OpenClaw
安装完成后，继续运行官方推荐的 onboarding 向导：
openclaw onboard --install-daemon
这一步会帮助你完成几件重要的事情：
- 配置认证信息
- 设置 Gateway
- 选择是否接入聊天渠道
- 安装后台服务，让它持续运行
如果你只是想先体验本地控制台，也可以先完成最基础配置，后续再慢慢加渠道。
如何确认是否安装成功
完成初始化后，可以按这个顺序检查。
1. 检查 Gateway 状态
openclaw gateway status
如果状态正常，说明后台服务大概率已经起来了。
2. 打开控制界面
openclaw dashboard
官方文档里提到，最快的首次体验方式就是打开 Dashboard，或者直接访问：
http://127.0.0.1:18789/
如果你能看到控制界面，说明这一轮安装基本成功。
3. 前台运行用于排错
如果你怀疑后台服务没有正常启动，也可以直接前台跑一次：
openclaw gateway --port 18789
这样日志会直接输出在终端里，排错会更直接。
Windows 用户建议：走 WSL2
如果你在 Windows 上安装，官方建议通过 WSL2 运行 OpenClaw。我也建议这样做，原因很简单：
- 工具链更统一
- Node、pnpm、Linux 命令兼容性更好
- 后续如果你要接更多工具和自动化能力，WSL2 更省心
安装 WSL2
在 PowerShell 管理员模式下执行：
wsl --install
如果你想手动指定发行版，也可以先查看可用列表：
wsl --list --online
然后安装 Ubuntu：
wsl --install -d Ubuntu-24.04
给 WSL2 开启 systemd
OpenClaw 的 Gateway 服务安装会用到 systemd。在 WSL 的 Ubuntu 终端里执行：
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
然后回到 PowerShell：
wsl --shutdown
重新打开 Ubuntu 之后检查：
systemctl --user status
如果这里正常，再继续在 WSL 里执行 OpenClaw 的安装脚本即可。
如果不想用安装脚本
官方仓库也给了另一种方式：先全局安装 CLI，再执行向导。
npm install -g openclaw@latest
openclaw onboard --install-daemon
如果你平时更习惯自己控制安装过程，这种方式会更直观。
从源码安装适合什么场景
如果你是想：
- 看源码
- 跟进开发分支
- 自己改功能
- 本地参与调试
那就可以考虑从源码安装。官方仓库当前给出的基本流程是：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon
对普通用户来说，第一次安装并不建议直接走这条路，因为环境变量、依赖和构建步骤都会更多。
常见建议
1. 先跑通本地 Dashboard，再接消息渠道
这样可以把问题拆开。先确认 OpenClaw 本体正常，再去配置 Telegram、Slack 或其他平台。
2. Windows 不要一开始就死磕原生环境
官方已经明确更推荐 WSL2，这通常意味着 WSL2 是更稳定、更少踩坑的路径。
3. 遇到异常时优先看 Gateway 和 Doctor
除了前台运行 Gateway 观察日志，官方也建议在升级或排错时运行：
openclaw doctor
这个命令对排查配置问题会比较有帮助。
小结
如果只看最短路径，当前安装 OpenClaw 的推荐流程其实很简单：
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
我自己的建议是：
- macOS / Linux 直接走官方脚本
- Windows 直接走 WSL2
- 第一次先把本地控制台跑起来
- 后面再逐步接消息渠道和高级能力
如果之后我自己把它真正接进日常工作流里，我会再补一篇记录 OpenClaw 初始化配置和实际使用体验。