OpenClaw 安装教程（上）

AI 产品经理笔记 · 特别篇作者：Maty | 发布日期：2026-03-11阅读时间：8 分钟📚 官方文档：https://docs.openclaw.ai^[1]

为什么选择 OpenClaw

OpenClaw 是一个开源的 AI 代理框架，让你能够：

• ✅ 连接 WhatsApp、Telegram、Discord 等聊天平台
• ✅ 创建自定义 AI 技能和工具
• ✅ 自动化日常任务和工作流
• ✅ 部署私有 AI 助手

本教程将带你从零开始，完成 OpenClaw 的安装配置。

📋 系统要求

硬件要求

操作系统要求

macOS

• 最低版本: macOS 12.0 (Monterey)
• 推荐版本: macOS 14.0 (Sonoma) 或更高
• 架构支持: Intel 和 Apple Silicon (M1/M2/M3) 均支持

Windows

• 最低版本: Windows 10 (64 位) 版本 1903
• 推荐版本: Windows 11 (64 位)
• 注意: 不支持 32 位系统

软件依赖

🔧 前置依赖安装

安装 Node.js (v22+)

macOS 安装方法

方法一：官方安装包（推荐新手）

1. 访问 Node.js 官网：https://nodejs.org/^[2]
2. 下载 macOS 安装包（选择 22.x LTS 版本）
3. 双击 .pkg 文件，按向导完成安装
4. 打开终端验证：

   node --versionnpm --version

方法二：Homebrew（推荐开发者）

# 安装 Homebrew（如未安装）/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 安装 Node.js 22brew install node@22# 验证node --versionnpm --version

方法三：NVM（多版本管理）

# 安装 NVMcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash# 重启终端或执行source ~/.zshrc# 安装并使用 Node.js 22nvm install 22nvm use 22nvm alias default 22

Windows 安装方法

方法一：官方安装包（推荐）

1. 访问 Node.js 官网：https://nodejs.org/^[3]
2. 下载 Windows 安装程序（22.x LTS）
3. 双击运行 .msi 安装包
4. 按向导操作：
• 接受许可协议
• 选择默认安装路径
• 勾选"Automatically install the necessary tools"
5. 重启 PowerShell 或命令提示符
6. 验证：

   node --versionnpm --version

方法二：Winget（Windows 包管理器）

# 安装 Node.js 22 LTSwinget install OpenJS.NodeJS.LTS# 验证node --versionnpm --version

方法三：Chocolatey

# 安装 Chocolatey（如未安装）Set-ExecutionPolicy Bypass -ScopeProcess-Forceiex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))# 安装 Node.jschoco install nodejs-lts-y# 验证node --version

预计耗时: 5-10 分钟

🍎 macOS 安装步骤

步骤 1：使用官方安装脚本（推荐）

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

命令解释：

• curl -fsSL：下载安装脚本
• | bash：管道传递给 bash 执行

预计耗时: 2-3 分钟

步骤 2：交互式配置

安装脚本会自动启动配置向导：

openclaw configure

按提示完成：

1. 选择工作区路径（默认：~/.openclaw/workspace）
2. 选择默认模型
3. 配置日志级别

步骤 3：启动 Gateway

# 启动服务openclaw gateway start# 查看状态openclaw gateway status

看到 Gateway is running 表示启动成功。

预计耗时: 1-2 分钟

步骤 4：验证安装

# 检查版本openclaw --version# 查看帮助openclaw --help

🪟 Windows 安装步骤

步骤 1：使用 PowerShell 脚本（推荐）

以管理员身份打开 PowerShell，执行：

Set-ExecutionPolicy-ExecutionPolicy RemoteSigned -Scope CurrentUserInvoke-WebRequest-Uri https://openclaw.ai/install.ps1 -OutFile install.ps1.\install.ps1

命令解释：

• Set-ExecutionPolicy：允许执行脚本
• Invoke-WebRequest：下载安装脚本
• .\install.ps1：执行安装

预计耗时: 3-5 分钟

步骤 2：配置环境变量

安装完成后，添加 OpenClaw 到 PATH：

# 打开环境变量设置[System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\OpenClaw\bin", "User")

重启 PowerShell 使配置生效。

步骤 3：启动 Gateway

# 启动服务openclaw gateway start# 查看状态openclaw gateway status

步骤 4：验证安装

# 检查版本openclaw --version# 查看帮助openclaw --help

⏭️ 下篇点击下个文章

安装完成后，还需要进行配置才能使用：

• 首次配置指南：openclaw.json 详解
• 渠道连接：WhatsApp/Telegram/Discord
• 验证清单：5 步确认安装成功
• FAQ：14 个常见问题解决方案

下篇链接：OpenClaw 配置教程（下）^[4]

遇到问题？

如果安装过程中遇到问题：

1. 检查 Node.js 版本是否为 v22+
2. 确保网络连接稳定
3. 查看日志：openclaw logs
4. 访问官方文档：https://docs.openclaw.ai^[5]

本文不构成技术推荐，安装步骤以官方文档为准。

引用链接