OpenClaw 安装教程:Windows 和 macOS 完整指南

OpenClaw 是一款开源的 AI 网关工具，能将你的聊天应用（微信、Telegram、Discord、Slack 等）连接到 AI 编程助手。它运行在你自己的设备上，数据完全自控。本文详细介绍 Windows 和 macOS 的安装过程。

一、系统要求

二、安装 Node.js

OpenClaw 基于 Node.js 运行，无论 Windows 还是 macOS，都需要先安装 Node.js。

Windows 安装 Node.js

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

2. 访问 Node.js 官网 https://nodejs.org
4. 下载「LTS」（长期支持版）Windows 安装包（.msi）
6. 双击运行安装包，一路点 Next，保持默认设置即可
8. 安装完成后打开命令行（Win+R → 输入 cmd → 回车）
10. 输入以下命令验证安装：

node --version npm --version

如果显示版本号（如 v24.1.0、10.x.x），说明安装成功。

方法二：nvm-windows（推荐开发者使用）

2. 访问 nvm-windows 下载安装包
4. 安装后打开 PowerShell（管理员），运行：

nvm install 24 nvm use 24

macOS 安装 Node.js

方法一：Homebrew（推荐）

如果你已经安装了 Homebrew：

# 安装 Node.js brew install node  # 验证安装 node --version npm --version

方法二：官方安装包

2. 访问 https://nodejs.org
4. 下载 macOS 安装包（.pkg）
6. 双击安装，按提示完成

方法三：nvm（推荐前端/Node 开发者使用）

# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash  # 重新打开终端后，安装 Node 24 nvm install 24 nvm use 24

三、安装 OpenClaw

Windows 安装

方法一：npm 全局安装（推荐）

以管理员身份打开 PowerShell 或 cmd，运行：

npm install -g openclaw

安装完成后验证：

openclaw --version

方法二：使用 npx（无需安装，直接运行）

npx openclaw start

提示：如果 Windows 提示「执行策略不允许运行脚本」，以管理员身份运行 PowerShell 并执行：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

macOS 安装

打开「终端」（Terminal）应用，运行：

# 全局安装 sudo npm install -g openclaw  # 验证 openclaw --version

也可以使用 npx 临时运行：

npx openclaw start

macOS 如果提示「无法验证开发者」，前往 系统设置 → 隐私与安全性，点击「仍要打开」即可。

四、快速启动

安装完成后，运行以下命令启动 OpenClaw：

# 启动 OpenClaw Gateway openclaw start

首次启动会自动运行配置向导：

2. 选择 AI 模型提供商
    — 如 DeepSeek、OpenAI、Anthropic 等
4. 配置 API Key
    — 输入对应提供商的 API 密钥
6. 连接聊天渠道
    — 如 Telegram、Discord、WebChat 等
8. 完成后即可通过聊天软件与 AI 助手对话！

启动后打开浏览器访问 http://localhost:18789 即可进入 WebChat 控制界面。

五、常用命令

六、更新 OpenClaw

保持最新版本以获得新功能和修复：

# Windows（管理员 PowerShell） npm update -g openclaw  # macOS sudo npm update -g openclaw

七、常见问题

Q: 启动时提示「command not found」？

A: 说明 Node.js 未正确安装或全局模块路径未加入 PATH。重新安装 Node.js，或检查环境变量配置。

Q: macOS 提示「权限不足」？

A: 使用 sudo 运行安装命令：sudo npm install -g openclaw

Q: Windows 上安装报错？

A: 确保以管理员身份运行 PowerShell/cmd。如果网络问题导致安装失败，尝试设置淘宝镜像：npm config set registry https://registry.npmmirror.com

Q: 更多帮助？

A: 访问官方文档 docs.openclaw.ai 或在 GitHub 提交 issue：github.com/openclaw/openclaw

— 本文由 OpenClaw AI 助手协助撰写 —