OpenClaw 跨平台安装与配置实战指南

OpenClaw 跨平台安装与配置实战指南

OpenClaw（俗称'小龙虾'）是一款开源的个人 AI 助手项目，由 PSPDFKit 创始人 Peter Steinberger 开发。与传统聊天 AI 不同，它不仅能回答问题，还能主动操作系统、访问网页、处理邮件等，真正实现'会动手干活的 AI'。

下面我们将分平台介绍 OpenClaw 的安装流程，尽量简化步骤，让不同背景的用户都能顺利运行。

一、安装前准备

1.1 系统要求

在开始之前，请确保你的电脑满足以下基本要求：

配置项	最低要求	推荐配置
操作系统	Windows 10/11、macOS 10.15+、主流 Linux 发行版	Windows 11、macOS 12+、Ubuntu 20.04+
内存	16GB	32GB 或更高
存储空间	2-4GB	10GB 以上
网络	稳定的互联网连接	高速网络

1.2 必要软件

OpenClaw 基于 Node.js 开发，需要以下软件支持：

• Node.js：v20.x 或更高版本（推荐 v22.x LTS 版本）
• Git：用于克隆仓库和安装技能（部分功能需要）
• PowerShell（Windows）：用于执行安装脚本

二、Windows 平台安装教程

2.1 方法一：使用官方一键脚本（推荐）

这是最简单快速的安装方式，适合大多数用户。

首先需要在 Windows 上以管理员权限打开 PowerShell。按 Win + X 键选择'终端 (管理员)'，遇到 UAC 提示时确认即可。

首次运行 PowerShell 脚本需要修改执行策略，输入以下命令并回车：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

出现提示时输入 Y 并回车确认。

接下来复制以下命令并粘贴到 PowerShell 中执行：

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

如果网络环境受限导致下载缓慢，可以配置 npm 镜像源后再进行安装。

安装过程会自动检测并安装 Node.js、核心程序及依赖，通常需要 3-8 分钟。完成后验证安装：

openclaw --version
openclaw --help

2.2 方法二：手动安装（适合高级用户）

如果你已经熟悉 Node.js 环境，可以选择手动安装。

1. 访问 Node.js 官网 下载 LTS 版本（推荐 v22.x）并安装。
2. 验证安装：

   node -v
   npm -v
   

3. 全局安装 OpenClaw：

   npm install -g openclaw
   

4. 验证安装：

   openclaw --version
   

三、macOS 平台安装教程

3.1 方法一：使用官方一键脚本（推荐）

按 Command + 空格 打开 Spotlight 搜索，输入'终端'打开。

复制以下命令并粘贴到终端中执行：

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

脚本会自动检测系统环境并安装所需组件，包括 Homebrew（如果未安装）、Node.js 和 OpenClaw 核心程序。

验证安装：

openclaw --version

3.2 方法二：使用 Homebrew 手动安装

如果偏好包管理工具，可以使用 Homebrew。

1. 安装 Homebrew（如果未安装）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

   安装完成后根据提示将 Homebrew 添加到 PATH。
2. 安装 Node.js 和 Git：

   brew install node
   brew install git
   

3. 全局安装 OpenClaw：

   npm install -g openclaw
   

四、Linux 平台安装教程

4.1 方法一：使用官方一键脚本（推荐）

根据你的 Linux 发行版打开终端（如 Ubuntu/Debian 按 Ctrl + Alt + T）。

先更新系统包管理器：

# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y

# Fedora
sudo dnf update -y

# Arch Linux
sudo pacman -Syu

然后安装必要的依赖：

# Ubuntu/Debian
sudo apt install -y curl git build-essential

# Fedora
sudo dnf install -y curl git gcc-c++ make

# Arch Linux
sudo pacman -S --needed curl git base-devel

执行安装脚本：

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

验证安装：

openclaw --version

4.2 方法二：使用 nvm 安装 Node.js（推荐开发者）

如果你需要灵活管理 Node 版本，建议使用 nvm。

1. 安装 nvm：

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
   source ~/.bashrc
   

2. 安装最新 LTS 版本：

   nvm install --lts
   nvm use --lts
   

3. 全局安装 OpenClaw：

   npm install -g openclaw
   

五、初始化配置

安装完成后，首次使用需要进行初始化配置。

5.1 启动 OpenClaw

在终端或 PowerShell 中运行：

openclaw onboard --install-daemon

5.2 配置向导

首次启动时，OpenClaw 会引导你完成以下配置：

1. 选择 AI 模型提供商：OpenAI、Anthropic Claude、本地模型（如 Ollama）或其他兼容 OpenAI API 的服务。
2. 配置 API Key：输入你的 API Key 并选择默认模型。
3. 设置工作目录：默认为 ~/openclaw 或 C:\Users\你的用户名\openclaw。
4. 配置技能仓库：选择是否启用社区技能及 ClawHub。

5.3 测试运行

配置完成后，可以尝试运行一个简单的命令：

openclaw ask "你好，请介绍一下你自己"

六、常见问题与解决方案

6.1 Windows 常见问题

问题 1：PowerShell 执行策略错误

如果遇到'无法加载文件，因为在此系统上禁止运行脚本'的提示，请重新执行设置执行策略的命令：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

问题 2：找不到 openclaw 命令

重启终端后检查环境变量 PATH 是否包含 npm 全局安装路径。如果仍无效，可手动添加：

$env:Path += ";$(npm config get prefix)"

6.2 macOS/Linux 常见问题

问题 1：权限被拒绝

如果是全局安装报错，尝试使用 sudo：

sudo npm install -g openclaw

问题 2：依赖包编译失败

安装编译工具通常能解决此问题：

# Ubuntu/Debian
sudo apt install -y build-essential python3

# Fedora
sudo dnf install -y gcc-c++ make python3

问题 3：网络连接失败

检查网络连接，或使用代理。如果是 npm 安装慢，可配置国内镜像源：

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

七、卸载 OpenClaw

如果需要卸载，可以按照以下步骤操作：

7.1 Windows

npm uninstall -g openclaw
Remove-Item -Recurse -Force $env:USERPROFILE\openclaw
Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

7.2 macOS/Linux

npm uninstall -g openclaw
rm -rf ~/openclaw
rm -rf ~/.openclaw

八、进阶配置

8.1 配置本地模型（Ollama）

如果你想在本地运行 AI 模型，可以配置 Ollama：

1. 访问 Ollama 官网 下载并安装。
2. 拉取模型：

   ollama pull llama2
   

3. 配置 OpenClaw 使用本地模型：

   openclaw config set model.provider ollama
   openclaw config set model.url http://localhost:11434
   openclaw config set model.name llama2
   

8.2 安装技能

OpenClaw 支持通过 ClawHub 安装各种技能：

# 搜索技能
openclaw skill search feishu

# 安装技能
openclaw skill install feishu-integration

# 列出已安装技能
openclaw skill list

# 卸载技能
openclaw skill uninstall feishu-integration

九、资源链接

• 官网：https://openclaw.ai
• 官方文档：https://docs.openclaw.ai
• GitHub 仓库：https://github.com/openclaw/openclaw