在AI自动化技术持续迭代的2026年，OpenClaw（曾用名Clawdbot、Moltbot）凭借轻量架构、灵活扩展的核心优势，成为开发者与普通用户构建定制化AI代理工具的优选方案。其支持云端与本地多环境部署，无需高性能硬件支撑，通过对接大模型API即可实现任务自动化、视觉识别、多端联动等功能，广泛应用于办公自动化、代码辅助、批量任务处理等场景。本文基于2026年最新技术规范，详细拆解阿里云ECS云服务器秒级部署OpenClaw的完整流程，同步覆盖本地MacOS、Linux、Windows11系统的部署步骤，详解阿里云千问Qwen3-Max大模型API配置方法，以及市场上免费大模型Coding Plan API的接入流程，搭配可直接复制执行的代码命令，并针对部署及使用中的常见问题提供解决方案，确保不同技术基础的用户均能顺利完成部署与配置，全程无任何营销词汇，聚焦技术实操。
一、OpenClaw（Clawdbot）核心特性与部署前置要求
OpenClaw是一款开源的AI代理与自动化平台，核心架构采用“本地终端+云端大脑”模式，本地设备仅承担控制与交互功能，核心计算依赖云端大模型，大幅降低了硬件门槛，同时保障运行流畅度。其核心特性包括：系统级操作控制（模拟鼠标键盘、窗口切换）、屏幕视觉识别（抓取、UI定位）、多脚本兼容（Shell/Python/JS）、远程联动能力，以及与各类主流大模型的无缝对接，适配个人办公、开发者测试、小型团队协作等多种场景，无需独立显卡，基础CPU与内存即可满足运行需求。目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
（一）通用部署前提
- 网络要求：稳定的互联网连接，确保能够正常下载部署依赖包、克隆开源仓库，以及后续调用云端大模型API；
- 权限要求：阿里云ECS服务器需拥有实例管理权限，本地设备需开启管理员模式（用于安装依赖、配置权限）；
- 基础工具：提前准备Git（代码克隆工具）、Node.js（运行环境，要求≥22.x），部分系统需额外安装对应包管理器（MacOS的Homebrew、Linux的apt、Windows11的Chocolatey可选）；
- API准备：提前获取阿里云千问大模型API Key，或市场上免费的Coding Plan API Key（具体获取方法见下文），用于后续大模型对接，确保API处于有效状态。
（二）不同部署环境最低配置要求
| 部署环境 | 内存 | 磁盘可用空间 | 系统版本要求 | 核心依赖 |
|---|---|---|---|---|
| 阿里云ECS云服务器 | ≥2GB（推荐4GB） | ≥2GB | Alibaba Cloud Linux 3.2104 LTS 64位 | Node.js ≥22.x、Git、firewalld |
| MacOS | ≥4GB（推荐8GB） | ≥5GB | macOS 12.0+（推荐14.0+，适配Intel/M1/M2/M3/M4芯片） | Homebrew、Xcode Command Line Tools、Node.js ≥22.x、Git |
| Linux | ≥4GB | ≥2GB | Ubuntu 20.04+（或其他基于Debian的系统） | Node.js ≥22.x、Git、apt包管理器 |
| Windows11 | ≥4GB | ≥5GB | Windows11 专业版/家庭版（已更新至最新补丁） | Node.js ≥22.x、Git、PowerShell（管理员模式） |
二、2026年阿里云ECS云服务器秒级部署OpenClaw流程
阿里云ECS云服务器部署OpenClaw采用“预置应用镜像”方案，无需手动配置依赖环境，通过控制台一键操作即可完成部署，大幅提升效率，部署完成后可直接接入千问大模型API，实现公网访问与远程控制，适合追求高效部署、无需复杂配置的用户。
（一）前置准备：阿里云ECS服务器购买与基础配置
- 登录阿里云控制台，进入“云服务器ECS”页面，点击“实例创建”，选择“应用镜像”分类，找到“OpenClaw专属镜像”（2026年默认版本为v2026.2.9，基于Alibaba Cloud Linux 3.2104 LTS 64位，预装Node.js、Git及OpenClaw核心依赖）；
- 配置ECS实例参数：实例规格选择≥2GB内存（推荐4GB，保障多任务运行流畅度），地域根据自身需求选择（建议选择距离自己较近的地域，降低网络延迟；国内地域需完成ICP备案，海外/港澳台地域可直接使用，无需备案）；存储选择≥40GiB ESSD系统盘，带宽选择≥1Mbps，满足基础访问需求；
- 完成实例配置：设置ECS登录密码（需包含大小写字母、数字及特殊符号，用于后续远程登录），勾选“已阅读并同意相关协议”，点击“创建实例”，支付完成后，等待1-3分钟，直至实例状态变为“运行中”；
- 记录关键信息：进入ECS实例管理页面，找到目标实例，记录服务器公网IP地址（后续用于访问OpenClaw Web UI面板、远程登录及API配置）。
阿里云用户零基础部署 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 的地址。
（二）OpenClaw秒级部署与基础配置（控制台可视化操作）
- 安全组与端口配置（必做步骤）：阿里云ECS的网络访问需同时满足安全组与系统防火墙放行规则，两者为“与”关系，需同时配置才能正常访问服务。
- 安全组配置：在ECS实例管理页面，点击“安全组”→“配置规则”，点击“添加安全组规则”，分别添加以下规则（确保OpenClaw服务端口放行）：
- 入方向：端口范围填写“8080/8080”（OpenClaw默认Web UI端口），授权对象填写“0.0.0.0/0”（允许所有IP访问，仅用于测试，生产环境建议限制指定IP），协议类型选择“TCP”；
- 入方向：端口范围填写“22/22”（SSH远程登录端口，必开），授权对象填写“0.0.0.0/0”，协议类型选择“TCP”；
- 系统防火墙配置：远程登录ECS服务器（通过SSH工具，输入公网IP、用户名root及登录密码），执行以下命令开放8080端口，确保防火墙放行：
# 查看防火墙状态（running为已开启，not running为未开启） sudo firewall-cmd --state # 若未安装firewalld，执行安装命令 sudo yum install firewalld -y # 启动防火墙并设置开机自启 sudo systemctl start firewalld sudo systemctl enable firewalld # 永久开放8080端口（OpenClaw Web UI端口） sudo firewall-cmd --permanent --add-port=8080/tcp # 永久开放22端口（SSH远程登录端口） sudo firewall-cmd --permanent --add-service=ssh # 重新加载防火墙规则，使配置生效 sudo firewall-cmd --reload # 验证规则是否生效，查看已开放端口 sudo firewall-cmd --list-all
- 安全组配置：在ECS实例管理页面，点击“安全组”→“配置规则”，点击“添加安全组规则”，分别添加以下规则（确保OpenClaw服务端口放行）：
- OpenClaw初始化配置：在ECS实例管理页面，点击“应用详情”→“OpenClaw配置”，点击“初始化”按钮，输入提前获取的阿里云千问API Key，选择API Key对应的地域（如cn-beijing、cn-shanghai，必须与API Key地域一致，否则无法调用模型），点击“确认”，等待30秒左右，页面提示“初始化成功”，完成基础配置；
- 访问OpenClaw Web UI面板：在ECS实例管理页面，点击“应用详情”→“访问Web UI”，系统会自动生成访问地址（格式为“http://公网IP:8080”），复制该地址在浏览器中打开，首次访问需设置管理员账号和密码，完成后即可进入OpenClaw可视化操作面板，可进行任务创建、API管理等操作；
- 可选配置：远程登录ECS服务器，执行以下命令查看OpenClaw Token（用于第三方工具集成、远程联动），并保存妥善保管：
# 查看OpenClaw Token cat ~/.openclaw/token # 查看OpenClaw服务状态 systemctl status openclaw
（三）阿里云ECS部署验证
执行以下命令，检查OpenClaw服务运行状态、版本信息及端口占用情况，确保部署成功：
# 查看OpenClaw服务状态（active (running)即为正常运行）
systemctl status openclaw
# 若服务未启动，执行启动命令
systemctl start openclaw
# 查看OpenClaw版本，验证部署有效性
openclaw --version
# 查看8080端口占用情况，确认服务正常监听
netstat -tuln | grep 8080
# 运行基础测试命令，验证服务可用性
openclaw doctor
若输出OpenClaw版本号（如v2026.2.9）、服务状态为active (running)，且Web UI面板能正常访问、测试命令执行成功，则阿里云ECS服务器端OpenClaw部署完成。
三、本地多系统部署OpenClaw（Clawdbot）详细流程
本地部署OpenClaw分为“新手一键部署”和“开发者手动部署”两种方式，新手推荐一键部署（官方脚本自动配置环境、下载依赖，无需手动干预），开发者可选择手动部署（便于自定义源码、修改配置参数），以下分别详解MacOS、Linux、Windows11三个系统的完整部署步骤，所有代码命令均可直接复制执行。
（一）MacOS系统部署流程（适配Intel/M1/M2/M3/M4芯片）
1. 前置工具安装（必做步骤）
MacOS部署需依赖Xcode Command Line Tools、Homebrew、Git、Node.js，一键复制以下命令完成安装，全程自动执行，无需手动干预：
# 1. 安装Xcode Command Line Tools（命令行工具，必装）
xcode-select --install
# 安装完成后验证，输出/Library/Developer/CommandLineTools即为成功
xcode-select -p
# 2. 安装Homebrew（Mac必备包管理器，用于后续依赖安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 验证Homebrew安装，输出版本号即为成功
brew --version
# 3. 安装Git + Node.js（运行依赖，Node.js需≥22.x）
brew install git node@22
# 软链接Node.js到全局，确保可直接调用node命令（避免版本冲突）
brew link node@22 --force
# 验证版本，均输出对应版本号即为成功（Node.js≥22.x）
node -v && npm -v && git --version
# 4. 可选：安装node-gyp（解决sharp依赖安装失败问题）
npm install -g node-gyp
2. 部署方式选择（二选一，新手推荐一键部署）
方式一：新手一键部署（推荐，5分钟搞定）
官方脚本自动配置环境、下载依赖、安装程序，全程无需手动干预，适合零基础用户：
# 一键部署OpenClaw（默认使用npm安装方式）
curl -fsSL https://openclaw.ai/install.sh | bash
# 若需跳过新手引导，执行以下命令
# curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
# 若安装完成后，执行openclaw --version提示“command not found”，配置环境变量（根据终端类型选择）
# 若为zsh终端（Mac默认终端）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 若为bash终端（旧版Mac）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
执行后输入Mac管理员密码（输入时不显示字符，属于正常现象），等待脚本执行完毕（约3-5分钟，根据网络速度调整）。
方式二：开发者手动部署（自定义配置、修改源码）
适合需要修改OpenClaw源码、自定义编译配置的开发者，步骤如下：
# 1. 克隆OpenClaw开源仓库（从GitHub获取最新源码）
git clone https://github.com/openclaw/openclaw.git
# 进入仓库目录
cd openclaw
# 2. 安装项目依赖（需等待1-2分钟，根据网络速度调整）
# 若sharp安装失败，添加环境变量跳过原生构建
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install
# 3. 构建项目（首次运行需执行，生成可执行文件）
npm run build
# 4. 全局软链接，确保可直接调用openclaw命令
npm link
# 5. 验证安装，输出版本号即为成功
openclaw --version
3. Mac专属权限配置（必做，否则核心功能失效）
Mac系统出于安全限制，OpenClaw需手动授权辅助功能、屏幕录制、文件访问权限，否则无法实现鼠标键盘模拟、屏幕抓取等功能，步骤如下：
- 打开Mac系统设置 → 进入“隐私与安全性”；
- 找到“辅助功能”：点击“+”，添加OpenClaw应用（路径为
/usr/local/bin/openclaw或~/.local/bin/openclaw），开启权限开关； - 找到“屏幕录制”：同样添加OpenClaw应用，开启权限开关（用于视觉识别、屏幕抓取）；
- 找到“文件与文件夹”：开启OpenClaw的“完全磁盘访问”权限（用于文件读写、本地脚本调用）；
- 重启终端或OpenClaw服务，确保权限生效。
4. 启动与验证
# 启动OpenClaw服务
openclaw start
# 查看服务运行状态（active (running)即为正常）
openclaw status
# 首次运行需执行新手引导，按终端提示完成基础配置
openclaw onboard --install-daemon
# 配置开机自启（推荐，避免每次重启电脑重新启动服务）
openclaw onboard --install-daemon
# 基础功能测试，验证部署有效性
# 运行官方demo，自动执行简单自动化任务（如模拟鼠标点击）
openclaw run demo
# 进入交互式聊天模式，测试基础响应
openclaw chat
# 查看OpenClaw网关健康状态
openclaw health
# 打开本地Web面板（浏览器输入http://localhost:3000）
openclaw dashboard
测试完成后，浏览器访问http://localhost:3000，即可进入OpenClaw本地Web面板，完成MacOS系统部署。
（二）Linux系统部署流程（以Ubuntu 22.04为例，适配所有基于Debian的系统）
1. 前置环境配置与工具安装
# 1. 更新系统软件包列表，确保所有软件为最新版本，避免依赖冲突
sudo apt update && sudo apt upgrade -y
# 2. 安装Node.js 22.x（运行依赖，必须≥22.x）
# 添加Node.js 22.x仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装Node.js和npm
sudo apt-get install -y nodejs
# 3. 安装Git（用于克隆开源仓库）和ufw（防火墙管理工具）
sudo apt install git ufw -y
# 4. 验证安装，输出对应版本号即为成功
node -v && npm -v && git --version && ufw --version
# 5. 配置Git（避免SSH权限错误，便于克隆GitHub仓库）
git config --global url."https://github.com/".insteadOf git@github.com:
git config --global url."https://".insteadOf ssh://
# 6. 配置npm（避免权限问题，创建专用全局目录）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# 配置环境变量，确保npm命令可正常使用
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
# 7. 配置防火墙，开放3000端口（本地Web面板端口）
sudo ufw allow 3000/tcp
sudo ufw allow ssh
sudo ufw enable
# 验证防火墙规则
sudo ufw status
2. 部署方式选择（二选一）
方式一：新手一键部署
# 一键部署OpenClaw，自动配置环境与依赖
curl -fsSL https://openclaw.ai/install.sh | bash
# 验证安装，输出版本号即为成功
openclaw --version
方式二：开发者手动部署
# 1. 克隆OpenClaw开源仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 2. 安装项目依赖（若sharp安装失败，添加环境变量）
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install
# 3. 构建项目
npm run build
# 4. 全局软链接
npm link
# 5. 验证安装
openclaw --version
3. 启动与验证
# 启动OpenClaw服务
openclaw start
# 查看服务状态（active (running)即为正常）
openclaw status
# 执行新手引导，完成基础配置
openclaw onboard --install-daemon
# 测试基础功能，运行官方demo
openclaw run demo
# 访问本地Web面板（浏览器输入http://localhost:3000）
openclaw dashboard
若终端输出demo执行成功，且Web面板能正常访问、服务状态正常，则Linux系统部署完成。
（三）Windows11系统部署流程
Windows11部署需使用PowerShell（管理员模式），全程通过命令行操作，步骤清晰，新手可按顺序执行，避免遗漏步骤。
1. 前置工具安装（必做）
（1）安装Node.js 22.x
- 访问Node.js官方网站（https://nodejs.org），下载Node.js 22.x版本（Windows Installer 64-bit）；
- 双击安装包，勾选“Add to PATH”选项（自动配置环境变量），一路下一步完成安装；
- 打开PowerShell（管理员模式），执行以下命令验证安装：
输出对应版本号（Node.js≥22.x）即为成功。node -v && npm -v
（2）安装Git
- 访问Git官方网站（https://git-scm.com），下载Windows版本Git，安装时勾选“Add Git to PATH”（添加到环境变量）；
- 验证安装：
输出Git版本号即为成功。git --version
（3）配置PowerShell执行策略
Windows11默认限制脚本执行，需修改执行策略，否则无法运行OpenClaw部署脚本：
# 修改PowerShell执行策略，允许运行本地脚本
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 输入“Y”确认，完成配置
2. 部署方式选择（二选一）
方式一：新手一键部署
# 一键部署OpenClaw，自动下载依赖并安装
Invoke-Expression (Invoke-WebRequest -Uri https://openclaw.ai/install.ps1 -UseBasicParsing).Content
# 等待脚本执行完毕（约5分钟），验证安装
openclaw --version
方式二：开发者手动部署
# 1. 克隆OpenClaw开源仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 2. 安装项目依赖（若提示权限不足，确认PowerShell为管理员模式）
npm install
# 3. 构建项目
npm run build
# 4. 全局软链接
npm link
# 5. 验证安装
openclaw --version
3. Windows11权限配置与启动验证
- 权限配置：打开“设置”→“隐私和安全性”→“开发者选项”，开启“开发人员模式”（用于允许脚本执行、系统级操作）；
- 启动服务：
# 启动OpenClaw服务 openclaw start # 查看服务状态（active (running)即为正常） openclaw status # 执行新手引导，完成基础配置 openclaw onboard --install-daemon # 测试基础功能，运行官方demo openclaw run demo # 打开本地Web面板（浏览器输入http://localhost:3000） openclaw dashboard - 异常处理：若启动服务提示“端口被占用”，执行以下命令查看端口占用情况，并关闭占用进程：
测试完成后，浏览器访问# 查看3000端口占用情况（OpenClaw默认端口） netstat -ano | findstr :3000 # 根据输出的PID，关闭占用进程（替换XXX为PID） taskkill /F /PID XXXhttp://localhost:3000，即可进入OpenClaw本地Web面板，完成Windows11系统部署。
四、大模型API配置（阿里云千问Qwen3-Max+免费Coding Plan）
OpenClaw的核心智能功能依赖大模型API，本文提供两种配置方案，用户可根据自身需求选择：阿里云千问Qwen3-Max大模型（性能稳定、响应迅速，适合生产环境、复杂任务处理）、市场上免费的Coding Plan API（零成本，适合个人测试、新手入门，支持兼容OpenAI/Anthropic API协议），两种方案可同时配置，自由切换使用。
（一）阿里云千问Qwen3-Max大模型API配置
1. 获取阿里云千问API Key（必做步骤）
- 注册并登录阿里云账号（已有账号可直接登录），完成实名认证（个人用户通过身份证刷脸或支付宝授权，企业用户上传相关资质，审核1-3个工作日）；未完成实名认证的账号，无法开通百炼服务及获取API Key；
- 进入阿里云百炼大模型服务平台，阅读并同意服务协议，系统自动开通阿里云百炼服务（若未弹出协议，说明已开通）；
- 进入“密钥管理”页面，点击“创建API Key”，系统自动生成API Key（含Access Key ID与Access Key Secret），点击“复制”并保存至本地文档（妥善保管，避免泄露，泄露后可立即重置）；
- 查看API Key对应地域（如cn-beijing、cn-shanghai），记录地域信息（后续配置需用到，地域不匹配会导致API调用失败）。
2. API Key配置（分环境操作，全程无泄露风险）
（1）阿里云ECS服务器配置（已部署OpenClaw）
两种配置方式，任选其一，推荐控制台可视化配置，操作更便捷：
- 方式一：控制台可视化配置（推荐）
在ECS实例管理页面，点击“应用详情”→“OpenClaw配置”，重新输入API Key并选择对应地域，点击“确认”，系统自动重启OpenClaw服务，完成配置。 - 方式二：手动配置（适合开发者，自定义参数）
远程登录ECS服务器，执行以下命令：
在配置文件中添加以下内容（替换为自己的API Key和地域）：# 打开OpenClaw配置文件（使用nano编辑器） nano ~/.openclaw/config.yaml
保存并退出（按Ctrl+X，按Y，再按Enter），重启OpenClaw服务：models: - name: qwen3-max provider: aliyun api_key: "你的阿里云千问API Key" region: "你的API Key对应地域（如cn-beijing）" base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"openclaw restart
（2）本地系统配置（MacOS/Linux/Windows11）
推荐将API Key配置到系统环境变量，避免在配置文件中显式填写，降低泄露风险，步骤如下：
① MacOS系统（zsh终端）
# 配置永久性环境变量（当前用户所有会话生效）
echo "export DASHSCOPE_API_KEY='你的阿里云千问API Key'" >> ~/.zshrc
# 使环境变量生效
source ~/.zshrc
# 验证环境变量（输出API Key即为成功）
echo $DASHSCOPE_API_KEY
# 打开OpenClaw配置文件
open ~/.openclaw/config.yaml
添加以下配置（无需修改，直接复制）：
models:
- name: qwen3-max
provider: aliyun
api_key: "${DASHSCOPE_API_KEY}"
region: "你的API Key对应地域"
base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"
保存后重启OpenClaw服务：
openclaw restart
② Linux系统
# 配置永久性环境变量
echo "export DASHSCOPE_API_KEY='你的阿里云千问API Key'" >> ~/.bashrc
# 使环境变量生效
source ~/.bashrc
# 验证环境变量
echo $DASHSCOPE_API_KEY
# 打开配置文件
nano ~/.openclaw/config.yaml
添加与MacOS相同的配置内容，保存后重启服务：
openclaw restart
③ Windows11系统（PowerShell）
# 配置永久性环境变量（当前用户生效）
[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "你的阿里云千问API Key", "User")
# 重启PowerShell，验证环境变量
echo $env:DASHSCOPE_API_KEY
# 打开OpenClaw配置文件（记事本打开）
notepad $HOME/.openclaw/config.yaml
添加以下配置：
models:
- name: qwen3-max
provider: aliyun
api_key: "${env:DASHSCOPE_API_KEY}"
region: "你的API Key对应地域"
base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"
保存后重启OpenClaw服务：
openclaw restart
3. 千问API调用测试
执行以下命令，测试大模型是否配置成功，确保能够正常响应：
# MacOS/Linux/ECS服务器
openclaw chat --model qwen3-max
# Windows11（PowerShell）
openclaw chat --model qwen3-max
输入测试问题（如“介绍OpenClaw的核心功能”“编写一个简单的Python自动化脚本”），若能正常返回千问Qwen3-Max模型的回答，说明API配置成功；若提示失败，检查API Key、地域是否正确，以及API是否有可用调用额度。
（二）免费大模型Coding Plan API配置
Coding Plan是市场上免费的大模型API服务，支持兼容OpenAI/Anthropic API协议，可直接接入OpenClaw，零成本实现大模型联动，适合个人测试、非生产环境使用，无需付费，仅需完成订阅即可获取API Key。
1. 获取Coding Plan API Key（必做步骤）
- 访问Coding Plan官方平台（以MiniMax Coding Plan为例），注册并登录账号（支持手机号、邮箱注册）；
- 进入“订阅Coding Plan”页面，选择免费套餐（无需付费，有固定月度调用额度，满足个人测试需求），完成订阅；
- 进入“接口密钥”页面，点击“创建Coding Plan Key”，生成并保存API Key（仅在订阅有效期内有效，妥善保管，避免泄露）；
- 记录Coding Plan支持的模型名称（如MiniMax-M2.1）及API基础地址（默认地址为
https://coding.dashscope.aliyuncs.com/v1）。
2. API配置（分协议选择，所有环境通用）
Coding Plan支持两种API协议（OpenAI兼容协议、Anthropic兼容协议），任选一种即可，以下以OpenAI兼容协议为例，配置步骤如下（所有环境通用）：
（1）配置环境变量（避免泄露API Key）
① MacOS/Linux系统
# 配置永久性环境变量（替换为你的Coding Plan API Key）
echo "export CODING_PLAN_API_KEY='你的Coding Plan API Key'" >> ~/.zshrc（MacOS）/~/.bashrc（Linux）
source ~/.zshrc（MacOS）/~/.bashrc（Linux）
# 验证环境变量，输出API Key即为成功
echo $CODING_PLAN_API_KEY
② Windows11系统
# 配置永久性环境变量
[Environment]::SetEnvironmentVariable("CODING_PLAN_API_KEY", "你的Coding Plan API Key", "User")
# 重启PowerShell，验证环境变量
echo $env:CODING_PLAN_API_KEY
（2）修改OpenClaw配置文件
打开~/.openclaw/config.yaml（Windows11路径为$HOME/.openclaw/config.yaml），添加以下配置（根据系统选择对应api_key写法）：
models:
- name: coding-plan-model
provider: openai
api_key: "${
CODING_PLAN_API_KEY}" # MacOS/Linux系统使用此写法
# api_key: "${env:CODING_PLAN_API_KEY}" # Windows11系统使用此写法
base_url: "https://coding.dashscope.aliyuncs.com/v1"
model: "MiniMax-M2.1" # 根据Coding Plan支持的模型选择，替换为对应模型名称
保存后重启OpenClaw服务：
# MacOS/Linux/ECS服务器
openclaw restart
# Windows11（PowerShell）
openclaw restart
3. Coding Plan API调用测试
执行以下命令，测试API配置是否成功：
# MacOS/Linux/ECS服务器
openclaw chat --model coding-plan-model
# Windows11（PowerShell）
openclaw chat --model coding-plan-model
输入测试问题（如“解释什么是AI自动化”），若能正常返回回答，说明配置成功；若提示“API Key无效”，检查API Key是否在订阅有效期内、是否填写正确，或重新创建API Key后再次配置。
五、部署及使用常见问题解答（FAQ）
结合2026年OpenClaw最新版本特性及多环境部署实践，整理以下常见问题及解决方案，覆盖部署、API配置、使用三个场景，所有解决方案均经过实测，可直接参考操作。
（一）部署类问题
问题：部署时提示“Node.js版本过低”，如何解决？
解答：OpenClaw要求Node.js≥22.x，需卸载旧版本，重新安装Node.js 22.x，步骤如下：- MacOS/Linux：
# 卸载旧版本Node.js sudo apt remove nodejs -y（Linux）/brew uninstall node（MacOS） # 重新安装Node.js 22.x（参考前文对应系统的安装命令） brew install node@22（MacOS）/curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs（Linux） # 验证版本 node -v - Windows11：通过“控制面板→程序和功能”卸载Node.js，重新访问Node.js官网下载22.x版本，安装时勾选“Add to PATH”，安装完成后验证版本。
- MacOS/Linux：
问题：MacOS部署后，执行
openclaw start提示“权限不足”，如何解决？
解答：未完成Mac专属权限配置，或未使用管理员权限执行命令，解决方案如下：
① 重新按照前文“Mac专属权限配置”步骤，开启辅助功能、屏幕录制、完全磁盘访问权限，重启终端；
② 若仍提示权限不足，执行sudo openclaw start，输入Mac管理员密码即可；
③ 若权限列表中无OpenClaw，点击“+”手动添加，路径为/usr/local/bin/openclaw或~/.local/bin/openclaw。问题：Linux部署时，克隆OpenClaw仓库提示“SSH权限错误”，如何解决？
解答：未配置Git的URL重写规则，导致无法通过SSH协议克隆仓库，执行以下命令即可解决：git config --global url."https://github.com/".insteadOf git@github.com: git config --global url."https://".insteadOf ssh://执行完成后，重新克隆仓库即可。
问题：Windows11部署时，
npm install提示“无法运行脚本”，如何解决？
解答：PowerShell执行策略限制，未允许本地脚本运行，解决方案如下：
① 以管理员模式重新打开PowerShell；
② 执行以下命令修改执行策略：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser③ 输入“Y”确认，再次执行
npm install即可。问题：阿里云ECS部署后，无法访问Web UI面板（提示“无法连接到服务器”），如何解决？
解答：大概率是安全组、系统防火墙未放行8080端口，或服务未启动，步骤如下：
① 重新检查ECS安全组规则，确保8080端口、22端口已放行，授权对象正确；
② 远程登录ECS服务器，执行sudo firewall-cmd --list-all，检查8080端口是否已开放，若未开放，重新执行端口开放命令；
③ 检查OpenClaw服务状态，执行systemctl status openclaw，若未启动，执行systemctl start openclaw；
④ 确认Web UI地址正确（格式为“http://公网IP:8080”），避免遗漏端口号。问题：本地部署后，执行
openclaw --version提示“command not found”，如何解决？
解答：环境变量配置错误，导致系统无法识别openclaw命令，解决方案如下：- MacOS（zsh终端）：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc - Linux：
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc source ~/.bashrc - Windows11：重启PowerShell，若仍未解决，重新安装Node.js，确保勾选“Add to PATH”，或手动配置环境变量（添加Node.js和OpenClaw安装路径）。
- MacOS（zsh终端）：
（二）API配置类问题
问题：调用千问API提示“地域不匹配”，如何解决？
解答：API Key的地域与配置文件中的region参数不一致，导致调用失败，解决方案如下：
① 进入阿里云百炼“密钥管理”页面，查看API Key对应的地域（如cn-beijing）；
② 打开OpenClaw配置文件，修改region参数，确保与API Key地域一致；
③ 重启OpenClaw服务，再次测试API调用。问题：调用Coding Plan API提示“API Key无效”，如何解决？
解答：主要原因是API Key过期、未订阅免费套餐，或填写错误，解决方案如下：
① 进入Coding Plan平台，检查API Key是否在订阅有效期内，若过期，重新创建API Key；
② 确认已订阅免费套餐，未订阅则完成订阅后重新生成API Key；
③ 检查配置文件中的API Key是否填写正确，避免空格、拼写错误，或重新配置环境变量；
④ 确认base_url和model参数正确，与Coding Plan官方提供的信息一致。问题：配置API后，调用大模型提示“API Key泄露风险”，如何解决？
解答：未将API Key配置到系统环境变量，而是直接填写在配置文件中，存在泄露风险，解决方案如下：
① 按照前文API配置步骤，将API Key配置到系统环境变量（MacOS/Linux的.bashrc/.zshrc，Windows11的用户环境变量）；
② 修改OpenClaw配置文件，使用环境变量引用API Key（如${DASHSCOPE_API_KEY}），删除配置文件中显式填写的API Key；
③ 重启OpenClaw服务，再次调用大模型，即可消除提示。问题：调用千问API提示“无可用调用额度”，如何解决？
解答：阿里云千问API调用需要一定额度，新用户可领取免费额度，解决方案如下：
① 进入阿里云百炼平台，查看API调用额度，若额度不足，领取免费额度或购买额度包；
② 确认阿里云账号余额充足，避免因欠费导致额度无法使用；
③ 若已领取免费额度，检查额度是否过期，过期后重新领取。
（三）使用类问题
问题：OpenClaw服务启动后，执行
openclaw run demo提示“执行失败”，如何解决？
解答：大概率是依赖包安装不完整或权限不足，步骤如下：
① 重新执行npm install（手动部署用户），确保依赖包安装完整，若sharp安装失败，添加SHARP_IGNORE_GLOBAL_LIBVIPS=1环境变量；
② 检查本地系统权限（MacOS开启对应权限，Windows11开启开发人员模式，Linux使用sudo权限）；
③ 重启OpenClaw服务，执行openclaw doctor检查服务健康状态，再重新执行demo测试；
④ 若仍失败，执行openclaw health查看网关状态，排查服务异常。问题：本地部署后，Web面板无法访问（提示“无法连接到服务器”），如何解决？
解答：OpenClaw服务未启动或端口被占用，步骤如下：
① 执行openclaw status，查看服务是否处于active (running)状态，若未启动，执行openclaw start；
② 检查3000端口是否被占用（MacOS/Linux执行netstat -tuln | grep 3000，Windows11执行netstat -ano | findstr :3000）；
③ 若端口被占用，关闭占用端口的进程，或修改OpenClaw配置文件，更换端口（如3001），重启服务后重新访问；
④ 执行openclaw dashboard，让系统自动打开Web面板，避免手动输入地址错误。问题：OpenClaw重启电脑后，服务无法自动启动，如何解决？
解答：未配置开机自启，执行以下命令配置开机自启，适配所有系统：# MacOS/Linux/ECS服务器 openclaw onboard --install-daemon # Windows11（PowerShell） openclaw onboard --install-daemon配置完成后，重启电脑，执行
openclaw status，确认服务正常启动。问题：手动部署OpenClaw时，
npm install提示“sharp安装失败”，如何解决？
解答：sharp依赖包需要原生构建，可通过以下命令跳过原生构建，直接使用预构建二进制文件：# MacOS/Linux/ECS服务器 SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install # Windows11（PowerShell） $env:SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install若仍失败，安装node-gyp工具，再重新执行安装命令：
npm install -g node-gyp npm install
六、总结
2026年OpenClaw（Clawdbot）的多环境部署核心优势的在于“轻量、高效、低成本”，无论是阿里云ECS云服务器的秒级部署（依托预置镜像，无需手动配置依赖），还是本地MacOS、Linux、Windows11系统的一键/手动部署，都能满足不同用户的需求——阿里云ECS部署适合需要7×24小时后台运行、公网访问的场景，本地部署适合个人日常使用、离线操作。
大模型API配置方面，阿里云千问Qwen3-Max提供稳定、高效的智能交互能力，适合生产环境、复杂任务处理；免费的Coding Plan API则为个人测试、新手入门提供了零成本解决方案，两种方案可自由切换，覆盖不同使用场景。本文详细覆盖了从部署前置准备、多环境部署步骤，到大模型API配置、常见问题解答的全流程，所有代码命令均可直接复制执行，降低了部署门槛，避免了复杂的手动配置，确保不同技术基础的用户都能顺利完成OpenClaw的部署与使用。
用户在部署过程中，若遇到其他未提及的问题，可访问OpenClaw官方文档获取帮助，也可根据自身需求，自定义配置OpenClaw的功能，实现更贴合自身场景的AI自动化应用，充分发挥OpenClaw的灵活扩展优势。
