零基础部署 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 -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

三、安装 OpenClaw（推荐方式）

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

macOS / Linux / WSL2

curl -fsSL https://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 路径：

npm prefix -g
echo "$PATH"

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

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

然后重开终端。

2）Node 版本太低

node -v

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

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

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

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

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

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

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

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

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

只要记住这 4 条命令：

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

你就能从 0 到成功跑起来。
在这里插入图片描述
接入飞书后，就可以在任何地点，飞书控制你的电脑小管家了：在这里插入图片描述

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

Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

OpenClaw+GLM-4.7-Flash语音交互：对接Whisper实现语音控制

本文介绍了如何在星图GPU平台上自动化部署【ollama】GLM-4.7-Flash镜像，构建语音交互系统。该系统结合Whisper语音识别与GLM-4.7-Flash的指令理解能力，实现智能家居控制等场景的语音操作，提升日常任务执行效率。

avatar 龙虾开发者社区

学生党福音：OpenClaw+nanobot搭建学习监督助手

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，构建智能学习监督助手。该方案利用轻量级模型实现网课进度跟踪、自动生成练习题和错题整理功能，特别适合学生群体通过QQ机器人实现移动端学习管理，显著提升学习效率。

avatar 龙虾开发者社区

OpenClaw创意工坊：用nanobot镜像生成技术海报文案

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，快速生成技术海报文案。该镜像基于Qwen3-4B模型，能将复杂技术术语转化为通俗表达，适用于技术活动宣传、社交媒体推广等场景，显著提升内容创作效率。

avatar 龙虾开发者社区