一、前言
OpenClaw（曾用名 Clawdbot、Moltbot）是一款轻量化、可扩展、支持多模型调度的本地智能体框架，可同时对接云端大模型与本地模型，实现任务自动分配、自动降级、长文本处理、代码执行与文件读写等能力。本文基于 2026 年最新稳定版，完整覆盖阿里云服务器部署、macOS 部署、Linux 部署、Windows 11 部署四种环境，并提供阿里云千问大模型 API 配置、免费 Coding Plan 大模型 API 配置、常见问题与报错解决方案，全程可直接复制命令执行。
二、环境依赖与前置准备
所有平台必须先满足以下基础环境：
- Node.js ≥ 22.0.0
- Python 3.10–3.12
- Git ≥ 2.30
- npm ≥ 10.0
- 阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
1. 平台依赖检查命令
node -v
python3 --version
git --version
npm -v
2. Windows 11 特殊要求
必须启用 WSL2 + Ubuntu 22.04，原生 Windows 不支持多模型稳定运行。
三、阿里云部署 OpenClaw（2026 稳定版）
1. 购买与创建实例
- 进入阿里云控制台 → 轻量应用服务器
- 选择应用镜像：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 的地址。
2. 登录服务器并初始化
# 登录服务器
ssh root@你的服务器IP
# 更新系统
apt update && apt upgrade -y
# 安装依赖
apt install -y gcc g++ libssl-dev python3-venv
# 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
# 安装 OpenClaw
npm install -g openclaw@latest
3. 初始化配置
openclaw init --full
openclaw config set gateway.mode local
openclaw gateway start
4. 放行端口
firewall-cmd --add-port=18789/tcp --permanent
firewall-cmd --reload
5. 访问面板
http://你的服务器IP:18789
四、macOS 本地部署 OpenClaw
# 安装命令行工具
xcode-select --install
# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装依赖
brew install node@22 python3 git
# 安装 OpenClaw
npm install -g openclaw@latest
# 初始化
openclaw init --full
openclaw config set gateway.mode local
openclaw gateway start
访问面板：
http://localhost:18789
五、Linux（Ubuntu / Debian）部署 OpenClaw
sudo apt update
sudo apt install -y gcc g++ libssl-dev python3-venv git
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
sudo apt install -y nodejs
sudo npm install -g openclaw@latest
openclaw init --full
openclaw config set gateway.mode local
openclaw gateway start
六、Windows 11（WSL2 Ubuntu）部署 OpenClaw
# 管理员 PowerShell
wsl --install
wsl --set-default-version 2
wsl --install -d Ubuntu-22.04
进入 Ubuntu 后执行：
sudo apt update
sudo apt install -y gcc g++ libssl-dev python3-venv git
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
sudo apt install -y nodejs
sudo npm install -g openclaw@latest
openclaw init --full
openclaw config set gateway.mode local
openclaw gateway start
七、阿里云千问大模型 API 配置
1. 获取 API Key
阿里云百炼 → 密钥管理 → 创建 API Key
记录：
- API Key：
sk-xxxx - Base URL：
https://dashscope.aliyuncs.com/compatible-mode/v1 - 模型：
qwen-max
2. OpenClaw 配置命令
openclaw model add aliyun-qwen \
--base-url https://dashscope.aliyuncs.com/compatible-mode/v1 \
--api-key sk-你的密钥 \
--model qwen-max
openclaw model set-default aliyun-qwen
openclaw gateway restart
八、免费 Coding Plan 大模型 API 配置
1. 获取 API 信息
- API Key：
sk-sp-xxxx - Base URL：
https://coding.dashscope.aliyuncs.com/v1 - 模型：
qwen-max-latest
2. 配置命令
openclaw model add coding-plan \
--base-url https://coding.dashscope.aliyuncs.com/v1 \
--api-key sk-sp-你的密钥 \
--model qwen-max-latest
openclaw model set-default coding-plan
openclaw gateway restart
九、常用命令速查
# 查看模型列表
openclaw model list
# 查看网关状态
openclaw gateway status
# 重启服务
openclaw gateway restart
# 测试模型连通性
openclaw test api --model aliyun-qwen
十、常见问题解答
1. 端口 18789 占用
lsof -i :18789
kill -9 PID
2. command not found
npm prefix -g
export PATH="$(npm prefix -g)/bin:$PATH"
source ~/.bashrc
3. Python 版本不匹配
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1
sudo update-alternatives --config python3
4. 模型切换不生效
openclaw gateway restart
5. WSL2 无法访问 Ollama
# 获取主机 IP
cat /etc/resolv.conf | grep nameserver
# 在 OpenClaw 配置 Ollama 地址
openclaw config set ollama.host 主机IP
十一、总结
本文完整提供 2026 年最新版 OpenClaw（Clawdbot）阿里云 + Linux + macOS + Windows 11（WSL2）四平台一键部署流程，同时支持阿里云千问与免费 Coding Plan双模型接入，所有命令可直接复制使用，适合个人智能体、自动化任务、本地知识库、代码助手等场景。
