Windows/macOS/Linux 安装部署 OpenClaw 详细教程（含常用命令速查表）

4小时前 11

教程

OpenClaw 是一个强大的 AI 助手运行环境，支持在多种操作系统上安装部署。本文详细介绍在 Windows、macOS 和 Linux 上安装 OpenClaw 的完整方法，并提供安装后的常用命令速查表。

一、资源下载

1.1 官方下载地址

OpenClaw 官网：https://openclaw.ai
官方文档：https://docs.openclaw.ai
GitHub 仓库：https://github.com/openclaw/openclaw
ClawHub（技能市场）：https://clawhub.ai

1.2 各平台下载页面

Windows 安装包：https://openclaw.ai/downloads/windows
macOS 安装包：https://openclaw.ai/downloads/macos
Linux 安装包：https://openclaw.ai/downloads/linux
Docker 镜像：https://openclaw.ai/downloads/docker

1.3 npm 安装（适合有 Node.js 环境的用户）

npm install -g openclaw

二、Windows 安装部署

2.1 系统要求

Windows 10 或更高版本（建议 Windows 11）
64 位处理器
至少 4GB 内存（推荐 8GB）
至少 10GB 可用磁盘空间
Node.js 18+（如果使用 npm 安装）

2.2 方法一：使用安装包（推荐新手）

访问 https://openclaw.ai/downloads/windows 下载 Windows 安装包（.exe 或 .msi 文件）
双击运行安装程序
按照提示完成安装，默认安装路径为 C:\Program Files\OpenClaw
安装完成后，在开始菜单找到 OpenClaw 并启动
首次运行会自动打开浏览器进入控制台界面

2.3 方法二：使用 npm 安装

确保已安装 Node.js 18 或更高版本
以管理员身份打开 PowerShell 或命令提示符
执行以下命令全局安装 OpenClaw CLI：

npm install -g openclaw

安装完成后，验证安装：

openclaw --version

初始化配置：

openclaw setup

2.4 方法三：使用 Docker 安装

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -p 18789:18789 \
  -v openclaw-data:/home/node/.openclaw \
  openclaw/openclaw:latest

2.5 常见问题与解决

问题一：安装时提示"Windows 已保护您的电脑"

解决方法：点击"更多信息"，然后选择"仍要运行"即可继续安装。这是 Windows SmartScreen 的安全提示，不影响软件安全性。

问题二：npm 安装失败，提示权限错误

解决方法：使用管理员权限打开 PowerShell，或者配置 npm 的全局目录到用户目录：

npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

问题三：启动后无法连接或显示空白

解决方法：以管理员身份运行 OpenClaw，并检查防火墙设置是否允许 OpenClaw 通过。

三、macOS 安装部署

3.1 系统要求

macOS 11 Big Sur 或更高版本
Apple Silicon（M1/M2/M3）或 Intel 处理器
至少 4GB 内存（推荐 8GB）
Node.js 18+（如果使用 npm 安装）

3.2 方法一：使用安装包（推荐新手）

访问 https://openclaw.ai/downloads/macos 下载 macOS 安装包（.dmg 文件）
双击打开镜像文件
将 OpenClaw 拖入应用程序文件夹
首次启动时，右键点击应用选择"打开"，在弹出的对话框中确认运行

3.3 方法二：使用 Homebrew 安装

确保已安装 Homebrew（如果没有，运行以下命令安装）：

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

安装 OpenClaw：

brew install openclaw

验证安装：

openclaw --version

3.4 方法三：使用 npm 安装

npm install -g openclaw

3.5 常见问题与解决

问题一：提示"无法打开，因为来着不明开发者"

解决方法：进入系统偏好设置 - 安全性与隐私 - 通用，选择"仍要打开"。或者右键点击应用选择"打开"。

问题二：Apple Silicon 电脑上运行缓慢

解决方法：确保使用原生 ARM64 版本，或在应用简介中勾选"使用 Rosetta 打开"。

问题三：npm 全局安装需要 sudo 权限

解决方法：配置 npm 不使用 sudo，创建一个 .npmrc 文件：

echo 'prefix = ~/.npm-global' >> ~/.npmrc
export PATH=~/.npm-global/bin:$PATH

四、Linux 安装部署

4.1 系统要求

Ubuntu 20.04、Debian 11、CentOS 8 或更高版本
64 位处理器
至少 2GB 内存（推荐 4GB）
Node.js 18+（如果使用 npm 安装）

4.2 方法一：官方安装脚本（推荐）

下载并运行官方安装脚本：

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

或者指定版本安装：

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

4.3 方法二：npm 全局安装

npm install -g openclaw

4.4 方法三：使用 Docker 安装

docker pull openclaw/openclaw:latest

docker run -d --name openclaw \
  -p 18789:18789 \
  -v ~/openclaw-data:/home/node/.openclaw \
  openclaw/openclaw:latest

4.5 方法四：手动下载安装包

访问 https://openclaw.ai/downloads/linux 下载对应系统的安装包
解压安装包：

tar -xzf openclaw-*.tar.gz
cd openclaw-*

安装：

sudo ./install.sh

4.6 配置系统服务（可选）

创建 systemd 服务以便开机自启：

sudo tee /etc/systemd/system/openclaw.service <<'EOF'
[Unit]
Description=OpenClaw Gateway Service
After=network.target

[Service]
Type=simple
User=YOUR_USERNAME
ExecStart=/usr/local/bin/openclaw gateway
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

4.7 常见问题与解决

问题一：启动时报错"Permission denied"

解决方法：检查数据目录权限，执行以下命令修复：

chmod 755 ~/.openclaw
sudo systemctl restart openclaw

问题二：端口 18789 被占用

解决方法：修改配置文件中的端口号，或者停止占用该端口的其他服务。查找占用进程：

lsof -i :18789
# 或者修改配置文件使用其他端口
openclaw gateway --port 18790

问题三：Web 界面无法访问

解决方法：检查防火墙规则，开放相应端口：

# Ubuntu/Debian (ufw)
sudo ufw allow 18789/tcp

# CentOS/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port=18789/tcp
sudo firewall-cmd --reload

五、初始化配置

5.1 首次启动配置

执行初始化命令：

openclaw setup

或者使用交互式配置向导：

openclaw configure

启动网关服务：

openclaw gateway

打开控制台界面：

openclaw dashboard

5.2 配置文件位置

配置文件：~/.openclaw/config.yaml
工作空间：~/.openclaw/workspace
日志文件：~/.openclaw/logs/

六、常用命令速查表

命令	功能说明	示例
`openclaw --version`	查看 OpenClaw 版本	openclaw --version
`openclaw setup`	初始化本地配置和工作空间	openclaw setup
`openclaw configure`	交互式配置（频道、网关、默认设置）	openclaw configure
`openclaw gateway`	启动 WebSocket 网关服务	openclaw gateway --port 18789
`openclaw gateway --force`	强制重启网关（杀掉占用端口的进程）	openclaw gateway --force
`openclaw dashboard`	在浏览器打开控制台界面	openclaw dashboard
`openclaw status`	查看频道健康状态和最近会话	openclaw status
`openclaw health`	获取网关健康状态	openclaw health
`openclaw doctor`	健康检查和快速修复（网关和频道）	openclaw doctor
`openclaw models list`	列出可用的 AI 模型	openclaw models list
`openclaw channels list`	列出已配置的聊天频道	openclaw channels list
`openclaw skills list`	列出已安装的技能	openclaw skills list
`openclaw skills install <name>`	安装新技能（从 ClawHub）	openclaw skills install halo-search
`openclaw logs`	实时查看网关日志	openclaw logs
`openclaw update`	更新 OpenClaw 到最新版本	openclaw update
`openclaw uninstall`	卸载网关服务和本地数据	openclaw uninstall
`openclaw help`	显示帮助信息	openclaw help

七、重要误区与正确做法

误区一：忽略系统环境要求

正确做法：在安装前务必确认系统版本和硬件配置满足最低要求。Node.js 版本必须为 18 或更高，Windows 7 等老旧系统无法运行新版 OpenClaw。

误区二：忽视安全设置

正确做法：安装后立即修改默认端口、更改默认管理员密码、配置 SSL 证书（生产环境必须）。使用 --auth token 模式启用身份验证。

误区三：防火墙规则未配置

正确做法：在防火墙中开放必要端口，限制仅信任的 IP 访问。特别是在公网环境下，不要开放全部端口到 0.0.0.0。

误区四：直接删除程序文件而非使用卸载命令

正确做法：使用 openclaw uninstall 命令完全卸载，或使用系统的程序卸载功能。直接删除文件可能导致配置文件残留。

误区五：npm 安装时遇到权限问题就放弃

正确做法：配置 npm 全局目录到用户目录，或者使用 nvm 管理 Node.js 版本，避免权限问题。

八、总结

本文详细介绍了在 Windows、macOS 和 Linux 三大主流操作系统上安装部署 OpenClaw 的完整方法，包括官方下载地址、安装步骤、配置方法、常用命令速查表以及常见问题解决方案。

关键要点：访问 https://openclaw.ai 获取最新安装包或使用 npm 全局安装；安装后使用 openclaw setup 初始化配置；通过 openclaw gateway 启动服务；使用 openclaw dashboard 打开控制台。常用命令速查表可帮助用户快速上手使用 OpenClaw。