5 分钟跑通 OpenClaw 最小可用环境 | 资讯狗

适用版本： OpenClaw latest · Node.js 24（推荐）或 22.14+ 验证日期： 2026-04-12 目标读者： 零基础，第一次接触 OpenClaw 难度： ⭐ 入门 适合首次阅读： 是——本篇是整个系列的起点

目标

跑通 OpenClaw 的最小可用环境：安装、初始化、配一个模型 Key、在终端完成一次对话。

完成后你会拿到一个本地运行的 OpenClaw 实例，后续教程的所有操作都在这个基础上进行。

前置条件

一台 macOS / Linux / Windows 电脑（Windows 用户请看下方说明）
至少一个 AI 模型的 API Key（Claude、Gemini、GPT、Qwen 任选其一）

Windows 用户请先读这一段

OpenClaw 的命令行工具和守护进程（Daemon）目前在 macOS 和 Linux 上体验最完整。Windows 用户有两条路线：

路线	说明	推荐度
WSL2（推荐）	在 Windows 上安装 WSL2，之后所有命令与 Linux 完全一致。本篇及后续教程的命令都可以直接复制执行。	⭐⭐⭐
原生 Windows（PowerShell）	可以安装和运行，但部分路径、环境变量写法和 shell 配置与本教程不同，需要自行对照调整。本系列不会单独给出 PowerShell 版命令。	⭐

如果你是 Windows 用户且没有 WSL2，先跑一条命令装好它：


powershell
wsl --install

装完重启后，在开始菜单打开 Ubuntu，后续所有操作都在这个 Ubuntu 终端里执行。

最短成功路径

整篇就做这 5 件事，预计 5 分钟：

安装 — 用一键脚本或 nvm + npm 装好 OpenClaw
初始化 — openclaw onboard --install-daemon
配 Key — 把一个 API Key 写进环境变量
第一次对话 — openclaw chat "用三句话介绍你能做什么"
验证清单 — 逐条确认环境就绪

下面展开每一步。

一、安装 OpenClaw

两种方式，选一种即可。

方式一：官方一键安装脚本 ✅ 必做（二选一）· 新手推荐

快速体验方案： 一键脚本会安装当前最新版。适合首次体验、快速跑通。长期使用或生产部署时，建议 pin 具体版本号（如 npm install -g [email protected]），避免自动升级引入不兼容变更。版本策略详见第 10 篇《部署运维、性能优化与成本控制》。

适用系统：macOS / Linux / WSL2


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

脚本会自动检测系统环境、安装合适版本的 Node.js 和 OpenClaw，省去手动管理 Node 版本的麻烦。

安装完成后验证：


bash
openclaw --version

方式二：手动安装 ✅ 必做（二选一）· 已有 Node.js 环境

适用系统：macOS / Linux / WSL2

强烈建议用 nvm 管理 Node 版本，避免全局权限问题：


bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 24
nvm use 24

确认版本（Node.js 24 推荐，最低 22.14+）：


bash
node --version

全局安装 OpenClaw：

快速体验方案： @latest 安装当前最新版，适合首次体验。生产环境建议改为 openclaw@具体版本号。


bash
npm install -g openclaw@latest
openclaw --version

注意： 不要用 sudo npm install -g。如果遇到权限问题，说明 Node.js 不是通过 nvm 安装的，回到上面用 nvm 重新来。

二、初始化


bash
openclaw onboard --install-daemon

这条命令完成三件事：

创建配置目录 ~/.openclaw/
生成默认配置文件 openclaw.json
安装并启动守护进程（Daemon）—— OpenClaw 的后台常驻服务，负责接收消息、调度 Agent

三、配置 API Key

推荐通过环境变量管理，不要把 Key 写进配置文件（原因和更安全的方案见第 9 篇《安全最佳实践（重磅章节）》）：


bash
# ⚠️ 请替换：把 sk-ant-xxx 换成你的真实 API Key
echo 'export ANTHROPIC_API_KEY="sk-ant-xxx"' >> ~/.zshrc
source ~/.zshrc

如果你用的是 bash 而不是 zsh，把 ~/.zshrc 换成 ~/.bashrc。

其他提供商的变量名：

提供商	环境变量	最新模型参考
Anthropic (Claude)	`ANTHROPIC_API_KEY`	claude-sonnet-4.6 / claude-opus-4.6
Google (Gemini)	`GEMINI_API_KEY`	gemini-3.1-pro / gemini-3.1-flash
OpenAI (GPT)	`OPENAI_API_KEY`	gpt-5.4 / gpt-5.4-mini
阿里云 (Qwen)	`DASHSCOPE_API_KEY`	qwen3.6-plus / qwen3.5-flash

只配一个就够。多模型配置、自动切换和 Failover 策略属于进阶内容，在第 2 篇《架构核心概念与配置管理（打地基）》中详细展开。

四、验证：第一次对话


bash
openclaw chat "用三句话介绍你能做什么"

如果终端输出了 AI 的回复，环境已经跑通。

也可以打开控制台（Dashboard）在浏览器中操作（📌 可选）：


bash
openclaw dashboard

浏览器会打开 http://127.0.0.1:18789/。

五、验证清单

逐条确认，全部通过才算环境就绪：


bash
# 1. OpenClaw 已安装
openclaw --version

# 2. 配置目录已创建
ls ~/.openclaw/openclaw.json

# 3. 守护进程（Daemon）运行中
openclaw daemon status

# 4. 控制台（Dashboard）可访问（可选）
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:18789/
# 应该输出 200

# 5. AI 对话正常
openclaw chat "ping"

常见问题

Q: 一键脚本报网络错误？

国内网络可能无法直接访问安装源。设置代理后重试，或改用方式二手动安装。

Q: openclaw 命令找不到？

一键脚本装完后需要重新打开终端（或 source ~/.bashrc）。手动安装的话确认 nvm 已正确加载。

Q: 控制台（Dashboard）打不开？

先跑 openclaw daemon status。如果显示未运行，执行 openclaw daemon start。

Q: API Key 配了但对话报错？

检查两件事：Key 复制时没有多余空格；对应提供商的账户余额充足。

Q: WSL2 里 openclaw daemon status 显示正常但浏览器打不开控制台？

按顺序排查：(1) 先试 http://localhost:18789/ 或 http://127.0.0.1:18789/——Windows 通常可以直接通过 localhost 访问 WSL2 内的服务。(2) 如果不通，检查 OpenClaw 是否绑定在 127.0.0.1 而非 0.0.0.0，以及 Windows 防火墙是否拦截了该端口。(3) 仍然不通时，在 WSL2 终端跑 hostname -I 获取 WSL 内网 IP，用 http://<该IP>:18789/ 访问。

下一步

环境跑通了，接下来去第 2 篇《架构核心概念与配置管理（打地基）》理解 OpenClaw 的核心概念和配置体系。

想更进一步？这几篇可以按需跳读：

多人共用实例、Gateway 绑定和访问控制 → 第 9 篇《安全最佳实践（重磅章节）》
Docker 部署、版本 pin、长期运维 → 第 10 篇《部署运维、性能优化与成本控制》