【OpenClaw：实战部署】5、全平台部署OpenClaw（Win/Mac/Linux/云服务器）——10分钟跑通第一个本地AI智能体

【保姆级教程】全平台部署OpenClaw（Win/Mac/Linux/云服务器）------10分钟跑通第一个本地AI智能体

一句话导读：无论你是Windows用户、Mac爱好者，还是Linux开发者，甚至想在云服务器上7×24小时运行AI智能体，本文都能带你用10分钟完成OpenClaw全平台部署，跑通第一个本地AI指令，告别陪聊机器人，真正拥有"动手能力"。

引言：本地部署 vs 云端部署的核心差异

2026年，OpenClaw（原Clawdbot）凭借跨平台适配性、灵活的技能扩展体系，已成为开源AI Agent领域的热门工具，在GitHub下载排行已攀升至第11位。但在开始部署前，我们需要先搞清楚一个问题：到底选择本地部署，还是云端部署？

这两种方案的核心差异体现在三个维度：
云端部署
本地部署
对比维度
隐私安全
成本结构
稳定性
数据完全本地存储

无泄露风险
零服务器费用

仅需硬件投入
依赖本地设备

关机即停止
数据上传至云端

需信任云厂商
按需付费/包年包月

长期运行成本可控
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），执行以下命令验证现有环境：

bash 复制代码

# 检查Node.js版本
node --version
# 预期输出：v22.x.x（如v22.5.1）

# 检查npm版本
npm --version
# 预期输出：10.x.x

# 检查Python版本
python --version  # Windows
python3 --version # Mac/Linux
# 预期输出：Python 3.9.x 或更高

# 检查Git版本
git --version
# 预期输出：git version 2.40.x

如果版本不达标或提示"命令未找到"，别担心，下一节会详细讲解各平台的安装方法。

核心凭证准备

OpenClaw本身不具备大模型推理能力，需要对接大模型API。推荐使用阿里云百炼，因为它针对国内网络优化，且有免费额度：

注册阿里云账号并完成实名认证
访问阿里云百炼控制台
在「密钥管理」中点击「创建API-Key」
复制保存生成的API-Key（注意：离开页面后将无法再次查看）

准备流程
注册阿里云账号
完成实名认证
开通百炼服务
创建API-Key
保存密钥至加密记事本

二、分平台部署步骤

2.1 Windows部署（PowerShell）

Windows用户推荐使用PowerShell（管理员模式）进行安装，所有命令均可直接复制执行。

步骤1：以管理员身份打开PowerShell

右键点击开始菜单，选择「Windows PowerShell（管理员）」或「终端（管理员）」。

步骤2：解锁脚本执行策略

powershell 复制代码

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

这一步允许运行本地脚本，避免后续命令被拦截。

步骤3：安装Node.js 22.x

powershell 复制代码

# 下载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：验证安装

powershell 复制代码

node --version
npm --version

应显示v22.x.x和对应npm版本。

步骤5：配置npm国内镜像（加速技能安装）

powershell 复制代码

npm config set registry https://registry.npmmirror.com

步骤6：全局安装OpenClaw

powershell 复制代码

npm install -g openclaw@latest

步骤7：初始化配置

powershell 复制代码

# 创建工作目录
mkdir ~/OpenClaw-Workspace -Force
cd ~/OpenClaw-Workspace

# 初始化配置，按提示输入阿里云百炼API-Key
openclaw init

初始化过程中，系统会提示输入API-Key，粘贴之前保存的密钥即可。

步骤8：启动网关服务

powershell 复制代码

# 前台启动（测试用）
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可跳过）

bash 复制代码

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

步骤3：安装Node.js 22.x

macOS用户：

bash 复制代码

brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux用户（Ubuntu/Debian）：

bash 复制代码

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs

步骤4：安装Git和Python（如未安装）

bash 复制代码

# Ubuntu/Debian
sudo apt install -y git python3 python3-pip

# macOS（已通过Homebrew安装）
brew install git python@3.11

步骤5：配置国内镜像（可选，加速安装）

bash 复制代码

npm config set registry https://registry.npmmirror.com
pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

步骤6：验证安装

bash 复制代码

node --version
npm --version
python3 --version
git --version

步骤7：全局安装OpenClaw

bash 复制代码

npm install -g openclaw@latest

步骤8：初始化配置

bash 复制代码

mkdir -p ~/OpenClaw-Workspace
cd ~/OpenClaw-Workspace
openclaw init

按提示输入阿里云百炼API-Key。

步骤9：启动网关服务

bash 复制代码

# 前台启动
openclaw gateway start

# 或后台启动（关闭终端后继续运行）
nohup openclaw gateway start &

# 查看运行状态
ps aux | grep openclaw

步骤10：配置开机自启（Linux systemd）

bash 复制代码

# 安装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登录服务器

bash 复制代码

ssh root@你的服务器公网IP

步骤4：安装依赖

bash 复制代码

# 更新系统
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

bash 复制代码

npm install -g openclaw@latest

步骤6：初始化配置

bash 复制代码

mkdir ~/OpenClaw-Workspace && cd ~/OpenClaw-Workspace
openclaw init

按提示输入API-Key，其他选项可保持默认。

步骤7：配置持久化存储（可选但推荐）

为防止服务器重启后配置丢失，建议挂载云盘保存配置文件和技能数据：

bash 复制代码

# 查看磁盘
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：设置开机自启

bash 复制代码

# 安装systemd服务
openclaw daemon install

# 启动服务
systemctl start openclaw

# 设置开机自启
systemctl enable openclaw

# 查看状态
systemctl status openclaw

步骤9：生成访问Token

bash 复制代码

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服务浏览器用户文件管理技能模型API Gateway服务浏览器用户输入"列出桌面文件" 发送HTTP请求解析意图调用百炼API 确认用户意图返回意图识别结果触发文件管理技能返回桌面文件列表格式化输出结果显示文件列表

四、常见问题排查

4.1 端口占用问题

现象：启动Gateway时报错Error: listen EADDRINUSE: address already in use :::18789

解决方法：

bash 复制代码

# Windows（PowerShell）
netstat -ano | findstr 18789
# 找到占用端口的PID，然后
taskkill /PID 占用端口的PID /F

# Mac/Linux
lsof -i :18789
kill -9 占用端口的PID

4.2 Node版本过低

现象：安装OpenClaw时报错，或启动后功能异常

解决方法（使用nvm管理多版本）：

bash 复制代码

# 安装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无效或已过期
网络无法访问模型服务
阿里云账号余额不足

解决方法：

bash 复制代码

# 检查当前配置的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执行策略问题

现象：运行脚本时报错"无法加载文件，因为在此系统上禁止运行脚本"

解决方法：

powershell 复制代码

# 查看当前执行策略
Get-ExecutionPolicy

# 修改为RemoteSigned（允许本地脚本）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

五、部署优化

5.1 开机自启配置

Windows ：

创建开机启动任务：

powershell 复制代码

# 创建启动脚本
$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方式）：

bash 复制代码

# 确保daemon已安装并启用
sudo systemctl enable openclaw
sudo systemctl start openclaw

5.2 日志持久化

默认日志保存在内存中，重启会丢失。配置持久化：

bash 复制代码

# 创建日志目录
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限制：

bash 复制代码

# 创建cgroup
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能力：

bash 复制代码

# 列出所有可用技能
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真正成为你的"数字员工"。

如果你在部署过程中遇到其他问题，欢迎在评论区留言交流。下一篇文章，我们将深入讲解如何开发自己的第一个OpenClaw技能，敬请期待！