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 nodeWindows：去 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.comAPI Key 填错了怎么办？
openclaw config在配置里修改就行。
怎么停止 OpenClaw？
openclaw gateway stop怎么重启？
openclaw gateway restart_（OpenClaw 专题系列 · 持续更新中）_
