OpenClaw 本地部署教程（Windows / Linux / Mac）
OpenClaw 本地部署教程
本教程基于 OpenClaw 官方文档整理，面向新手，覆盖 Windows、Linux、Mac 三大平台。
目录
什么是 OpenClaw
前置要求
快速安装（推荐）
平台详解
macOS 安装
Linux 安装
Windows 安装（WSL2）
配置与启动
连接聊天渠道
常见问题
什么是 OpenClaw
OpenClaw 是一个开源的 AI 助手框架，核心特点：
多模型支持：OpenAI、Claude、Gemini、本地模型等
多渠道接入：Telegram、Discord、WhatsApp、Signal、Slack 等
可扩展：Skills（技能）系统，支持自定义工具和能力
记忆系统：长期记忆 + 会话管理
Web 界面：内置 Control UI，浏览器即可对话
架构概览：
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Telegram │ │ Discord │ │ WhatsApp │
│ WhatsApp │ │ Signal │ │ Slack │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
└───────────────────────┼───────────────────────┘
│
┌────────▼────────┐
│ Gateway │
│ (本地/服务器) │
└────────┬────────┘
│
┌────────▼────────┐
│ AI Agent │
│ (LLM + Tools) │
└─────────────────┘
前置要求
通用要求
| 项目 | 要求 |
|---|---|
| Node.js | 22.0 或更高版本 |
| pnpm | 推荐使用 pnpm 管理依赖 |
| 网络 | 能访问外网（安装依赖和调用 LLM API） |
检查 Node 版本
node --version
# 应该显示 v22.x.x 或更高
快速安装（推荐）
macOS / Linux
打开终端，运行：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
打开 PowerShell（管理员权限），运行：
iwr -useb https://openclaw.ai/install.ps1 | iex
安装完成后，运行新手引导：
openclaw onboard --install-daemon
这个引导会帮你：
配置模型和认证（API Key）
设置工作目录
安装 Gateway 后台服务
可选：连接聊天渠道
平台详解
macOS 安装
方式一：CLI 安装（推荐新手）
# 1. 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
# 2. 运行新手引导
openclaw onboard --install-daemon
# 3. 检查 Gateway 状态
openclaw gateway status
# 4. 打开 Web 控制台
openclaw dashboard
浏览器会自动打开 http://127.0.0.1:18789/，你可以直接在网页里和 AI 对话。
方式二：macOS 桌面应用
下载 OpenClaw.app（如果有发布版本）
首次打开会弹出安全提示，点击"打开"
授权必要的权限（麦克风、通知、辅助功能等）
选择 Gateway 运行模式（本地 / 远程）
权限说明：
| 权限 | 用途 |
|---|---|
| 辅助功能 | 自动化操作 |
| 通知 | 消息提醒 |
| 麦克风 | 语音对话 |
| 语音识别 | 语音唤醒 |
| 屏幕录制 | 截图功能 |
| 摄像头 | 视频通话 |
macOS 开发者安装（从源码）
如果你想参与开发或使用最新特性：
# 1. 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 2. 安装依赖
pnpm install
# 3. 构建项目
pnpm build
# 4. 构建桌面应用
./scripts/package-mac-app.sh
# 5. 运行
open dist/OpenClaw.app
Linux 安装
快速安装（VPS 推荐）
适合云服务器（如腾讯云、阿里云、AWS）：
# 1. 确保安装了 Node 22+
# Ubuntu/Debian:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# 2. 全局安装 OpenClaw
npm i -g openclaw@latest
# 3. 运行新手引导
openclaw onboard --install-daemon
从本机访问远程 Gateway
如果你的 Gateway 运行在远程 VPS 上：
# 在本地电脑执行 SSH 端口转发
ssh -N -L 18789:127.0.0.1:18789 <user>@<vps-ip>
# 然后在本地浏览器打开
# http://127.0.0.1:18789/
配置 systemd 服务
OpenClaw 默认安装为 用户级服务。要确保服务在退出登录后继续运行：
# 启用 lingering（防止登出后服务停止）
sudo loginctl enable-linger $USER
# 检查服务状态
systemctl --user status openclaw-gateway
# 启用开机自启
systemctl --user enable openclaw-gateway
手动创建 systemd 服务
如果需要自定义配置：
# 创建服务文件
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/openclaw-gateway.service << 'EOF'
[Unit]
Description=OpenClaw Gateway
After=network-online.target
Wants=network-online.target
[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
[Install]
WantedBy=default.target
EOF
# 启用服务
systemctl --user enable --now openclaw-gateway
相关文章：