一、前言
OpenClaw(原Clawdbot/Moltbot)作为2026年爆火的开源AI智能体框架,凭借本地优先架构、全渠道通信能力与持久记忆特性,成为个人与中小企业搭建专属AI助理的首选工具。本文聚焦新手零基础场景,完整覆盖2026年阿里云轻量服务器部署(7×24小时稳定运行)、本地MacOS/Linux/Windows11部署(隐私优先),以及MiniMax、Claude、阿里云百炼(通义千问) 三大免费模型的详细配置流程,全程附带可直接复制的代码命令,针对部署、配置、运行全流程中的常见问题提供解决方案,5分钟即可完成从环境搭建到模型调用的全链路落地。
二、核心概念与前置准备
1. 核心架构
OpenClaw本身不具备大模型推理能力,需搭配外部大模型作为“核心大脑”,其核心架构包括:
- 基础设施层:阿里云轻量服务器/本地设备(提供运行环境)
- 框架层:OpenClaw(负责任务调度、技能管理、模型对接)
- 模型层:MiniMax、Claude、阿里云百炼(提供智能推理能力)
- 应用层:WebUI、终端、飞书/微信等通信渠道(用户交互入口)
- 阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

2. 环境与依赖要求
| 维度 | 具体配置 | 说明 |
|---|---|---|
| 硬件配置 | CPU≥2核、内存≥2GB(推荐4GB)、磁盘≥20GB | 阿里云轻量服务器最低配置要求,本地部署建议4GB内存,避免运行卡顿 |
| 操作系统 | 阿里云:Alibaba Cloud Linux 3.2104 LTS 本地:MacOS 12+、Linux(Ubuntu 22.04+/CentOS 8+)、Windows11 64位 |
阿里云推荐官方镜像,本地系统需保证版本合规,避免依赖兼容问题 |
| 核心依赖 | Node.js≥22、Git、pnpm/npm(最新版) | OpenClaw 2026版本硬性要求,Node.js版本过低会导致安装失败 |
| 必备账号 | 阿里云账号(实名认证)、大模型平台账号(MiniMax/Claude/百炼) | 阿里云轻量服务器购买、百炼大模型服务开通均需实名认证,无认证无法完成配置 |
3. 关键工具与凭证准备
- 终端工具:MacOS/Linux使用系统终端,Windows使用PowerShell(管理员身份)
- 远程工具:阿里云轻量服务器使用SSH连接(推荐FinalShell,新手友好)
- 凭证信息:阿里云百炼API Key、MiniMax API Key、Claude API Key、服务器登录密码/密钥
- 网络配置:阿里云服务器需放行对应端口,本地部署保证网络稳定,避免依赖下载失败
三、新手零基础阿里云轻量服务器部署OpenClaw简单步骤及避坑指南
阿里云轻量服务器部署适合7×24小时运行、公网访问、团队共享场景,提供一键镜像部署(新手首选)与手动命令部署(开发者自定义)两种方案,5分钟即可完成基础搭建。
方案一:一键镜像部署(零基础推荐)
步骤1:购买阿里云轻量服务器
- 登录阿里云控制台,搜索「轻量应用服务器」,进入购买页面。
- 核心配置选择:
- 地域:优先选择中国香港(免备案、网络更稳定),无特殊需求可选北京/上海等国内地域。
- 实例规格:基础场景选2核4GB、40GB ESSD系统盘、5Mbps带宽;复杂场景(多插件、高并发)选4核8GB及以上。
- 镜像:选择「应用镜像」→「OpenClaw 2026官方稳定版」(已预装Node.js 22、Git、pnpm等依赖,无需手动配置环境)。
- 登录方式:设置root密码(务必牢记,用于SSH登录),购买时长(测试选1个月,长期使用选1年)。
- 确认订单并支付,等待实例状态变为「运行中」(约5-10分钟)。
零基础部署 OpenClaw 喂饭级步骤流程
第一步:点击打开访问阿里云OpenClaw一键部署专题页面。




第二步:打开选择阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:打开访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
阿里云百炼Coding Plan API-Key 获取、配置保姆级教程:
创建API-Key,推荐访问订阅阿里云百炼Coding Plan,阿里云百炼Coding Plan每天两场抢购活动,从按tokens计费升级为按次收费,可以进一步节省费用!
- 购买后,在控制台生成API Key。注:这里复制并保存好你的API Key,后面要用。

- 回到轻量应用服务器-控制台,单击服务器卡片中的实例 ID,进入服务器概览页。

- 在服务器概览页面单击应用详情页签,进入服务器详情页面。

- 端口放通在OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw 服务运行端口的防火墙。

- 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key,直接选择就可以。

- 获取访问地址单击访问 Web UI 面板下的执行命令,获取 OpenClaw WebUI 的地址。


步骤2:防火墙端口放行(避坑点1:端口未放行导致无法访问)
- 进入轻量应用服务器控制台,找到目标实例,点击实例ID进入详情页。
- 点击「防火墙」页签,在「端口规则」区域,点击「添加规则」,依次放行以下端口:
- 18789(OpenClaw网关端口)
- 随机端口(OpenClaw初始化时自动生成,后续可通过命令查看)
- 也可点击「一键放通」,系统自动放行OpenClaw所需全部端口,避免遗漏。
步骤3:远程登录服务器(避坑点2:SSH连接失败)
- 打开FinalShell,点击「新建连接」→「SSH连接」,填写公网IP、用户名(root)、密码,点击连接。
- 若连接失败,检查以下几点:
- 服务器实例状态是否为「运行中」
- 防火墙是否放行22端口(SSH默认端口)
- 登录密码是否正确,可在阿里云控制台重置密码
步骤4:初始化OpenClaw与模型配置
- 执行初始化命令(避坑点3:内存不足导致初始化失败):
# 进入OpenClaw安装目录(官方默认路径) cd /opt/openclaw # 国内镜像加速,避免依赖下载缓慢 npm config set registry https://registry.npmmirror.com # 非交互式初始化,自动配置基础环境 openclaw init --non-interactive --accept-risk --enable-skill-market - 启动服务并安装为系统服务(避坑点4:服务未开机自启导致重启后失效):
# 启动网关服务 openclaw gateway start # 安装为系统服务,实现开机自启 openclaw gateway install # 查看服务状态,确认运行正常 openclaw gateway status - 获取WebUI访问地址并验证:
复制输出的地址(格式:# 获取OpenClaw WebUI地址 openclaw webui get-urlhttp://服务器公网IP:随机端口),在浏览器访问,输入Token(可在「应用详情」→「基础配置」→「查看Token」中获取),进入OpenClaw面板,发送测试指令(如「生成一段Python代码」),验证部署成功。
方案二:手动命令部署(开发者自定义)
若已购买阿里云轻量服务器(未预装OpenClaw镜像),可通过手动命令部署,步骤如下(避坑点5:依赖安装失败):
# 1. SSH登录服务器
ssh root@服务器公网IP
# 2. 安装系统依赖(Alibaba Cloud Linux)
yum install -y curl git gcc make
# 3. 安装Node.js 22(使用nvm管理版本,避免系统版本冲突)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# 配置国内npm镜像,加速依赖下载
npm config set registry https://registry.npmmirror.com
# 4. 安装OpenClaw(全局安装)
npm install -g openclaw --unsafe-perm=true --allow-root --no-optional --omit=dev --ignore-scripts
# 5. 初始化OpenClaw(安装为系统服务,开机自启)
openclaw onboard --install-daemon
# 按提示选择:风险确认(Yes)、启动模式(QuickStart)、AI提供商(后续配置)
# 6. 启动核心服务
openclaw gateway start
openclaw dashboard start
# 7. 放行端口(手动配置防火墙)
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
# 8. 查看服务状态,确认运行正常
openclaw gateway status
openclaw dashboard status
- 后续模型配置步骤与方案一一致,直接执行对应配置命令即可。
阿里云部署避坑指南
| 常见问题 | 表现 | 解决方案 |
|---|---|---|
| 内存不足 | 初始化时卡顿、进程崩溃 | 1. 配置4GB Swap内存 2. 升级服务器内存至4GB 3. 安装时添加--no-optional --omit=dev参数跳过可选依赖 |
| 端口未放行 | WebUI无法访问、网关启动失败 | 1. 一键放通OpenClaw所需端口 2. 手动添加18789端口规则 3. 检查服务器安全组配置 |
| 依赖下载缓慢 | npm安装超时、依赖缺失 | 1. 配置国内npm镜像(npmmirror.com) 2. 使用国内安装脚本 3. 更换网络环境 |
| 服务未自启 | 服务器重启后OpenClaw无法访问 | 1. 执行openclaw gateway install安装为系统服务 2. 使用pm2守护进程(npm install -g pm2 && pm2 start openclaw -- gateway) |
| API调用失败 | 模型无响应、提示权限不足 | 1. 核对API Key与BaseURL是否正确 2. 检查模型服务是否已开通 3. 确认账号有足够额度 |
四、本地MacOS/Linux/Windows11部署OpenClaw步骤
本地部署适合个人使用、数据隐私优先场景,提供一键脚本部署(零配置)与手动部署(自定义环境)两种方案,适配不同技术基础用户。
1. MacOS系统部署
方案A:一键脚本部署(推荐)
# 1. 安装Homebrew(若未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 执行官方一键安装脚本(自动安装Node.js 22、Git、OpenClaw)
curl -fsSL https://openclaw.ai/install.sh | bash
# 国内网络若下载缓慢,使用国内镜像脚本
# curl -fsSL https://clawd.org.cn/install.sh | bash
# 3. 初始化OpenClaw配置
openclaw onboard --install-daemon
# 按提示完成配置:选择网关类型(本地)、AI提供商(后续配置)、安装守护进程(Yes)
# 4. 启动服务
openclaw gateway start
openclaw dashboard start
# 5. 验证部署
openclaw status
# 浏览器访问 http://localhost:随机端口,输入Token,进入WebUI
方案B:手动部署(已有Node.js环境)
# 1. 确认Node.js版本≥22
node -v # 输出版本号需≥22,否则使用nvm升级
nvm install 22
nvm use 22
# 2. 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 3. 安装OpenClaw
npm install -g openclaw
# 4. 初始化与启动(同方案A)
openclaw onboard --install-daemon
openclaw gateway start
openclaw dashboard start
2. Linux系统部署(Ubuntu/Debian/CentOS)
方案A:一键脚本部署(推荐)
# 1. Ubuntu/Debian系统
sudo apt update && sudo apt install -y curl git
# 2. 执行一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 国内镜像:curl -fsSL https://clawd.org.cn/install.sh | bash
# 3. 初始化与启动
openclaw onboard --install-daemon
openclaw gateway start
openclaw dashboard start
方案B:手动部署
# 1. 安装依赖
# Ubuntu/Debian
sudo apt install -y curl git gcc make
# CentOS
sudo yum install -y curl git gcc make
# 2. 安装Node.js 22
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# 3. 安装OpenClaw并启动
npm install -g openclaw
openclaw onboard --install-daemon
openclaw gateway start
3. Windows11系统部署(管理员权限)
方案A:PowerShell一键部署(推荐)
# 1. 解锁PowerShell执行权限
Set-ExecutionPolicy Bypass -Scope Process -Force
# 2. 执行官方一键安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex
# 国内网络若超时,使用国内镜像脚本
# iwr -useb https://clawd.org.cn/install.ps1 | iex
# 3. 初始化配置
openclaw onboard --install-daemon
# 按提示选择:同意风险、启动模式、AI提供商(后续配置)
# 4. 启动服务
openclaw gateway start
openclaw dashboard start
# 5. 验证部署
# 浏览器访问 http://localhost:随机端口,输入Token,进入WebUI
方案B:手动部署(已有Node.js环境)
- 下载安装Node.js≥22(https://nodejs.org/),勾选「Add to PATH」,重启PowerShell。
- 安装OpenClaw:
npm install -g openclaw - 初始化与启动(同PowerShell一键部署)。
五、MiniMax、Claude、阿里云百炼免费模型配置(全平台通用)
OpenClaw支持多模型灵活切换,以下是三大免费模型的详细配置流程,全程附带可复制命令。
1. 阿里云百炼(通义千问)配置(国内首选,中文友好)
步骤1:获取百炼API Key
- 访问登录阿里云百炼大模型服务平台,登录阿里云账号(需实名认证)。
- 进入「API-KEY管理」页面,点击「创建API-KEY」,输入名称(如「OpenClaw百炼配置」),点击确定。
- 系统生成API Key(格式:sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx),点击「复制」,妥善保存(仅显示一次,丢失需重新创建)。
- 开通对应模型服务:在「模型广场」选择「通义千问3.5 Plus」等模型,开通服务(2026年新用户有免费额度,可免费使用)。
步骤2:配置命令
# 1. 配置百炼API Key
openclaw config set providers.bailian.apiKey "你的百炼API Key"
# 2. 配置百炼API基础地址
openclaw config set providers.bailian.baseUrl "https://bailian.aliyuncs.com/v1"
# 3. 设置默认模型为通义千问3.5 Plus
openclaw config set models.default "bailian/qwen3.5-plus"
# 4. 重启网关使配置生效
openclaw gateway restart
步骤3:验证配置
# 发送测试请求
openclaw chat "你好,我是OpenClaw用户"
若返回正常响应,说明百炼模型配置成功。
2. MiniMax模型配置(免费额度高,支持长文本)
步骤1:获取MiniMax API Key
- 访问MiniMax官网(
https://minimax.chat/),注册并登录账号。 - 进入「控制台」→「API密钥」页面,点击「创建密钥」,复制生成的API Key。
步骤2:配置命令
# 1. 配置MiniMax API Key
openclaw config set providers.minimax.apiKey "你的MiniMax API Key"
# 2. 配置MiniMax API基础地址
openclaw config set providers.minimax.baseUrl "https://api.minimax.chat/v1"
# 3. 设置默认模型为MiniMax 3.5
openclaw config set models.default "minimax/abab5.5-chat"
# 4. 重启网关使配置生效
openclaw gateway restart
步骤3:验证配置
openclaw chat "生成一段关于人工智能的短文"
若返回正常响应,说明MiniMax模型配置成功。
3. Claude模型配置(免费额度,支持复杂推理)
步骤1:获取Claude API Key
- 访问Anthropic官网(
https://www.anthropic.com/),注册并登录账号。 - 进入「API Keys」页面,点击「Create Key」,复制生成的API Key。
步骤2:配置命令
# 1. 配置Claude API Key
openclaw config set providers.anthropic.apiKey "你的Claude API Key"
# 2. 配置Claude API基础地址
openclaw config set providers.anthropic.baseUrl "https://api.anthropic.com/v1"
# 3. 设置默认模型为Claude 3 Sonnet
openclaw config set models.default "anthropic/claude-3-sonnet-20240229"
# 4. 重启网关使配置生效
openclaw gateway restart
步骤3:验证配置
openclaw chat "解释量子计算的基本原理"
若返回正常响应,说明Claude模型配置成功。
4. 模型切换命令(灵活适配不同场景)
# 切换为百炼模型
openclaw config set models.default "bailian/qwen3.5-plus" && openclaw gateway restart
# 切换为MiniMax模型
openclaw config set models.default "minimax/abab5.5-chat" && openclaw gateway restart
# 切换为Claude模型
openclaw config set models.default "anthropic/claude-3-sonnet-20240229" && openclaw gateway restart
六、常见问题解答(全平台通用)
1. Node.js版本过低
问题:安装OpenClaw时提示“Node.js version not supported”
解决方案:
# Mac/Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# Windows
winget install OpenJS.NodeJS.22
# 或手动下载安装包(https://nodejs.org/)
2. 内存不足导致进程崩溃
问题:初始化时卡顿、服务启动后自动退出
解决方案:
# 配置4GB Swap内存(Linux/MacOS)
fallocate -l 4G ~/swapfile
chmod 600 ~/swapfile
sudo mkswap ~/swapfile
sudo swapon ~/swapfile
echo "$HOME/swapfile none swap sw 0 0" | sudo tee -a /etc/fstab
# 安装时跳过可选依赖
npm install -g openclaw --no-optional --omit=dev
3. 模型调用无响应
问题:发送指令后模型长时间无回复、提示“API request failed”
解决方案:
- 核对API Key与BaseURL是否正确:
openclaw config get providers.bailian.apiKey openclaw config get providers.bailian.baseUrl - 检查模型服务是否已开通,账号是否有足够额度。
- 重启网关:
openclaw gateway restart
4. WebUI无法访问
问题:浏览器输入地址后无法加载、提示“连接超时”
解决方案:
- 检查网关是否正常运行:
openclaw gateway status - 确认端口已放行(阿里云服务器需检查防火墙,本地部署需关闭杀毒软件)。
- 重新获取WebUI地址:
openclaw webui get-url
5. 服务重启后失效
问题:服务器/本地设备重启后OpenClaw无法访问
解决方案:
# 安装为系统服务(全平台通用)
openclaw gateway install
# 或使用pm2守护进程(推荐)
npm install -g pm2
pm2 start openclaw -- gateway
pm2 save && pm2 startup
七、总结
本文详细介绍了2026年OpenClaw在阿里云轻量服务器与本地多系统的部署流程,以及MiniMax、Claude、阿里云百炼三大免费模型的配置方法,针对新手常见问题提供了避坑指南与解决方案。通过阿里云部署可实现7×24小时稳定运行,本地部署则兼顾隐私与灵活性,用户可根据自身需求选择合适方案。后续可进一步探索OpenClaw的技能市场、任务调度等高级功能,打造专属AI助理,提升工作效率。