引言
本地部署 vs 云端部署的核心差异
2026 年，OpenClaw（原 Clawdbot）凭借跨平台适配性、灵活的技能扩展体系，已成为开源 AI Agent 领域的热门工具。但在开始部署前，我们需要先搞清楚一个问题：到底选择本地部署，还是云端部署？
这两种方案的核心差异体现在三个维度：
| 对比维度 | 云端部署 | 本地部署 |
|---|---|---|
| 隐私安全 | 数据上传至云端，需信任云厂商 | 数据完全本地存储，无泄露风险 |
| 成本结构 | 按需付费/包年包月，长期运行成本可控 | 零服务器费用，仅需硬件投入 |
| 稳定性 | 7×24 小时不间断，专业运维保障 | 依赖本地设备，关机即停止 |
选型建议
根据实际需求，可以参考以下选择逻辑：
- 个人轻量使用、数据敏感场景：选本地部署（Win/Mac/Linux），零成本、隐私可控，适合测试和日常办公
- 7×24 小时自动化任务、多设备远程访问：选云服务器部署，依托云厂商的 SLA 保障，让 AI 智能体永远在线
- 新手入门、不想折腾环境：首选阿里云一键部署方案，15 分钟内完成，全程可视化操作
一、环境前置准备
无论选择哪种部署方式，OpenClaw 都依赖以下核心环境。在开始之前，请先检查你的设备是否达标。
版本要求
| 组件 | 最低版本 | 作用 |
|---|---|---|
| Node.js | 22.x+ | OpenClaw 核心运行环境 |
| Python | 3.9+ | 部分技能脚本依赖 |
| Docker | 20.10+（可选） | 容器化运行技能 |
| Git | 2.40+ | 技能安装与版本管理 |
依赖检查
打开终端（Windows 用户打开 PowerShell），执行以下命令验证现有环境：
# 检查 Node.js 版本
node --version
# 预期输出：v22.x.x（如 v22.5.1）
# 检查 npm 版本
npm --version
# 预期输出：10.x.x
# 检查 Python 版本
python --version
# Windows: python3 --version
# Mac/Linux: python3 --version
# 预期输出：Python 3.9.x 或更高
# 检查 Git 版本
git --version
# 预期输出：git version 2.40.x
如果版本不达标或提示'命令未找到'，别担心，下一节会详细讲解各平台的安装方法。
核心凭证准备
OpenClaw 本身不具备大模型推理能力，需要对接大模型 API。推荐使用阿里云百炼，因为它针对国内网络优化，且有免费额度：
- 注册阿里云账号并完成实名认证
- 访问 阿里云百炼控制台
- 在「密钥管理」中点击「创建 API-Key」
- 复制保存生成的 API-Key（注意：离开页面后将无法再次查看）
二、分平台部署步骤
2.1 Windows 部署（PowerShell）
Windows 用户推荐使用 PowerShell（管理员模式）进行安装，所有命令均可直接复制执行。
步骤 1：以管理员身份打开 PowerShell
右键点击开始菜单，选择「Windows PowerShell（管理员）」或「终端（管理员）」。
步骤 2：解锁脚本执行策略
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force
这一步允许运行本地脚本，避免后续命令被拦截。
步骤 3：安装 Node.js 22.x
# 下载 Node.js 安装包（国内镜像加速）
iwr -useb https://npmmirror.com/mirrors/node/v22.10.0/node-v22.10.0-x64.msi -OutFile node-install.msi
# 静默安装（自动添加 PATH）
Start-Process .\node-install.msi -ArgumentList "/quiet InstallAllUsers=1 PrependPath=1" -Wait
# 刷新环境变量
refreshenv
步骤 4：验证安装
node --version
npm --version
应显示 v22.x.x 和对应 npm 版本。
步骤 5：配置 npm 国内镜像（加速技能安装）
npm config set registry https://registry.npmmirror.com
步骤 6：全局安装 OpenClaw
npm install -g openclaw@latest
步骤 7：初始化配置
# 创建工作目录
mkdir ~/OpenClaw-Workspace -Force
cd ~/OpenClaw-Workspace
# 初始化配置，按提示输入阿里云百炼 API-Key
openclaw init
初始化过程中，系统会提示输入 API-Key，粘贴之前保存的密钥即可。
步骤 8：启动网关服务
# 前台启动（测试用）
openclaw gateway start
# 或后台启动（关闭终端后继续运行）
Start-Job -ScriptBlock { openclaw gateway start }
2.2 macOS/Linux 部署（Bash）
macOS（12+）和 Linux（Ubuntu 20.04+）命令基本通用，以下以 Bash 为例。
步骤 1：打开终端
macOS 用户可在启动台搜索「终端」，Linux 用户使用 Ctrl+Alt+T 快捷键。
步骤 2：安装 Homebrew（macOS 必备，Linux 可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
步骤 3：安装 Node.js 22.x
macOS 用户：
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Linux 用户（Ubuntu/Debian）：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs
步骤 4：安装 Git 和 Python（如未安装）
# Ubuntu/Debian
sudo apt install -y git python3 python3-pip
# macOS（已通过 Homebrew 安装）
brew install git [email protected]
步骤 5：配置国内镜像（可选，加速安装）
npm config set registry https://registry.npmmirror.com
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
步骤 6：验证安装
node --version
npm --version
python3 --version
git --version
步骤 7：全局安装 OpenClaw
npm install -g openclaw@latest
步骤 8：初始化配置
mkdir -p ~/OpenClaw-Workspace
cd ~/OpenClaw-Workspace
openclaw init
按提示输入阿里云百炼 API-Key。
步骤 9：启动网关服务
# 前台启动
openclaw gateway start
# 或后台启动（关闭终端后继续运行）
nohup openclaw gateway start &
# 查看运行状态
ps aux | grep openclaw
步骤 10：配置开机自启（Linux systemd）
# 安装 systemd 服务
sudo openclaw daemon install
# 启动服务
sudo systemctl start openclaw
# 设置开机自启
sudo systemctl enable openclaw
# 查看状态
sudo systemctl status openclaw
这样配置后，OpenClaw 会作为系统服务在后台运行，服务器重启后自动启动。
2.3 云服务器部署（阿里云/腾讯云）
云服务器部署是最省心的方案，尤其适合需要 7×24 小时运行的场景。以阿里云为例，有两种主流方式。
方式一：轻量应用服务器一键部署（新手首选）
这是官方主推的入门方式，通过预置镜像实现可视化一键部署，无需手动敲命令。
- 访问 OpenClaw 一键部署专题页
- 点击一键购买并部署
- 配置服务器参数
- 选择 OpenClaw 镜像
- 支付完成等待创建
- 前往百炼控制台创建 API-Key
- 在实例详情页一键配置 API-Key
- 生成访问 Token
- 点击打开网站页面
- 部署完成！
详细步骤：
- 访问部署专题：打开阿里云 OpenClaw 一键部署专题页面，点击「一键购买并部署」
- 配置服务器参数：
- 镜像：选择「OpenClaw(Moltbot) 镜像」（应用镜像分类下）
- 实例规格：2 核 2GB 内存及以上（个人使用足够）
- 地域：推荐选择中国香港或新加坡（免备案，联网搜索功能正常）
- 时长：按需选择（测试可选 1 个月，长期建议包年）
- 支付并等待：支付完成后等待 1-3 分钟，实例状态变为「运行中」
- 配置 API-Key：
- 进入实例详情页的「应用详情」
- 点击「一键配置」，粘贴之前获取的阿里云百炼 API-Key
- 点击「执行命令」，系统自动写入配置
- 生成访问 Token：
- 在应用详情页继续操作
- 点击「执行命令」生成访问 Token
- 复制保存 Token（登录 Web 控制台必需）
- 访问控制台：点击「打开网站页面」，输入 Token 即可进入 OpenClaw 对话界面
方式二：手动部署（ECS + Ubuntu）
如果你已有云服务器，或需要更高自由度，可以手动部署。
步骤 1：选购服务器
- 系统镜像：Ubuntu 22.04 LTS
- 配置建议：2 核 4GB 内存（多技能并发建议 4 核 8GB）
- 地域：中国香港（免备案）或国内地域（需备案）
- 带宽：3Mbps 以上
步骤 2：安全组配置
放行以下核心端口：
| 端口 | 协议 | 用途 | 授权对象 |
|---|---|---|---|
| 22 | TCP | SSH 远程连接 | 你的公网 IP |
| 18789 | TCP | OpenClaw 控制台 | 0.0.0.0/0 |
| 443 | TCP | API 调用 | 0.0.0.0/0 |
| 8080 | TCP | WebSocket 通信 | 0.0.0.0/0（如需） |
步骤 3：SSH 登录服务器
ssh root@你的服务器公网IP
步骤 4：安装依赖
# 更新系统
apt update && apt upgrade -y
# 安装核心工具
apt install -y curl git python3 python3-pip ufw
# 安装 Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | bash
apt install -y nodejs
# 配置国内镜像
npm config set registry https://registry.npmmirror.com
# 验证安装
node --version
步骤 5：安装 OpenClaw
npm install -g openclaw@latest
步骤 6：初始化配置
mkdir ~/OpenClaw-Workspace && cd ~/OpenClaw-Workspace
openclaw init
按提示输入 API-Key，其他选项可保持默认。
步骤 7：配置持久化存储（可选但推荐）
为防止服务器重启后配置丢失，建议挂载云盘保存配置文件和技能数据：
# 查看磁盘
fdisk -l
# 挂载数据盘（假设新盘为/dev/vdb1）
mkdir /data
mount /dev/vdb1 /data
# 迁移 OpenClaw 配置
cp -r ~/.openclaw /data/
ln -s /data/.openclaw ~/.openclaw
# 设置开机自动挂载（编辑/etc/fstab）
echo '/dev/vdb1 /data ext4 defaults 0 0' >> /etc/fstab
步骤 8：设置开机自启
# 安装 systemd 服务
openclaw daemon install
# 启动服务
systemctl start openclaw
# 设置开机自启
systemctl enable openclaw
# 查看状态
systemctl status openclaw
步骤 9：生成访问 Token
openclaw token generate
复制输出的 Token，访问 http://你的公网 IP:18789 时需输入。
三、首次启动验证
无论哪种部署方式，验证流程都类似。
3.1 访问 Web 控制台
打开浏览器，输入对应地址：
- 本地部署：
http://127.0.0.1:18789或http://localhost:18789 - 云服务器：
http://你的公网 IP:18789
首次访问会提示输入 Token，粘贴之前生成的 Token 即可进入控制台。
3.2 输入第一条测试指令
在对话框中输入：
列出桌面文件
如果配置正确，OpenClaw 会调用文件管理技能，返回你桌面上的文件列表。这证明：
- OpenClaw 服务正常运行
- 模型 API 配置正确
- 基础技能已生效
3.3 验证流程示意图
文件管理技能 -> 模型 API -> Gateway 服务 -> 浏览器 -> 用户 用户输入"列出桌面文件" -> 发送 HTTP 请求 -> 解析意图 -> 调用百炼 API -> 确认用户意图 -> 触发文件管理技能 -> 返回桌面文件列表 -> 格式化输出结果显示文件列表
四、常见问题排查
4.1 端口占用问题
现象：启动 Gateway 时报错 Error: listen EADDRINUSE: address already in use :::18789
解决方法：
# Windows（PowerShell）
netstat -ano | findstr 18789
# 找到占用端口的 PID，然后 taskkill /PID 占用端口的 PID /F
# Mac/Linux
lsof -i :18789
kill -9 占用端口的 PID
4.2 Node 版本过低
现象：安装 OpenClaw 时报错，或启动后功能异常
解决方法（使用 nvm 管理多版本）：
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 安装并使用 Node.js 22
nvm install 22
nvm use 22
# 验证版本
node --version
4.3 API-Key 连接超时
现象：发送指令后长时间无响应，或提示'模型调用失败'
原因分析：
- API-Key 无效或已过期
- 网络无法访问模型服务
- 阿里云账号余额不足
解决方法：
# 检查当前配置的 API-Key
openclaw config get model.aliyun_bailian.api_key
# 重新配置 API-Key
openclaw config set model.aliyun_bailian.api_key "你的新 API-Key"
# 配置代理（如需要）
openclaw config set http.proxy "http://127.0.0.1:7890"
# 重启服务
openclaw gateway restart
4.4 Windows PowerShell 执行策略问题
现象：运行脚本时报错'无法加载文件，因为在此系统上禁止运行脚本'
解决方法：
Get-ExecutionPolicy
# 修改为 RemoteSigned（允许本地脚本）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
五、部署优化
5.1 开机自启配置
Windows：
创建开机启动任务：
# 创建启动脚本
$action = New-ScheduledTaskAction -Execute "cmd.exe" -Argument "/c start /min openclaw gateway start"
$trigger = New-ScheduledTaskTrigger -AtStartup
$principal = New-ScheduledTaskPrincipal -UserId "SYSTEM" -LogonType ServiceAccount
Register-ScheduledTask -TaskName "OpenClawGateway" -Action $action -Trigger $trigger -Principal $principal
Mac/Linux（已在前文介绍 systemd 方式）：
# 确保 daemon 已安装并启用
sudo systemctl enable openclaw
sudo systemctl start openclaw
5.2 日志持久化
默认日志保存在内存中，重启会丢失。配置持久化：
# 创建日志目录
mkdir -p /var/log/openclaw
# 修改日志配置
openclaw config set log.dir /var/log/openclaw
openclaw config set log.level info
# 配置日志轮转（可选）
cat > /etc/logrotate.d/openclaw <<EOF
/var/log/openclaw/*.log {
daily
rotate 30
compress
delaycompress
missingok
notifempty
create 0640 root root
}
EOF
5.3 资源限制
为防止 OpenClaw 占用过多系统资源，可以配置 cgroup 限制：
# 创建 cgroups
sudo mkdir /sys/fs/cgroup/cpu/openclaw
sudo mkdir /sys/fs/cgroup/memory/openclaw
# 限制 CPU 为 0.5 核
echo 50000 | sudo tee /sys/fs/cgroup/cpu/openclaw/cpu.cfs_quota_us
# 限制内存为 1GB
echo 1073741824 | sudo tee /sys/fs/cgroup/memory/openclaw/memory.limit_in_bytes
# 将 OpenClaw 进程加入 cgroup
echo $(pgrep -f openclaw) | sudo tee /sys/fs/cgroup/cpu/openclaw/cgroup.procs
5.4 安装实用技能
部署完成后，可以安装常用技能增强 OpenClaw 能力：
# 列出所有可用技能
openclaw skills list
# 安装核心技能
openclaw skills install file-manager # 文件管理
openclaw skills install web-automation # 网页自动化
openclaw skills install summary # 内容总结
openclaw skills install scheduler # 定时任务
# 查看已安装技能
openclaw skills list --installed
# 重启服务使技能生效
openclaw gateway restart
结语
通过本文的教程，你应该已经成功在 Windows、macOS、Linux 或云服务器上部署了 OpenClaw，并跑通了第一条本地指令。从环境准备到分平台部署，从首次验证到问题排查，再到部署优化，我们覆盖了全流程的每一个细节。
记住，OpenClaw 的核心价值不在于'陪聊'，而在于通过 Skills 实现自然语言驱动的任务自动化。现在你已经拥有了一个 7×24 小时在线的 AI 智能体，接下来可以尝试安装更多技能、开发自定义技能，甚至搭建 Agent Swarm 多智能体团队，让 AI 真正成为你的'数字员工'。
