OpenClaw 安装完全指南(2026最新)

前言

OpenClaw 是一个强大的开源 AI Agent 系统，基于自动化理念设计，能够帮助你处理各种复杂的工作流任务。它支持 Skills 扩展和 MCP（Model Context Protocol）服务器连接，可以将 AI 能力延伸到众多平台和场景。

本文将手把手教你安装 OpenClaw，涵盖 Windows、macOS、Linux 三大平台，附带详细示例和常见问题解答。

什么是 OpenClaw？

在开始安装之前，先了解一下 OpenClaw 的核心特点：

特性	说明
开源免费	GitHub 上开源，MIT 许可证
跨平台	支持 Windows、macOS、Linux
Skills 扩展	丰富的插件生态，一键安装
MCP 支持	可连接任何 MCP 服务器
本地运行	数据留在本地，隐私安全
Chrome 集成	支持浏览器自动化操作

系统要求

在开始安装之前，先确认你的环境是否满足要求：

要求	最低配置	推荐配置
操作系统	Windows 10 / macOS 10.15 / Ubuntu 20.04	Windows 11 / macOS 13 / Ubuntu 22.04
内存	4GB	8GB 及以上
磁盘空间	2GB 可用	5GB 可用
Node.js	v18+	v20+ LTS
网络	能访问 GitHub 和 AI API	稳定的网络连接

Windows 安装步骤

方法一：使用 npm 安装（推荐）

这是最简单的方式，适用于大多数 Windows 用户。

第一步：安装 Node.js

OpenClaw 依赖 Node.js 环境。先去 Node.js 官网^[1] 下载 LTS 版本（长期支持版）。

示例：下载 node-v22.x.x-x64.msi 后双击安装一路点击 "Next" 即可，记得勾选 "Add to PATH"

验证安装：

node --version# 应该输出 v22.x.x 或类似版本npm --version# 应该输出 10.x.x 或类似版本

第二步：安装 OpenClaw

打开 PowerShell 或 Windows Terminal，执行：

npm install -g openclaw

第三步：验证安装

openclaw --version# 如果输出版本号，说明安装成功

方法二：使用 Git 安装（适合开发者）

如果你已经安装了 Git，可以从源码安装：

# 克隆仓库git clone https://github.com/openclaw/openclaw.git# 进入目录cd openclaw# 安装依赖npm install# 链接到全局npm link

macOS 安装步骤

方法一：使用 Homebrew（推荐）

# 添加 tapbrew tap openclaw/tap# 安装brew install openclaw

方法二：使用 npm

npm install -g openclaw

验证安装

openclaw --version

Linux 安装步骤

Ubuntu / Debian

# 安装 Node.js（如果没有）curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs# 安装 OpenClawsudo npm install -g openclaw

验证

openclaw --version

首次配置

安装完成后，需要进行简单配置：

1. 配置 API Key

OpenClaw 需要连接 AI API，需要设置 API Key：

# 方式一：环境变量export OPENAI_API_KEY="sk-xxxxx"  # 如果使用 OpenAIexport ANTHROPIC_API_KEY="sk-ant-xxxxx"  # 如果使用 Anthropic# 方式二：配置文件openclaw config set apiKey "your-api-key"

在哪里获取 API Key？
• OpenAI：访问 OpenAI Platform^[2]，在 API Keys 页面创建
• Anthropic：访问 Anthropic Console^[3]，在 API Keys 页面创建

2. 安装第一个 Skill

OpenClaw 的强大之处在于 Skills 扩展。安装一个试试：

# 安装搜索技能openclaw install tavily-search# 安装内容发布技能openclaw install baoyu-post-to-wechat

3. 验证 Skills

# 查看已安装的 Skillsopenclaw skills list

常见问题

Q1：安装时报错 "command not found"

原因：npm 没有正确添加到 PATH

解决方法：

• Windows：重启终端，或手动将 C:\Program Files\nodejs 添加到 PATH
• macOS/Linux：检查是否正确安装了 Node.js

Q2：npm install 速度很慢

解决方法：使用淘宝镜像

npm config set registry https://registry.npmmirror.com

Q3：提示 "Permission denied"

解决方法：Linux/macOS 加 sudo

sudo npm install -g openclaw

Q4：Windows 上找不到 openclaw 命令

解决方法：以管理员身份运行 PowerShell

快速入门示例

安装完成后，这里有常用场景：

示例一：联网搜索

openclaw "帮我搜索一下最新的 AI 新闻"

示例二：写代码

openclaw "写一个 Python 快速排序算法"

恭喜你完成了 OpenClaw 的安装！接下来可以：

• 阅读官方文档深入学习
• 安装更多 Skills 扩展功能
• 加入社区交流经验

有问题欢迎在评论区留言，我会尽力解答！

如果你觉得这篇文章有帮助，欢迎转发给需要的朋友！

引用链接

[1] Node.js 官网: https://nodejs.org/[2] OpenAI Platform: https://platform.openai.com/[3] Anthropic Console: https://console.anthropic.com/