一、前言
2026年,OpenClaw(曾用名Clawdbot)已成为轻量化、可扩展、跨平台的AI智能体运行框架,支持本地运行与云端7×24小时在线,可对接各类交互渠道并调用大模型完成自动化任务。对于零基础用户,阿里云轻量应用服务器提供了开箱即用的官方镜像,无需复杂环境配置即可稳定运行;同时支持macOS、Linux、Windows 11全平台本地部署,满足不同使用场景。本文基于最新实践,完整提供阿里云轻量服务器部署流程、本地全平台安装步骤、阿里云千问大模型与免费Coding Plan模型配置、完整运维命令与常见问题解答,所有代码可直接复制执行,全程无门槛、无冗余操作。
二、部署前准备
2.1 必备条件
- 阿里云账号并完成实名认证
- 阿里云百炼平台获取:千问API Key(sk-开头)或Coding Plan API Key(sk-sp-开头)
- 服务器推荐配置:2核4GB内存、40GB云盘、5Mbps带宽
- 本地设备:内存≥4GB,系统为macOS 12+ / Ubuntu 20.04+ / Windows 11(WSL2)
- 必备依赖:Node.js 22及以上版本
- 阿里云部署 OpenClaw 全网最简单,只需两步,详情 访问阿里云OpenClaw一键部署专题页面 了解。




2.2 端口说明
OpenClaw默认使用18789端口提供Web控制台与服务接口,部署前后需确保端口未被占用、防火墙已放行。
三、阿里云轻量服务器部署OpenClaw(2026零基础版)
步骤1:创建轻量应用服务器实例
- 登录阿里云控制台,进入轻量应用服务器
- 点击创建实例,选择应用镜像,搜索并选择OpenClaw(Clawdbot)2026稳定版
- 规格选择:2核4GB + 40GB ESSD + 5Mbps
- 地域优先选择:中国香港、新加坡、美国弗吉尼亚
- 设置登录密码,完成购买并等待实例启动
零基础部署 OpenClaw 喂饭级步骤流程
第一步:点击打开访问阿里云OpenClaw一键部署专题页面。
阿里云OpenClaw一键部署专题页面:https://www.aliyun.com/activity/ecs/clawdbot




第二步:打开选择阿里云轻量应用服务器,配置参考如下:
- 镜像: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:放行防火墙端口(必做)
- 进入实例详情 → 防火墙 → 添加规则
- 放行TCP端口:18789,来源0.0.0.0/0
- 也可通过命令行放行(远程连接后执行)
sudo firewall-cmd --permanent --add-port=18789/tcp sudo firewall-cmd --reload sudo firewall-cmd --list-ports
步骤3:初始化与启动OpenClaw
通过Workbench或SSH登录服务器,依次执行以下命令:
# 进入安装目录
cd /opt/openclaw
# 配置国内镜像加速
npm config set registry https://registry.npmmirror.com
# 一键初始化
openclaw init --non-interactive --accept-risk
# 安装系统服务并开机自启
openclaw gateway install
# 后台启动服务
openclaw gateway start --daemon
# 查看运行状态
openclaw gateway status
步骤4:访问Web控制台
http://你的公网IP:18789
如需Token,执行以下命令生成:
openclaw token generate --admin --allow-ip 0.0.0.0/0
阿里云轻量服务器避坑指南
- 内存不足导致服务崩溃:最低必须使用2核4GB,不建议2核2GB
- 端口未放行无法访问面板:必须放行18789
- 服务未后台运行:必须加
--daemon参数 - 地域不匹配导致模型调用失败:海外地域使用国际版百炼地址
- 命令不存在:执行
source /etc/profile或重新配置PATH - 服务器重启后服务失效:必须执行
openclaw gateway install设置自启
四、本地全平台部署OpenClaw(macOS / Linux / Windows11)
4.1 macOS 部署
# 安装命令行工具
xcode-select --install
# 安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装Node.js 22
brew install node@22
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
# 初始化并后台启动
openclaw onboard --install-daemon
openclaw gateway start --daemon
4.2 Linux(Ubuntu/Debian)部署
sudo apt update
sudo apt install -y curl git
# 安装Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs
# 安装OpenClaw
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
# 初始化
openclaw onboard --install-daemon
# 放行端口
sudo ufw allow 18789/tcp
# 启动服务
openclaw gateway start --daemon
4.3 Windows11 部署(WSL2 官方推荐)
以管理员身份打开PowerShell:
wsl --install
wsl --set-default-version 2
重启电脑,打开Ubuntu终端,执行:
sudo apt update
sudo apt install -y nodejs npm
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
openclaw onboard --install-daemon
openclaw gateway start --daemon
4.4 本地部署验证
访问地址:
http://localhost:18789
五、大模型API配置(千问Qwen + Coding Plan)
5.1 阿里云千问大模型配置
打开配置文件
nano ~/.openclaw/openclaw.json写入配置(替换自己的API Key)
"models": { "default": "bailian/qwen3.6-plus", "providers": { "bailian": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "sk-你的千问APIKey", "models": [ { "id": "qwen3.6-plus","maxTokens": 8192}, { "id": "qwen3-max-2026","maxTokens": 65536} ] } } }重启服务
openclaw gateway restart
5.2 免费Coding Plan模型配置
编辑同一份配置文件
"models": { "default": "coding-plan/coding-free", "providers": { "coding-plan": { "baseUrl": "https://coding.dashscope.aliyuncs.com/v1", "apiKey": "sk-sp-你的免费APIKey", "models": [{ "id": "coding-free","maxTokens": 4096}] } } }重启服务
openclaw gateway restart
5.3 模型配置验证
openclaw model test
六、OpenClaw常用运维命令(全平台通用)
# 启动服务
openclaw gateway start
# 后台启动
openclaw gateway start --daemon
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart
# 查看状态
openclaw gateway status
# 查看实时日志
openclaw logs -f
# 模型测试
openclaw model test
# 生成管理员Token
openclaw token generate --admin
# 系统检查与修复
openclaw doctor
# 安装技能
clawhub install 技能名
# 查看已安装技能
clawhub list
# 重置配置
openclaw config reload
七、常见问题解答(覆盖90%故障)
1. 无法访问Web控制台
- 检查18789端口是否放行
- 检查服务是否运行:
openclaw gateway status - 检查公网IP/localhost是否正确
- 关闭本地防火墙或安全软件
2. 启动后立即退出/自动停止
- 内存不足,升级到4GB以上
- 配置文件JSON格式错误
- 端口被占用,结束占用程序
- 查看日志定位问题:
openclaw logs gateway
3. 模型调用失败/无回复
- API Key错误或过期
- BaseURL填写错误
- 账户无可用额度
- 千问与Coding Plan密钥混用
- 网络无法访问百炼接口
4. 命令不存在:openclaw: command not found
- npm全局路径未加入PATH
- 重新安装:
npm install -g openclaw - 执行:
source ~/.bashrc或source ~/.zshrc
5. 技能安装后不生效
- 必须重启服务:
openclaw gateway restart - 技能名称错误
- 存在冲突技能
6. Windows直接部署失败
- Windows不支持裸机运行,必须使用WSL2
- 以管理员身份运行PowerShell
7. 服务器重启后服务不自动运行
- 执行:
openclaw gateway install - 添加开机自启任务
8. 模型回复慢/超时
- 服务器带宽不足
- 地域过远,更换就近节点
- 降低maxTokens数值
- 切换为就近的百炼节点
八、总结
本文完整提供了2026年阿里云轻量服务器部署OpenClaw、本地macOS/Linux/Windows11全平台安装、阿里云千问大模型配置、免费Coding Plan模型接入以及全套避坑指南。整体流程简单统一,命令可直接复制,无需额外修改,适合零基础用户快速搭建属于自己的AI智能体服务。
遵循以下要点即可稳定运行:
- 服务器最低配置2核4GB
- 必须放行18789端口
- 使用后台启动并开启自启
- 准确填写API Key与BaseURL
- 修改配置后必须重启服务
- 出现问题优先查看日志
按照本文步骤操作,即可在15分钟内完成从云端到本地的完整部署,稳定运行OpenClaw并对接大模型,实现AI自动化能力。