本文为2026年最新、最完整的OpenClaw（Clawdbot）阿里云搭建教程，覆盖从服务器选购、系统初始化、环境安装、服务部署、端口放行、开机自启，到阿里云百炼Coding Plan API配置、本地MacOS/Linux/Windows11三端同步部署、技能加载、运行维护、常见问题一站式解决。所有步骤均为可直接复制的命令与可复现操作，面向零基础用户，全程无多余概念、无推广内容，只保留可落地的搭建流程。
一、部署前说明与环境要求
OpenClaw（曾用名Clawdbot）是一款可长期运行、支持技能扩展、可对接大模型的自主AI智能体，可用于信息检索、任务自动化、定时执行、文件处理、内容生成等场景。2026年官方推荐运行环境如下：
- 操作系统：Alibaba Cloud Linux 3 / Ubuntu 22.04
- 运行时：Node.js 22.x 及以上
- 服务器配置：最低 2核2GB，推荐 2核4GB
- 必需端口：18789（Web控制台）
- 模型依赖：阿里云百炼 Coding Plan 或其他免费大模型API
- 阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。
本文同时提供：
- 阿里云轻量应用服务器完整部署
- MacOS 本地部署
- Linux 本地部署
- Windows11 本地部署
- 阿里云百炼 API 配置
- 高频问题统一排查
二、2026年阿里云OpenClaw完整搭建流程（超详细版）
（一）购买与创建轻量应用服务器
- 登录阿里云控制台，访问阿里云OpenClaw一键部署专题页面
- 创建实例
- 镜像选择：应用镜像 → OpenClaw（Clawdbot）官方稳定版
- 实例规格：2核2GB 起步
- 地域建议：中国香港 / 新加坡 / 美国弗吉尼亚
- 设置登录密码（务必记住）
- 购买并等待实例启动
阿里云用户零基础部署 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 的地址。
（二）放行安全组端口（必须操作）
- 进入实例详情 → 安全组 → 入方向规则
- 新增规则：
- 协议：TCP
- 端口：18789
- 授权对象：0.0.0.0/0（正式环境可改为个人IP）
- 保存规则
（三）登录服务器并执行部署命令
使用Web终端或SSH登录，执行以下全套命令：
# 1. 更新系统
sudo yum update -y
# 2. 安装基础依赖
sudo yum install -y curl git
# 3. 安装 Node.js 22.x
curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz -o node.tar.xz
sudo tar -xf node.tar.xz -C /usr/local/
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npx /usr/bin/npx
# 4. 验证 Node 版本
node -v
npm -v
# 5. 设置 npm 国内镜像
npm config set registry https://registry.npmmirror.com
# 6. 全局安装 OpenClaw
npm install -g openclaw
# 7. 初始化配置
openclaw onboard
# 依次选择：
# 同意协议 → 快速启动 → 暂不配置模型 → 启用全部通道
# 8. 设置监听地址与端口
openclaw config set gateway.host 0.0.0.0
openclaw config set gateway.port 18789
# 9. 启动服务
openclaw gateway start
# 10. 设置开机自启
echo "openclaw gateway start &" | sudo tee -a /etc/rc.d/rc.local
sudo chmod +x /etc/rc.d/rc.local
（四）访问Web控制台
浏览器打开：
http://你的公网IP:18789
出现界面即部署完成。
三、本地三平台部署 OpenClaw（2026最新）
（一）MacOS 部署
# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node
brew install node
# 换源
npm config set registry https://registry.npmmirror.com
# 安装 OpenClaw
npm install -g openclaw
# 初始化
openclaw onboard
# 启动
openclaw gateway start
（二）Linux（Ubuntu/Debian）部署
sudo apt update
sudo apt install -y curl git nodejs npm
sudo npm install -g n
sudo n stable
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start
（三）Windows11 部署（管理员PowerShell）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
winget install OpenJS.NodeJS --version 22.0.0
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start
四、阿里云百炼 Coding Plan API 配置（免费模型）
（一）获取 API Key
- 登录阿里云百炼平台
- 进入控制台 → 密钥管理
- 创建 API Key + Access Key Secret
- 领取免费调用额度
（二）写入配置文件
配置文件路径：
- Mac/Linux：~/.openclaw/config.json
- Windows：C:\Users\用户名.openclaw\config.json
写入内容：
"model": {
"type": "aliyun-bailian",
"api_key": "你的APIKey",
"secret": "你的AccessKeySecret",
"model_name": "qwen-7b-chat",
"max_tokens": 2048,
"temperature": 0.7,
"timeout": 60,
"reasoning": false
}
（三）重启服务
openclaw gateway restart
五、通用免费大模型 API 配置（备用方案）
"model": {
"type": "openai",
"api_key": "免费API密钥",
"base_url": "https://api.example.com/v1",
"model_name": "gpt-3.5-turbo",
"max_tokens": 2048,
"temperature": 0.6
}
重启后生效。
六、OpenClaw 常用管理命令（必备）
# 启动服务
openclaw gateway start
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart
# 查看状态
openclaw gateway status
# 查看日志
openclaw logs
# 查看已安装技能
openclaw skill list
# 安装技能
openclaw skill install 名称
# 重启技能
openclaw skill restart 名称
# 系统检查
openclaw doctor
七、技能安装（基础必装）
npm install -g clawhub
clawhub install tavily-search
clawhub install agent-browser
clawhub install summarize
clawhub install skill-vetter
clawhub install proactive-agent
安装后重启：
openclaw gateway restart
八、2026高频常见问题一站式解答
（一）部署与启动问题
提示 openclaw: command not found
npm install -g openclaw # 关闭终端重新打开启动后自动退出
- 内存不足，最低需要 2GB
- 查看日志：
openclaw logs
- 无法访问 Web 控制台
- 阿里云安全组放行 18789
- 本地访问 http://127.0.0.1:18789
- 重启服务：
openclaw gateway restart
- 端口被占用
```bashLinux/Mac
lsof -i:18789
kill -9 进程ID
Windows
netstat -ano | findstr "18789"
taskkill /F /PID 进程ID
### （二）模型 API 问题
1. **模型调用失败**
- API Key 填写正确
- 已完成实名认证
- 有免费额度
- 模型名称正确：qwen-7b-chat
2. **AI 回复为空**
在配置中添加：
```json
"reasoning": false
- 响应超时
- 将 timeout 改为 60
- 降低 max_tokens
- 检查网络
（三）技能与系统问题
技能安装失败
npm config set registry https://registry.npmmirror.com npm install -g clawhub技能不生效
openclaw gateway restartWindows 权限不足
Set-ExecutionPolicy RemoteSigned -Scope CurrentUserLinux/Mac 权限不足
sudo npm install -g openclaw
九、开机自启与稳定运行配置（阿里云必配）
echo "openclaw gateway start &" | sudo tee -a /etc/rc.d/rc.local
sudo chmod +x /etc/rc.d/rc.local
十、日常维护最佳实践
- 不要使用默认端口 18789 对外暴露
- 正式环境设置 Token 认证
- 定期执行更新
npm update -g openclaw - 定期查看日志
openclaw logs --follow - 技能按需安装，避免过多占用资源
十一、总结
本文为2026年最新、最完整、最详细的OpenClaw阿里云搭建教程，覆盖服务器购买、安全组配置、系统初始化、Node环境安装、OpenClaw部署、开机自启、Web访问、本地三平台部署、阿里云百炼免费模型API配置、技能安装、常用命令、高频问题一站式解决。
所有命令均可直接复制，所有步骤均可零基础复现，适用于个人长期运行、任务自动化、信息监控、内容处理、办公辅助等轻量化场景，是目前最稳定、最通用的部署方案。
