🦞 OpenClaw 全平台部署教程

一、OpenClaw 是什么？

OpenClaw 是一款开源的个人 AI 助手网关，它允许你在自己的设备上运行 AI 助手，并通过 WhatsApp、Telegram、Slack、Discord、飞书、企业微信等多种消息平台与你交互。最关键的是——所有数据都保存在本地，完全由你掌控。

自 2025 年 11 月发布以来，OpenClaw 在短短三个月内就突破了 24 万+ GitHub Star，成为史上增长最快的开源项目之一。

✨ 核心特性

• 多平台支持：原生对接 Telegram、WhatsApp、Discord、Slack、飞书、企业微信、钉钉等 10+ 消息平台
• 模型自由：支持 OpenAI、Anthropic Claude、Google Gemini、Azure OpenAI 等主流大模型
• Skills 扩展：内置应用市场，可一键安装各类技能插件（天气查询、翻译、代码生成等）
• 隐私优先：所有数据存储在本地，不依赖云端服务
• Web Dashboard：提供美观的 Web 管理界面，可视化管理配置

二、系统要求与准备工作

💻 硬件配置要求

🔧 软件依赖

🔑 API 密钥准备

在开始安装之前，你需要至少准备一个大语言模型的 API 密钥：

• OpenAI：访问 platform.openai.com/api-keys 获取
• Anthropic Claude：访问 console.anthropic.com 获取
• Google AI：访问 aistudio.google.com 获取
• 国内用户备选：可使用兼容 OpenAI 格式的聚合 API 服务

三、macOS 安装教程

macOS 是运行 OpenClaw 的最佳平台，安装过程最为顺畅。

🚀 方式一：一键安装脚本（推荐）

打开终端（Terminal），执行以下命令：

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

这个脚本会自动完成以下操作：

1. 检测系统是否已安装 Node.js，若版本不满足要求会提示升级
2. 全局安装 OpenClaw 最新版本
3. 启动交互式引导向导（onboarding wizard）
4. 配置系统服务（可选）

📦 方式二：npm 手动安装

步骤 1：确认 Node.js 版本

node --version

确保输出为 v22.x.x 或更高版本。如果版本过低或未安装，推荐使用 nvm 管理：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载 shell 配置
source ~/.zshrc

# 安装 Node.js 22
nvm install 22
nvm use 22

步骤 2：全局安装 OpenClaw

npm install -g openclaw@latest

步骤 3：运行引导向导

openclaw onboard --install-daemon

✅ 验证安装

# 检查系统配置
openclaw doctor

# 查看网关状态
openclaw status

# 打开 Web 管理界面
openclaw dashboard

四、Windows 安装教程

🔧 第一步：启用 WSL2

以管理员身份打开 PowerShell，执行：

wsl --install

这个命令会自动完成以下操作：

• 启用 WSL 功能
• 启用虚拟机平台
• 下载并安装 Ubuntu 发行版（默认）
• 安装 WSL2 Linux 内核更新包

安装完成后，需要重启电脑。重启后会自动打开 Ubuntu 终端，提示你设置 Linux 用户名和密码。

# 查看已安装的发行版及其版本
wsl -l -v

# 将指定发行版升级为 WSL2
wsl --set-version Ubuntu 2

📦 第二步：在 WSL2 中安装 Node.js

进入 WSL2 的 Ubuntu 终端，执行：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新加载 shell 配置
source ~/.bashrc

# 安装 Node.js 22
nvm install 22

# 验证安装
node --version

🚀 第三步：安装 OpenClaw

在 WSL2 终端中执行一键安装脚本：

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

或者使用 npm 手动安装：

npm install -g openclaw@latest
openclaw onboard --install-daemon

✅ 验证安装

# 检查系统配置
openclaw doctor

# 启动网关
openclaw gateway start

# 打开管理面板
openclaw dashboard

五、Linux 安装教程

Linux 是 OpenClaw 部署到服务器/VPS 的首选平台。以下以 Ubuntu 22.04 为例。

🚀 方式一：一键安装脚本

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

📦 方式二：手动安装

步骤 1：安装 Node.js 22

# 使用 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证版本
node --version

步骤 2：安装浏览器自动化依赖（可选）

sudo apt-get install -y \
  ca-certificates \
  fonts-liberation \
  libgbm1 \
  libnss3 \
  libatk-bridge2.0-0 \
  libgtk-3-0

步骤 3：安装 OpenClaw

npm install -g openclaw@latest
openclaw onboard --install-daemon

🔄 使用 PM2 守护进程（生产环境推荐）

# 安装 PM2
npm install -g pm2

# 启动 OpenClaw 网关
pm2 start "openclaw gateway start" --name openclaw

# 设置开机自启
pm2 startup
pm2 save

# 查看状态
pm2 status

六、Docker 部署方案

Docker 部署是生产环境的推荐方式，具有环境隔离、一键部署、安全性更高等优势。

🐳 前置条件

# 检查 Docker 版本
docker --version

# 检查 Docker Compose
docker compose version

🚀 快速部署

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 执行部署脚本
./docker-setup.sh

📦 手动分步部署

# 1. 构建镜像
docker build -t openclaw:latest .

# 2. 运行引导向导（首次部署）
docker compose run --rm openclaw-cli onboard

# 3. 启动服务
docker compose up -d

# 4. 查看日志
docker compose logs -f

⚙️ Docker Compose 配置示例

创建 docker-compose.yml 文件：

version: '3.8'

services:
  openclaw:
    image: openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
      - "3000:3000"
    volumes:
      - ./openclaw-data:/root/.openclaw
    environment:
      - NODE_ENV=production
      - OPENCLAW_HOME=/root/.openclaw
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL

# 本地执行 SSH 隧道
ssh -L 18789:localhost:18789 user@your-server-ip

七、初始化配置与 API 密钥设置

安装完成后，运行引导向导进行初始配置：

openclaw onboard

📝 配置步骤

步骤 1：选择 LLM 供应商

系统会列出所有支持的 LLM 供应商，包括 OpenAI、Anthropic (Claude 3)、Google AI (Gemini)、Azure OpenAI、Ollama 等。

步骤 2：输入 API 密钥

根据选择的供应商，输入对应的 API 密钥。密钥会加密存储在本地配置文件中。

步骤 3：选择消息平台

选择你要绑定的消息平台，如 Telegram、WhatsApp、飞书等。每个平台都有相应的配置指引。

步骤 4：完成配置

向导会生成配置文件并保存在 ~/.openclaw/config.yaml，你可以随时编辑此文件修改配置。

📁 配置文件位置

🌐 环境变量配置

# 设置主目录
export OPENCLAW_HOME=/custom/path/.openclaw

# 设置状态文件位置
export OPENCLAW_STATE_DIR=/custom/path/state

# 设置配置文件路径
export OPENCLAW_CONFIG_PATH=/custom/path/config.yaml

八、常见问题排查

❓ 问题速查表

🔧 详细解决方案

1. command not found 问题

# 查看全局 bin 目录
npm prefix -g

# 添加到 PATH（添加到 ~/.bashrc 或 ~/.zshrc）
export PATH="$(npm prefix -g)/bin:$PATH"

# 重新加载配置
source ~/.bashrc

2. Sharp 模块安装失败

# 设置环境变量跳过预构建
export SHARP_IGNORE_GLOBAL_LIBVIPS=1

# 重新安装
npm rebuild sharp

3. npm 权限问题

# 创建 npm 全局目录
mkdir -p ~/.npm-global

# 配置 npm 使用新目录
npm config set prefix ~/.npm-global

# 添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

4. 一键诊断命令

# 自动检测并修复常见问题
openclaw doctor --fix

九、安全加固建议

OpenClaw 作为个人 AI 助手网关，安全性至关重要。以下是一些重要的安全建议：

🔐 1. 配置用户白名单

编辑 ~/.openclaw/config.yaml，添加允许访问的用户 ID：

allowed_users:
  - "your_telegram_user_id"
  - "your_discord_user_id"

这是防止未授权访问的最有效方式。

🔒 2. 端口访问控制

• 不要将 Dashboard 端口暴露到公网
• 使用 SSH 隧道或 VPN 进行安全访问
• 配置防火墙规则，仅允许必要的入站连接

👤 3. 最小权限原则

• 创建专用的非 root 用户运行 OpenClaw
• Docker 部署时使用 cap_drop: ALL 移除不必要的权限
• 定期检查并更新 Skills，移除不再使用的插件

💾 4. 定期备份

# 备份
cp -r ~/.openclaw ~/.openclaw.backup.$(date +%Y%m%d)

# 恢复
cp -r ~/.openclaw.backup.YYYYMMDD ~/.openclaw

十、总结

本文详细介绍了 OpenClaw 在 Windows、macOS、Linux 三大平台的部署方法，以及 Docker 容器化部署方案。让我们来总结一下各平台的特点：

OpenClaw 代表了个人 AI 助手的未来方向——隐私可控、功能强大、高度可定制。希望这篇教程能帮助你顺利完成部署，开启你的专属 AI 助手之旅！

如有问题，可以参考官方文档 docs.openclaw.ai 或在 GitHub 仓库提 Issue。

祝你玩得开心！🦞

📝 本文为原创内容，转载请注明出处 | 📅 最后更新：2026年3月