如果你最近刷到 OpenClaw，想自己装一个本地/自托管的 AI 助手，这篇就够了。

别被名字吓到，OpenClaw 官方现在给的安装路径其实已经挺顺了：先安装程序，再跑一遍 onboarding 向导，最后打开控制面板确认服务正常。官方推荐的最省事方式，是直接用安装脚本；它会自动识别系统，必要时顺手处理 Node，再把 OpenClaw 装好并带你走初始化。官方目前建议 Node 24，最低支持 Node 22.14+；macOS、Linux、Windows 都支持，但 Windows 这边官方明确说 WSL2 更稳，优先推荐。

先说清楚：你需要准备什么

装 OpenClaw 之前，最好先准备两样东西：

第一，能正常联网的电脑。第二，一个模型提供商的 API Key，比如 OpenAI、Anthropic、Google 之类。因为 OpenClaw 本身不是模型，它更像一个“AI 助手运行框架”，真正回答问题的模型要你自己接进去。官方 onboarding 也会专门带你选 provider、填 key、配 Gateway。

最推荐的安装方式：官方脚本

macOS / Linux / WSL2

把终端打开，直接跑：

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

这是官方推荐的“最快安装法”。它会检测系统、处理依赖、安装 OpenClaw，并直接进入初始化流程。

Windows（PowerShell）

如果你是 Windows，先说结论：想省心，优先用 WSL2；官方也明确写了 WSL2 是更稳定的路径。要是你先想在原生 PowerShell 里试一下，也可以：

iwr -useb https://openclaw.ai/install.ps1 | iex

原生 Windows 现在能跑基础 CLI 和 Gateway，但完整体验上官方还是更推荐 WSL2。

Windows 用户：为什么我建议你直接上 WSL2

因为官方文档已经把话说得很直接了：Windows 原生支持在变好，但 WSL2 仍然是推荐路线，尤其适合 CLI、Gateway 和各种工具都要稳定工作的场景。

你可以先装好 WSL2 和 Ubuntu，然后在 Ubuntu 里按 Linux 方式安装 OpenClaw。也就是说，进到 WSL 终端之后，还是这条命令：

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

如果你只是想在 Windows 原生里先验证 CLI 能不能起来，也能这么干，但长期用、少踩坑，还是 WSL2 更合适。(OpenClaw)

安装完以后，马上跑初始化

OpenClaw 安装完成后，下一步不是乱改配置，而是直接跑官方的 onboarding。

openclaw onboard --install-daemon

这一步很关键。它会带你配置这些东西：

• 模型提供商和认证方式

• 工作目录

• Gateway

• 可选消息渠道，比如 Telegram、Discord、WhatsApp

• 后台守护进程（daemon），让 Gateway 自动启动

官方把这套流程定义成默认上手方式，而且是跨 macOS、Linux、Windows/WSL2 都通用的主线。

onboarding 过程中，你大概会看到什么

别紧张，基本就是一路选项题。

通常你会做这几件事：

1. 选模型提供商

2. 填 API Key 或走 OAuth / setup token

3. 选默认模型

4. 决定 Gateway 怎么跑

5. 决定要不要顺手装后台服务

6. 选要不要接 Telegram、Discord 这类聊天渠道

官方说明里也写了：对于长期运行的 Gateway，API Key 往往是更稳定、更可预期的方式。

装完以后，先别急着聊天，先验活

先看 CLI 在不在：

openclaw --version

再看配置和依赖有没有明显问题：

openclaw doctor

再看 Gateway 有没有跑起来：

openclaw gateway status

这是官方文档给的基础验证三连。(OpenClaw)

如果一切正常，你应该能看到 Gateway 在默认端口 18789 上监听。(OpenClaw)

打开控制面板，确认你真的装成功了

接下来最直观：

openclaw dashboard

这会帮你打开浏览器里的 Control UI。官方文档里提到，默认本地地址就是：

http://127.0.0.1:18789/

只要这个页面能打开，通常就说明安装、Gateway、前端入口这几件事基本都通了。

这里提醒一句：这个 Control UI 不是普通网页，它是管理界面，能聊天、改配置、审批执行，所以官方明确提醒不要随便公网裸露，优先只在 localhost、Tailscale 或 SSH 隧道下使用。

第一次聊天，最简单的方法

很多人一上来就想接 Telegram 或 WhatsApp，其实没必要。

官方给的最快路径是：先打开 dashboard，直接在浏览器里发第一条消息。这样能最快判断“OpenClaw 到底是不是活着”。等你确认能正常回复，再去接外部渠道。

想接 Telegram、Discord 之类，后面再加

OpenClaw 的 channel 很多，官方 README 里列了 WhatsApp、Telegram、Slack、Discord、iMessage、Matrix、Teams 等一长串。

如果你只是想尽快从手机上聊，官方“Getting Started”里专门提到：最快接起来的一般是 Telegram，只需要 bot token。

比如 Telegram 这类渠道，后面补配置就行，不影响你先把主程序装起来。

如果你不想用安装脚本，也有别的装法

方式 1：你自己管 Node，那就直接 npm 安装

npm install -g openclaw@latest
openclaw onboard --install-daemon

这是官方给的替代方案。

方式 2：用 pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

注意这里官方特别提醒：pnpm 对带构建脚本的包要显式批准，所以第一次装完要跑一次 pnpm approve-builds -g。

方式 3：从源码安装

如果你是开发者，想自己改源码，可以这样：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

这个更适合开发和二次修改，不适合第一次尝鲜。

API Key 放哪儿最稳

如果你只是临时试试，可以在当前 shell 里直接 export：

export OPENAI_API_KEY="你的key"

或者别的 provider：

export ANTHROPIC_API_KEY="你的key"

然后检查认证状态：

openclaw models status

但如果你装了 daemon，让 Gateway 常驻后台跑，官方更推荐把 key 放到：

~/.openclaw/.env

例如：

cat >> ~/.openclaw/.env <<'EOF'
OPENAI_API_KEY=你的key
EOF

这样后台服务重启后也能读到。官方还说明了，OpenClaw 会读取当前进程环境变量、当前目录下的 .env，以及 ~/.openclaw/.env 这个全局兜底文件。

安装成功但命令找不到？大概率是 PATH 问题

这是很常见的坑：明明安装完成了，但终端里输入 openclaw 提示找不到命令。

官方给的排查顺序是：

node -v
npm prefix -g
echo "$PATH"

如果全局 npm 的 bin 目录没进 PATH，就把它加进去。macOS / Linux 常见写法是：

export PATH="$(npm prefix -g)/bin:$PATH"

然后重开一个终端窗口。

Windows 下类似问题也常见。FAQ 里提到，通常要检查 npm 的全局目录是不是已经进了用户 PATH。

还有一组很实用的排错命令

如果你装完还是不对劲，官方 troubleshooting 里建议按这个顺序查：

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

这套命令很适合判断：到底是配置没写好、Gateway 没启动、认证挂了，还是某个 channel 没连上。

想跑本地模型，可以，但别一上来就硬上

OpenClaw 也支持本地模型，不过官方态度其实挺明确：本地当然能跑，但它需要比较大的上下文和更强的防注入能力，小模型、重度量化模型更容易出问题。官方甚至直接说，真想把本地效果拉高，硬件投入要比较重。

如果你只是想“先跑起来”，官方建议最低摩擦的本地方案是从 Ollama 开始，再结合 openclaw onboard 去接。

所以我的建议也很简单：

• 第一次安装：先用云端 provider + API Key 跑通

• 第二阶段：再试 Ollama 或其他本地兼容服务

• 第三阶段：再考虑多模型、fallback、混合配置

这样最省时间。

一个最稳的新手安装流程，我帮你压缩成 5 步

你要是嫌上面字多，直接照这个做：

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

Windows（先推荐 WSL2；原生 PowerShell 也能试）

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

这基本就是官方 Quick Setup 的压缩版：安装、初始化、检查 Gateway、打开 dashboard。

最后提醒一句安全问题

OpenClaw 官方安全文档强调，它更适合“单个可信操作者”的个人助手场景，不适合让一堆互不信任的人共用一个有工具权限的 agent。简单说就是：自己用，或者同一信任边界内用，问题不大；多人混用、还给很高权限，那就该拆分环境。

所以别图省事把它直接扔到公共机器上裸奔，也别把管理界面随便公开到公网。

---

OpenClaw 现在的安装思路其实很清晰：

先装程序，
再跑 openclaw onboard --install-daemon，
然后用 openclaw gateway status 和 openclaw dashboard 验证。

只要这三步通了，后面接 Telegram、Discord、WhatsApp、企业微信、飞书，或者再折腾本地模型，都会顺很多。