OpenClaw全平台安装保姆教程,从零到跑起来只要5分钟

OpenClaw（小龙虾）是一个开源的AI智能体框架，能让AI帮你操作浏览器、管理文件、接入微信飞书等通信软件。

很多人卡在安装环节，其实真不难。

这篇文章覆盖Windows、macOS、Linux三大平台，选最简单的方式，手把手带你跑起来。

01 安装前确认

OpenClaw唯一的前置依赖是Node.js 22或更高版本。

先打开终端（Windows用PowerShell，Mac用Terminal），输入：

node -v

如果输出v22.x.x或更高，直接跳到第2步。

如果没装或版本太低，继续往下看。

02 三种安装方式

方式一：一键脚本（最推荐，适合所有人）

macOS / Linux / WSL2：

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

Windows PowerShell（管理员）：

iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动完成所有事：检测系统、安装Node.js（如果没有）、下载OpenClaw、创建配置文件。

全程约3-5分钟，不需要任何手动操作。

💡 国内网络不好的，可以用镜像： 

curl -fsSL https://gitee.com/openclaw/install/raw/main/install.sh | bash

方式二：npm全局安装（已有Node.js环境的用户）

npm install -g openclaw@latest

装完之后运行初始化向导：

openclaw onboard

💡 国内用户先切镜像： npm config set registry https://registry.npmmirror.com

方式三：Windows一键部署包（不想碰命令行的用户）

1. 下载部署包（约50MB）
2. 解压到纯英文路径（如D:\OpenClaw），路径不能有中文、空格、特殊字符
3. 双击OpenClaw Windows一键启动.exe
4. 遇到SmartScreen拦截，点”更多信息”→“仍要运行”
5. 勾选同意协议，点”开始安装”
6. 等3-5分钟自动完成

⚠️ 安装前建议暂时退出360、火绒、Windows Defender等安全软件，防止文件被拦截

03 初始化配置

安装完成后，首次启动会进入配置向导openclaw onboard。

关键配置项：

1. 风险确认 选择”Yes”

2. Onboarding模式 选择”QuickStart”（快速开始）

3. 模型/认证提供商

• 如果已有API Key，选对应的提供商（如DeepSeek、OpenAI、Anthropic等）
• 如果暂时没有，选”Skip for now”，后续再配

4. 通信渠道 按需选择：微信、飞书、Telegram、Discord等，也可以先跳过

04 启动OpenClaw

配置完成后，启动Gateway服务：

openclaw gateway start

看到”Gateway在线”提示，就说明跑起来了。

两种交互方式：

• 图形界面
  
  （推荐新手）：openclaw dashboard
• 终端界面
  
  （极客风格）：openclaw tui

05 常见问题

Q：安装时报npm权限错误 A：Windows用管理员身份运行PowerShell；Mac/Linux在命令前加sudo

Q：Node.js版本不对 A：去 https://nodejs.org 下载最新LTS版本（v24 LTS推荐），卸载旧版后重新安装

Q：国内npm下载慢 A：执行npm config set registry https://registry.npmmirror.com切换国内镜像

Q：Windows路径有中文导致报错 A：必须使用纯英文路径，不要有中文、空格和特殊字符

Q：Gateway启动后显示离线 A：首次启动需要1-3分钟初始化，耐心等待即可

06 版本检查与更新

查看当前版本：

openclaw --version

更新到最新版：

npm install -g openclaw@latest

更新后重启Gateway：

openclaw gateway restart

一句话总结：一键脚本安装 → onboard配置 → gateway start → 开始用。

真的就这三步。