OpenClaw 安装教程：Mac/Windows/Linux 本地部署与云端配置完整指南

本章节将手把手教你安装 OpenClaw。

📋 前提条件与推荐配置

为什么推荐 Mac？

OpenClaw 在 Mac 上体验最好，因为：

✅ 原生支持最完善，系统集成度高
✅ 可以操作 Mac 日历、备忘录、提醒事项
✅ 截图功能完美支持
✅ 与 iPhone、iPad 无缝同步
✅ 文件管理更智能
✅ 开发环境配置简单

为什么推荐飞书（国内）？

✅ 现代化设计，用户体验好
✅ 开发者友好，API 完善
✅ 支持富文本、文档、表格
✅ 消息推送稳定
✅ 免费版功能丰富

为什么推荐 Telegram（国外）？

✅ 全球用户基础大
✅ API 最完善，功能最强
✅ 支持 Bot 功能丰富
✅ 消息推送实时
✅ 隐私保护好

快速导航

推荐路径：

🍎 有 Mac → Mac 本地部署 + 飞书配置
☁️ 无 Mac/想 24 小时运行 → 云端一键部署 + 飞书配置

所有部署方式：

🍎 Mac 本地部署（推荐）
🪟 Windows 本地部署
🐧 Linux 本地部署
🚀 云端一键部署
🇨🇳 国内一键安装（推荐）
☁️ Cloudflare Workers 部署（进阶）
🐳 Docker 部署（可选）

配置指南：

🔑 API 配置指南
🔄 版本升级指南
❓ 常见问题解决

Mac 本地部署（推荐）

🍎 最佳体验：如果你有 Mac 电脑，强烈推荐本地部署，体验最好、功能最全！

为什么选择 Mac 本地部署？

优势：

✅ 系统集成：可操作日历、备忘录、文件系统
✅ 隐私安全：数据完全本地，不上传云端
✅ 响应速度快：本地运行，无网络延迟
✅ 功能最全：支持所有高级功能
✅ 成本低：无需购买云服务器
✅ 开发友好：方便调试和自定义

适合人群：

有 Mac 电脑的用户
注重隐私的用户
需要系统集成功能的用户
开发者和技术爱好者

系统要求

硬件要求：

CPU：M 系列芯片或 Intel i5 以上
内存：8GB 以上（推荐 16GB）
硬盘：10GB 以上空闲空间

系统版本：

macOS 12 Monterey 或更高版本
推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

前置软件：

Node.js 22.0.0+（会自动安装）
Homebrew（可选，用于安装依赖）

安装步骤

第一步：打开终端

按 Command + 空格 打开 Spotlight
输入 Terminal 或 终端
按回车打开终端

第二步：安装 OpenClaw

在终端中执行以下命令：

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

安装过程会自动：

检测系统环境
安装 Node.js（如果未安装）
下载 OpenClaw
配置环境变量

预计时间：2-5 分钟

第三步：验证安装

安装完成后，执行以下命令验证：

openclaw --version

如果显示版本号（如 2026.3.2），说明安装成功！

第四步：初始化配置

运行配置向导：

openclaw onboard

配置流程：

接受风险提示：选择 Yes 继续
选择启动模式：推荐选择 QuickStart 快速启动
选择 AI 模型：选择你的 AI 供应商

国内推荐：

Kimi（Moonshot AI）：长文本专家，200 万字上下文
DeepSeek：性价比之王，推理能力强
智谱 GLM：中文理解好，多模态支持

输入 API Key：根据选择的模型，输入对应的 API Key
选择聊天工具：如果要接入飞书/Telegram，选择对应选项
Gateway 端口设置：默认 18789 即可
选择 Skills：使用空格键选择需要的技能
完成配置：配置完成后，会自动启动 Gateway 服务并打开 Web UI

第五步：验证安装

# 检查 Gateway 状态
openclaw channels status

# 应该显示：Gateway reachable

日常使用

启动 OpenClaw：

# 启动 Gateway 服务
openclaw gateway start

# 或使用 systemd（推荐，开机自启）
openclaw gateway enable

访问 Web UI：

打开浏览器访问：http://127.0.0.1:18789/chat

停止服务：

openclaw gateway stop

常见问题

Q1：安装时提示权限不足？

# 使用 sudo 安装
curl -fsSL https://openclaw.ai/install.sh | sudo bash

Q2：如何更新 OpenClaw？

openclaw update

Q3：如何卸载？

openclaw uninstall

Windows 本地部署

🪟 Windows 用户：完全可用，但部分系统集成功能受限。

系统要求

硬件要求：

CPU：2 核以上
内存：4GB 以上（推荐 8GB）
硬盘：10GB 以上空闲空间

操作系统：

Windows 10 或 Windows 11

前置软件：

Node.js 22.0.0+

部署方式选择

Windows 有两种部署方式：

WSL2 + Ubuntu（强烈推荐）：官方推荐方式，提供完整 Linux 环境支持
PowerShell 原生部署：纯 Windows 环境，适合不想使用 WSL2 的用户

方式一：WSL2 + Ubuntu 部署（强烈推荐）

第一步：启用 WSL2

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

# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 设置 WSL 2 为默认版本
wsl --set-default-version 2

重启计算机。

第二步：安装 Ubuntu

方法一：Microsoft Store 安装（推荐）

打开 Microsoft Store
搜索「Ubuntu 22.04 LTS」或「Ubuntu 24.04 LTS」
点击「获取」并安装
首次启动设置用户名和密码

第三步：更新 Ubuntu 系统

在 Ubuntu 终端中执行：

# 更新软件包列表
sudo apt update && sudo apt upgrade -y

# 安装基础工具
sudo apt install -y curl git wget build-essential

第四步：安装 Node.js 22+

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

# 验证版本（必须≥22.x）
node -v
npm -v

第五步：安装 OpenClaw

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

第六步：验证安装

# 查看版本
openclaw --version

# 查看帮助
openclaw --help

# 查看系统状态
openclaw status

第七步：配置 Windows 访问 WSL2 服务

创建启动脚本 start-openclaw.bat：

@echo off
echo Starting OpenClaw Gateway in WSL2...
wsl -d Ubuntu-22.04 -u root service openclaw start
timeout /t 3
start http://localhost:18789

或在 WSL2 中启动：

openclaw gateway run --port 18789

然后在 Windows 浏览器访问 http://localhost:18789

方式二：PowerShell 原生部署

第一步：安装 Node.js 22+

访问 https://nodejs.org/zh-cn 下载 Windows 安装包（LTS 版本 22.x）

第二步：验证 Node.js 安装

# 打开 PowerShell
node -v
npm -v

第三步：以管理员身份安装 OpenClaw

npm install -g openclaw@latest

第四步：解决安装权限问题

如果遇到权限错误：

# 启用 PowerShell 脚本执行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Linux 本地部署

🐧 Linux 用户：适合开发者，配置灵活。

系统要求

推荐发行版：

Ubuntu 20.04+
Debian 11+
CentOS 8+

安装步骤

第一步：安装 Node.js

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version

第二步：安装 OpenClaw

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

第三步：验证安装

openclaw --version

第四步：初始化配置

openclaw onboard

云端一键部署

🔥 适合场景：无 Mac 电脑、需要 24 小时运行、多设备访问。

为什么选择云端部署？

优势	说明
⚡ 秒级部署	点几下鼠标就完成，无需配置环境
💰 成本低	20 元/月起，比买 Mac Mini 便宜太多
📱 手机可用	通过 QQ、企微、飞书随时随地访问
🔒 稳定可靠	24 小时运行，不用担心电脑关机

方案对比

方案	价格	带宽	推荐场景
腾讯云 Lighthouse	20 元/月，99 元/年	20M	QQ、企微用户
火山引擎	9.9 元/月，58 元/年	5M	飞书用户

腾讯云 Lighthouse 部署（推荐）

第一步：购买服务器

访问活动页面：https://cloud.tencent.com/act/pro/lighthouse-moltbot
选择配置：2核2G，带宽 20M
地域：建议选择硅谷（国外地域访问 AI 模型更稳定）
价格：20 元/月或 99 元/年
完成实名认证后购买

第二步：连接服务器

使用 SSH 客户端连接：

地址：公网 IP 地址
端口：22
用户名：lighthouse
密码：购买时设置的密码

验证 OpenClaw 安装：

openclaw --version

第三步：配置大模型

进入「应用管理」标签
选择模型：推荐使用 Kimi k2.5（性价比最高）
获取 API Key：

访问 https://platform.moonshot.cn/
注册账号并登录
进入「API 管理」
点击「创建 API Key」

将 API Key 粘贴到配置框，点击「保存」

第四步：测试连接

访问 WebUI，发送测试消息：

你好，能听到我说话吗？

如果收到 AI 回复，说明配置成功！

火山引擎部署（更便宜）

如果你是飞书重度用户，推荐使用火山引擎：

访问：https://www.volcengine.com/activity/clawdbot
价格：9.9 元/月，58 元/年
比腾讯云便宜 10 元

百度智能云部署（0.01 元试用）

💰 超值试用：百度智能云提供 0.01 元/月的特惠活动

访问：https://cloud.baidu.com/product/BCC/moltbot.html
注册并完成实名认证
抢购特惠 LS 实例
一键配置 OpenClaw

国内一键安装（推荐）

🇨🇳 国内用户推荐：使用官方中文版一键安装脚本，速度快、配置简单。

前置要求

必需环境：

Node.js 22.0.0+（必需）
pnpm（可选，推荐用于源码构建）

系统要求：

macOS：需要 Xcode / Command Line Tools
Windows：强烈推荐使用 WSL2（Ubuntu）
Linux：Ubuntu 20.04+、Debian、CentOS

快速开始

macOS/Linux 安装

curl -fsSL https://clawd.org.cn/install.sh | bash

Windows 安装

使用 PowerShell（管理员权限）：

iwr -useb https://clawd.org.cn/install.ps1 | iex

⚠️ Windows 用户注意：强烈推荐使用 WSL2（Ubuntu），原生 Windows 支持有限。

运行入门向导

openclaw-cn onboard --install-daemon

配置流程：

选择网关模式：本地网关（推荐）或远程网关
配置认证：API 密钥（推荐用于 Anthropic）
选择 AI 提供商：Kimi、DeepSeek、GLM-4 等
配置聊天平台：WhatsApp、Telegram、飞书等（可选）
安装后台服务（推荐）
网关令牌：向导默认生成

启动 Gateway

# 检查 Gateway 状态
openclaw-cn gateway status

# 手动运行（前台）
openclaw-cn gateway --port 18789 --verbose

Dashboard 访问：

本地回环地址：http://127.0.0.1:18789/

Cloudflare Workers 部署（进阶）

☁️ 全球 CDN 加速：使用 Cloudflare Workers 部署 OpenClaw

为什么选择 Cloudflare Workers？

优势	说明
🌍 全球加速	部署在 Cloudflare 全球边缘网络
💰 成本可控	5 美元/月起步，24 小时在线
🔒 安全可靠	内置 Zero Trust 安全认证
⚡ 快速部署	一键部署，10 分钟完成

前置要求

Cloudflare 账号
Workers Paid 计划（5 美元/月）
信用卡（用于订阅付费计划）

部署流程

第一步：一键部署 Moltworker

点击部署按钮：https://deploy.workers.cloudflare.com/?url=https://github.com/cloudflare/moltworker
配置 Gateway Token（务必修改并妥善保存）

第二步：等待构建

部署过程约需 10 分钟

第三步：配置 Access（Zero Trust）

配置 CF_ACCESS_AUD 和 CF_ACCESS_TEAM_DOMAIN 两个变量

第四步：配置 R2 对象存储

配置以下三个变量：

CF_ACCOUNT_ID
R2_ACCESS_KEY_ID
R2_SECRET_ACCESS_KEY

第五步：注入变量并重启

填入所有变量后，点击 Deploy 重新部署

Docker 部署（可选）

🐳 开发者选项：Docker 部署适合需要环境隔离的场景

为什么选择 Docker？

优势	说明
🔒 环境隔离	不影响系统环境，干净整洁
📦 一键部署	无需配置依赖，开箱即用
🔄 易于更新	一条命令完成更新
🌐 跨平台	Windows/macOS/Linux 统一方案

前置要求

安装 Docker：

macOS：

brew install --cask docker

Windows：

下载 Docker Desktop：https://www.docker.com/products/docker-desktop

Linux (Ubuntu)：

curl -fsSL https://get.docker.com | sh
sudo systemctl start docker
sudo systemctl enable docker

快速开始

方式一：一键脚本部署（推荐新手）

curl -fsSL https://clawd.org.cn/install.sh | bash

完成后，在浏览器打开 http://127.0.0.1:18789/ 即可使用。

方式二：手动 Docker Compose 部署

步骤 1：创建工作目录

mkdir -p ~/openclaw-docker
cd ~/openclaw-docker

步骤 2：创建 .env 环境文件

cat > .env << 'EOF'
OPENCLAW_IMAGE=jiulingyun803/openclaw-cn:latest
OPENCLAW_CONFIG_DIR=./data/.openclaw
OPENCLAW_WORKSPACE_DIR=./data/clawd
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_GATEWAY_TOKEN=your-secure-token-here
EOF

步骤 3：创建 docker-compose.yml 文件

services:
  openclaw-cn-gateway:
    image: ${OPENCLAW_IMAGE:-jiulingyun803/openclaw-cn:latest}
    user: node:node
    environment:
      HOME: /home/node
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
    volumes:
      - ${OPENCLAW_CONFIG_DIR:-./data/.openclaw}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR:-./data/clawd}:/home/node/clawd
    ports:
      - "${OPENCLAW_GATEWAY_PORT:-18789}:18789"
    restart: unless-stopped
    command: ["node", "dist/index.js", "gateway", "--bind", "lan", "--port", "18789"]

步骤 4：启动容器

# 拉取最新镜像
docker compose pull

# 启动网关（后台运行）
docker compose up -d openclaw-cn-gateway

# 查看日志
docker compose logs -f openclaw-cn-gateway

步骤 5：运行配置向导

docker compose run --rm openclaw-cn-cli onboard

API 配置指南

OpenClaw 需要连接 AI 模型才能工作，推荐使用国产大模型，性价比高。

为什么需要 API？

OpenClaw 本身不包含 AI 模型，需要连接第三方 API：

官方 API：价格贵、国内访问困难
第三方 API：价格便宜、国内直连

API 模型分类

1. 内置 API 模型（推荐新手）

OpenClaw 已经预先配置好了多个主流 AI 模型的连接方式，你只需要：

✅ 获取 API Key
✅ 在配置向导中选择对应模型
✅ 粘贴 API Key 即可使用

国内模型（推荐）：

🌙 Moonshot AI (Kimi)：长文本专家，200 万字上下文
🧠 DeepSeek：性价比之王，推理能力强
🎯 智谱 GLM：中文理解好，多模态支持
🚀 通义千问 (Qwen)：阿里出品，稳定可靠
🎨 MiniMax：对话自然，创意能力强
📚 百度文心：中文语料丰富
🔥 字节豆包：性价比高

2. 自定义 API（进阶用户）

适合使用 OpenClaw 未内置的模型或自建模型服务。

配置文件位置：

~/.openclaw/openclaw.json

配置示例（DeepSeek）：

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "sk-你的API密钥",
        "auth": "api-key",
        "api": "openai-chat",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "contextWindow": 64000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    }
  }
}

配置方式对比

特性	内置 API 模型	自定义 API
配置难度	⭐ 简单	⭐⭐⭐⭐ 复杂
适用人群	新手	进阶用户
模型选择	主流模型	任意模型
灵活性	中	高

推荐配置：Kimi 2.5

特点：

📚 超长上下文：支持 200 万字
📄 长文档处理：论文、报告分析专家
🎯 中文理解好：适合中文场景

配置步骤：

访问 https://www.kimi.com/code
购买套餐（推荐 Allegretto 套餐）
打开控制台，创建 API Key
复制 API Key（务必保存，关闭后无法查看）
运行配置向导：

openclaw onboard

选择模型供应商：Moonshot AI
粘贴 API Key
选择默认模型：kimi-code/kimi-for-coding

成本估算：

轻度使用：10-20 元/月
中度使用：30-50 元/月
重度使用：建议购买套餐

推荐配置：DeepSeek

特点：

💰 最便宜：输入 0.001 元/千 tokens
🧠 推理能力强：适合复杂任务
💻 编程能力出色：代码生成质量高

配置步骤：

访问 https://platform.deepseek.com/
注册账号并充值（建议先充值 10 元）
点击「API keys」→「创建 API key」
复制 API Key（只显示一次，务必保存）
运行配置向导：

openclaw onboard

选择模型供应商：DeepSeek
粘贴 API Key
选择默认模型：deepseek-chat

成本估算：

日常使用：5-10 元/月
中度使用：10-30 元/月
重度使用：30-50 元/月

成本对比

模型	输入价格	输出价格	月费用估算
DeepSeek	0.001 元/千 tokens	0.002 元/千 tokens	5-30 元
Kimi	0.012 元/千 tokens	0.012 元/千 tokens	10-50 元
GLM-4	0.005 元/千 tokens	0.005 元/千 tokens	10-40 元
Claude（第三方）	0.015 元/千 tokens	0.075 元/千 tokens	50-200 元
GPT-4（第三方）	0.03 元/千 tokens	0.06 元/千 tokens	100-300 元

💡 省钱技巧：

日常对话用 DeepSeek（最便宜）
长文档用 Kimi（长上下文）
复杂任务用 Claude（质量最高）

常见问题解决

安装问题

Q1: Node.js 版本不对

# 检查版本
node --version

# 如果低于 22，升级
nvm install 22
nvm use 22

Q2: 权限错误

# macOS/Linux
sudo chown -R $USER ~/.openclaw

API 配置问题

Q1: API Key 无效

检查是否完整复制（包括 sk- 前缀）
检查是否有多余空格
检查账户余额是否充足

Q2: Token 消耗太快

使用更便宜的模型（DeepSeek）
优化提示词
定期清理会话历史

Gateway 问题

Q1: Gateway 无法启动

# 查看日志
tail -f ~/.openclaw/logs/gateway.log

# 重启 Gateway
openclaw gateway restart

Q2: 端口被占用

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

# 修改端口
openclaw config set gateway.port 18790

版本升级指南

🔄 保持最新：定期升级 OpenClaw 以获得新功能、性能优化和安全修复。

⚠️ 重要提示：目前推荐使用 2026.3.2 版本。2026.2.12 版本存在已知 bug，会导致 heartbeat 和消息处理功能异常。

检查当前版本

# 查看当前版本
openclaw --version

npm 直接升级（推荐）

第一步：备份配置

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

第二步：停止 Gateway 服务

openclaw gateway stop

第三步：卸载旧版本

npm uninstall -g openclaw

第四步：安装新版本

npm install -g openclaw@2026.3.2 --force

第五步：修复配置

openclaw doctor --fix

第六步：重启 Gateway

openclaw gateway restart

第七步：验证升级

openclaw --version
openclaw gateway status

Docker 升级

# 停止并删除旧容器
docker compose down

# 拉取最新镜像
docker compose pull

# 启动新容器
docker compose up -d openclaw-cn-gateway

# 查看日志
docker compose logs -f openclaw-cn-gateway

回滚到旧版本

如果升级后遇到问题，可以回滚：

# 停止 Gateway
openclaw gateway stop

# 恢复配置
cp -r ~/.openclaw.backup-20260213/* ~/.openclaw/

# 降级到旧版本
npm uninstall -g openclaw
npm install -g openclaw@2026.2.1-zh.3 --force

# 重启 Gateway
openclaw gateway restart

本章小结

通过本章节，你应该已经：

✅ 了解了云端部署和本地部署的区别
✅ 完成了 OpenClaw 的安装（云端或本地）
✅ 配置了 API（推荐国产大模型）
✅ 验证了安装是否成功
✅ 学会了如何升级 OpenClaw

实战练习

完成 OpenClaw 安装（云端或本地）
配置至少一个 API（推荐 DeepSeek 或 Kimi）
发送第一条测试消息
验证 AI 是否正常回复
检查当前版本，如有更新可尝试升级

下一章预告

下一章：第3章：快速上手 – 开始使用 OpenClaw

文章版权归作者所有，未经允许请勿转载。

THE END

未分类
# 本地部署 # OpenClaw 安装 # Docker 部署 # API 配置 # 环境搭建

第2章：环境搭建

📋 前提条件与推荐配置

推荐配置

为什么推荐 Mac？

为什么推荐飞书（国内）？

为什么推荐 Telegram（国外）？

快速导航

Mac 本地部署（推荐）

为什么选择 Mac 本地部署？

系统要求

安装步骤

第一步：打开终端

第二步：安装 OpenClaw

第三步：验证安装

第四步：初始化配置

第五步：验证安装

日常使用

常见问题

Windows 本地部署

系统要求

部署方式选择

方式一：WSL2 + Ubuntu 部署（强烈推荐）

第一步：启用 WSL2

第二步：安装 Ubuntu

第三步：更新 Ubuntu 系统

第四步：安装 Node.js 22+

第五步：安装 OpenClaw

第六步：验证安装

第七步：配置 Windows 访问 WSL2 服务

方式二：PowerShell 原生部署

第一步：安装 Node.js 22+

第二步：验证 Node.js 安装

第三步：以管理员身份安装 OpenClaw

第四步：解决安装权限问题

Linux 本地部署

系统要求

安装步骤

第一步：安装 Node.js

第二步：安装 OpenClaw

第三步：验证安装

第四步：初始化配置

云端一键部署

为什么选择云端部署？

方案对比

腾讯云 Lighthouse 部署（推荐）

第一步：购买服务器

第二步：连接服务器

第三步：配置大模型

第四步：测试连接

火山引擎部署（更便宜）

百度智能云部署（0.01 元试用）

国内一键安装（推荐）

前置要求

快速开始

macOS/Linux 安装

Windows 安装

运行入门向导

启动 Gateway

Cloudflare Workers 部署（进阶）

为什么选择 Cloudflare Workers？

前置要求

部署流程

第一步：一键部署 Moltworker

第二步：等待构建

第三步：配置 Access（Zero Trust）

第四步：配置 R2 对象存储

第五步：注入变量并重启

Docker 部署（可选）

为什么选择 Docker？

前置要求

快速开始

方式一：一键脚本部署（推荐新手）

方式二：手动 Docker Compose 部署

API 配置指南

为什么需要 API？

API 模型分类

1. 内置 API 模型（推荐新手）

2. 自定义 API（进阶用户）

配置方式对比

推荐配置：Kimi 2.5