零基础部署 OpenClaw：从 0 到跑起来（新手可直接照做）

零基础部署 OpenClaw：从 0 到跑起来（新手可直接照做）

如果你第一次接触 OpenClaw，这篇文章的目标很简单：
让你在 10~20 分钟内，把 OpenClaw 成功部署到本机并开始聊天。

我会按「最稳妥、最少踩坑」的方式写，命令都给你准备好，复制即可。

一、你将得到什么

完成后你会有：

• 一个正在运行的 OpenClaw Gateway
• 一个可访问的控制台页面（Control UI）
• 能够在浏览器里直接和 OpenClaw 对话

二、准备条件（先看这个）

• 系统：macOS / Linux / Windows（Windows 建议 WSL2）
• Node.js：22 或更高版本
• 网络可访问openclaw.ai

先检查 Node：

node-v

如果输出是v22.x.x或更高，直接进入下一步。
如果没有 Node，先安装（Ubuntu 示例）：

curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejs

三、安装 OpenClaw（推荐方式）

官方推荐安装脚本，一步完成安装和引导：

macOS / Linux / WSL2

curl-fsSLhttps://openclaw.ai/install.sh|bash

Windows PowerShell

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

四、运行初始化向导（关键一步）

安装后执行：

openclaw onboard --install-daemon

这一步会做配置初始化（包括网关服务相关设置）。
新手不要跳过。

五、检查服务是否正常

openclaw gateway status

如果状态正常，继续打开控制台：

openclaw dashboard

浏览器会打开控制台页面。你也可以直接访问：

http://127.0.0.1:18789/

看到页面就代表部署成功了。

六、常用运维命令（建议收藏）

openclaw gateway status openclaw gateway start openclaw gateway stop openclaw gateway restart openclaw doctor

• doctor：检查环境问题（非常实用）
• restart：多数“突然不可用”问题都能先靠它排查

七、最常见的 3 个坑（附解决方法）

1）openclaw: command not found

先看全局 npm 路径：

npmprefix-gecho"$PATH"

如果$(npm prefix -g)/bin不在 PATH，追加到 shell 配置（如~/.bashrc/~/.zshrc）：

exportPATH="$(npmprefix-g)/bin:$PATH"

然后重开终端。

2）Node 版本太低

node-v

必须是 22+。低版本请升级。

3）Linux 全局安装权限报错（EACCES）

改用用户目录作为 npm 全局路径：

mkdir-p"$HOME/.npm-global"npmconfigsetprefix"$HOME/.npm-global"exportPATH="$HOME/.npm-global/bin:$PATH"

并把export PATH=...写入~/.bashrc或~/.zshrc。

八、如果你要部署到 VPS（先知道这条）

新手强烈建议先本地跑通，再上 VPS。
上云时请遵守这条安全原则：

• 默认只监听本机回环（不要裸露公网）
• 远程访问优先用 SSH 隧道或 Tailscale
• 若暴露到局域网/远程网络，务必配置gateway.auth.token或gateway.auth.password

九、给新手的最短成功路径（复盘版）

只要记住这 4 条命令：

curl-fsSLhttps://openclaw.ai/install.sh|bashopenclaw onboard --install-daemon openclaw gateway status openclaw dashboard

你就能从 0 到成功跑起来。

接入飞书后，就可以在任何地点，飞书控制你的电脑小管家了：

当然，一切的一切，你都可以照着官方教程进行操作：https://docs.openclaw.ai/zh-CN/start/getting-started