OpenClaw 安装指南：Windows/Mac/Linux 全平台教程

OpenClaw 是一个强大的 AI 助手网关，支持多平台接入、多模型切换和丰富的技能扩展。本文将详细介绍如何在 Windows、macOS 和 Linux 三大平台上安装和配置 OpenClaw，帮助你快速搭建属于自己的 AI 助手。

一、安装前准备

在开始安装之前，请确保你的系统满足以下基本要求：

• Node.js：版本 18.x 或更高（推荐使用 LTS 版本）
• npm：随 Node.js 自动安装
• 内存：至少 512MB 可用内存
• 磁盘空间：至少 500MB 可用空间

1.1 检查 Node.js 环境

打开终端（Windows 用户使用 PowerShell 或 CMD），运行以下命令检查 Node.js 是否已安装：

node --version
npm --version

如果显示版本号，说明环境已就绪。如果未安装，请前往 Node.js 官网 下载安装包。

二、Windows 安装步骤

2.1 使用安装程序

Windows 用户可以通过以下步骤快速安装：

# 使用 npm 全局安装
npm install -g openclaw

# 验证安装
openclaw --version

2.2 初始化配置

首次运行需要进行初始化配置：

# 创建配置目录
openclaw init

# 启动 OpenClaw
openclaw start

启动成功后，OpenClaw 会在 ~/.qclaw/ 目录下生成默认配置文件。

2.3 配置 API Key

编辑配置文件，添加你的 AI 模型 API Key：

# 打开配置文件
notepad %USERPROFILE%\.qclaw\config.json

在 models 部分添加你的 API Key：

{
  "models": {
    "openai": {
      "apiKey": "sk-your-api-key-here"
    }
  }
}

三、macOS 安装步骤

3.1 使用 Homebrew（推荐）

macOS 用户推荐使用 Homebrew 安装：

# 添加 OpenClaw 仓库
brew tap openclaw/tap

# 安装 OpenClaw
brew install openclaw

# 验证安装
openclaw --version

3.2 使用 npm 安装

也可以通过 npm 直接安装：

sudo npm install -g openclaw

# 初始化并启动
openclaw init
openclaw start

3.3 后台运行配置

使用 launchd 实现开机自启动：

# 创建服务配置
openclaw service install

# 启动服务
openclaw service start

四、Linux 安装步骤

4.1 Ubuntu/Debian

对于 Ubuntu/Debian 系统：

# 更新包管理器
sudo apt update

# 安装 Node.js（如果未安装）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 安装 OpenClaw
sudo npm install -g openclaw

# 初始化
openclaw init

4.2 CentOS/RHEL

对于 CentOS/RHEL 系统：

# 安装 Node.js
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

# 安装 OpenClaw
sudo npm install -g openclaw

4.3 使用 systemd 管理服务

创建 systemd 服务文件实现后台运行：

sudo openclaw service install
sudo systemctl enable openclaw
sudo systemctl start openclaw

五、Docker 安装方式

对于喜欢容器化部署的用户，OpenClaw 提供了官方 Docker 镜像：

# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v ~/.qclaw:/root/.qclaw \
  openclaw/openclaw:latest

六、常见问题解决

问题1：npm install 报权限错误

解决方案：使用 sudo 或配置 npm 全局目录

# 方法一：使用 sudo
sudo npm install -g openclaw

# 方法二：配置 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

问题2：启动后无法访问

检查防火墙设置和端口占用：

# Linux
sudo ufw allow 3000

# 查看 3000 端口占用
lsof -i :3000

七、安装后下一步

安装完成后，建议你：

1. 阅读配置文件详解，了解各项参数含义
2. 接入你的第一个 AI 模型（推荐从 OpenAI 开始）
3. 尝试连接一个通讯平台（如 Telegram 或 Discord）
4. 探索技能系统，扩展 AI 助手的能力

小贴士

• 定期运行 openclaw update 获取最新功能和修复
• 配置文件修改后需要重启服务生效
• 遇到问题可以查看日志：openclaw logs
• 加入社区获取更多帮助和支持

恭喜你完成 OpenClaw 的安装！接下来就可以开始打造属于你的个性化 AI 助手了。关注我们的公众号，获取更多 OpenClaw 使用技巧和进阶教程。