04. 5 分钟部署 OpenClaw：保姆级教程

OpenClaw 专题系列 · 第四篇

---

先说前提

这篇面向完全零基础。只要你有一台电脑，能打开终端，5 分钟就能跑起来。

不需要服务器，不需要域名，不需要懂 Linux。

---

一、你需要准备什么

• 一台电脑（Windows / Mac / Linux 都行）
• Node.js 24（推荐）或 Node.js 22（22.14+）
• 一个 AI 模型的 API Key（OpenAI / Claude / Gemini / 阿里百炼都行）

没有 Node.js？一行命令的事：

Mac（装了 Homebrew 的话）：

brew install node

Windows：去 nodejs.org 下载安装包，双击安装就行。

Linux（Ubuntu）：

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

装完验证一下：

node -v

看到版本号就说明装好了。

---

二、一键安装 OpenClaw

打开终端，输入：

npx openclaw@latest

第一次运行会自动触发安装流程，按提示走就行。

如果你想全局使用 openclaw 命令，可以全局安装：

npm install -g openclaw

装完验证：

openclaw --version

---

三、openclaw onboard：向导式配置

安装完成后，运行初始化向导：

openclaw onboard

第一步：选择 AI 模型

向导会列出支持的模型供应商，你选一个然后填入 API Key。

国内用户推荐：阿里百炼（通义千问）

国内访问稳定，价格低，中文理解能力强。

其他常用选项：

• OpenAI（GPT-4o）— 综合能力最强
• Anthropic（Claude）— 长文本和代码能力强
• Google（Gemini）— 免费额度大

API Key 去哪拿？以 OpenAI 为例：

1. 去 platform.openai.com 注册/登录

2. 进入 API Keys 页面

3. 点击 Create new secret key

4. 复制保存（只显示一次，丢了要重新生成）

第二步：选择聊天通道

向导会问你通过什么方式跟 AI 对话。

最简单的选择：WebChat

不需要任何额外配置，安装完就能用。会在本地启动一个网页界面，浏览器打开就能聊天。

第三步：完成

向导跑完后，OpenClaw 的 Gateway 就启动了。

验证一下：

openclaw gateway status

看到 running 就说明一切正常。

---

四、第一次对话

如果你选了 WebChat，打开浏览器访问：

http://localhost:3000

在输入框里随便说句话，比如”你好”。如果 AI 回复你了，说明部署成功。

---

五、确认文件结构

安装完成后，OpenClaw 会在工作目录生成以下文件：

~/.openclaw/
├── workspace/          # 工作区
│   ├── AGENTS.md       # Agent 行为配置
│   ├── SOUL.md         # 人格定义
│   ├── USER.md         # 用户信息
│   └── memory/         # 记忆目录
├── gateway.json        # Gateway 配置
└── skills/             # 已安装技能

这些文件就是你的 AI 的”大脑”。

---

六、常见问题

安装时卡住了怎么办？

网络问题。国内用户如果 npm 安装慢，可以切换淘宝镜像：

npm config set registry https://registry.npmmirror.com

API Key 填错了怎么办？

openclaw config

在配置里修改就行。

怎么停止 OpenClaw？

openclaw gateway stop

怎么重启？

openclaw gateway restart

---

_（OpenClaw 专题系列 · 持续更新中）_