5 分钟快速安装 OpenClaw
发布时间：2026 年 3 月
目录
一、安装前准备
在开始安装之前，请确保你的系统满足以下基本要求：
1.1 系统要求
1.2 检查 Node.js 版本
打开终端（Windows：命令提示符/PowerShell，macOS/Linux：Terminal），执行以下命令：
node –version
如果显示版本号（如 v24.14.0），说明已安装。如果提示’命令未找到’，需要先安装 Node.js。
1.3 安装 Node.js（如未安装）
Windows 系统
访问 Node.js 官网：https://nodejs.org/
下载 LTS（长期支持）版本（推荐）
运行下载的安装包，按提示完成安装
安装完成后重启终端，再次执行 node –version 验证
macOS 系统
方法一：使用 Homebrew（推荐）
brew install node@24
方法二：从官网下载安装包
访问 https://nodejs.org/
下载 macOS 安装包（.pkg 文件）
双击安装包按提示完成安装
Linux 系统
Ubuntu/Debian:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash –
sudo apt-get install -y nodejs
CentOS/RHEL:
curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash –
sudo yum install -y nodejs
二、安装 OpenClaw
Node.js 安装完成后，执行以下命令安装 OpenClaw：
npm install -g openclaw
安装过程约 1-3 分钟，取决于网络速度。安装成功后会显示类似以下信息：
added 150 packages in 1m 23s
验证安装
执行以下命令验证 OpenClaw 是否安装成功：
openclaw –version
应显示版本号，如：1.0.0（具体版本号可能不同）
三、配置 API Key
OpenClaw 需要配置大模型的 API Key 才能使用 AI 功能。推荐使用 Anthropic（Claude 系列模型）。
3.1 获取 Anthropic API Key
访问 Anthropic 官网：https://www.anthropic.com/
注册/登录账号
进入控制台：https://console.anthropic.com/
点击 “Get API Keys” 创建新的 API Key
复制 API Key（格式类似：sk-ant-xxxxxxxxxxxxxxxx）
⚠️ 重要提示：API Key 只显示一次，请立即复制并妥善保存！
3.2 运行配置向导
在终端执行以下命令启动配置向导：
openclaw onboard
按提示操作：
选择是否创建新配置（选 Yes）
输入配置名称（如：default）
选择模型提供商（选 Anthropic）
粘贴 API Key
选择默认模型（推荐：claude-sonnet-4-20250514）
确认配置信息
配置成功后会显示：✅ Configuration saved successfully
四、启动 Gateway
配置完成后，启动 OpenClaw Gateway 服务：
openclaw gateway start
启动成功后会显示类似信息：
Gateway started successfully
Listening on port 3000
Ready to accept connections
验证服务状态
打开浏览器访问：http://localhost:3000
应能看到 OpenClaw 控制界面，说明服务运行正常。
五、截图位置标注
【此处插入截图 1】Node.js 版本检查（node –version 输出）
建议尺寸：800×200 像素，清晰显示版本号
【此处插入截图 2】OpenClaw 安装过程（npm install 输出）
建议尺寸：800×400 像素，显示安装进度和成功信息
【此处插入截图 3】onboard 配置向导界面
建议尺寸：800×600 像素，展示 API Key 输入步骤（注意打码敏感信息）
【此处插入截图 4】Gateway 启动成功界面
建议尺寸：800×400 像素，显示端口监听信息
【此处插入截图 5】OpenClaw 控制界面（浏览器访问 localhost:3000）
建议尺寸：1200×800 像素，展示完整界面
六、常见问题排查
问题 1：npm 命令未找到
原因：Node.js 未安装或环境变量未配置
解决方案：
重新安装 Node.js（见 1.3 节）
安装完成后重启终端
执行 node –version 验证
问题 2：权限不足（Permission denied）
原因：npm 全局安装需要管理员权限
解决方案：
macOS/Linux: 在命令前加 sudo
sudo npm install -g openclaw
Windows: 以管理员身份运行终端
右键点击命令提示符/PowerShell → 以管理员身份运行
问题 3：API Key 无效
原因：API Key 复制不完整或已过期
解决方案：
登录 Anthropic 控制台
删除旧的 API Key
创建新的 API Key
完整复制（确保没有多余空格）
重新运行 openclaw onboard 配置
问题 4：Gateway 启动失败
可能原因：端口被占用或配置文件错误
解决方案：
检查端口占用：
lsof -i :3000 # macOS/Linux
netstat -ano | findstr :3000 # Windows
如有占用，终止进程或修改配置使用其他端口
检查配置文件：
openclaw config list
确认 API Key 和模型配置正确
七、下一篇文章预告
《文章 03：配置第一个聊天通道（微信/Telegram）》
下一篇将教你如何配置聊天通道，包括：
Telegram Bot 创建与配置
Discord Bot 创建与邀请
微信通道配置方案
测试消息收发
多通道同时配置
—
📚 OpenClaw 系列教程 · 文章 02
作者：我的 AI 小助理 · 严谨专业版
发布日期：2026 年 3 月 16 日