2026年阿里云计算巢部署OpenClaw保姆级图文教程（附本地搭建及大模型API配置+避坑指南）

OpenClaw（原Clawdbot/Moltbot）是一款开源、自托管的AI智能体平台，核心优势在于打破传统AI仅能对话交互的局限，可直接执行终端命令、操作本地文件、控制浏览器、接入多平台消息渠道，真正实现“AI干活”的核心需求。无论是个人用户搭建专属AI助手，还是小型团队实现办公流程自动化，OpenClaw都能凭借其高度的自定义性和隐私安全性，成为最优选择之一。相较于依赖第三方云服务的AI工具，OpenClaw支持阿里云部署与本地多系统部署两种模式，阿里云部署可实现全天候稳定运行、多终端访问，本地部署则能确保数据完全本地化，避免敏感信息泄露，兼顾成本可控与自定义灵活度。

本文基于2026年OpenClaw最新稳定版（v2026.3），整合实测验证的部署流程、大模型API配置细节及常见问题解决方案，全面覆盖阿里云计算巢部署、本地MacOS、Linux、Windows11三大系统部署，同时详细讲解阿里云千问大模型API配置及市场上免费大模型Coding Plan API配置方法，全程无冗余内容、无营销词汇，步骤清晰可复现，助力新手快速完成部署与调试，顺利上手OpenClaw的核心功能与skills集成操作。目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

一、部署前核心准备（通用要求）

在启动任何部署操作前，需完成硬件、软件及核心凭证的准备工作，这是保障部署流程顺畅、避免后续出现兼容性问题或权限报错的关键前提，适用于阿里云部署与本地部署所有场景。

1.1 硬件配置要求（2026最新适配）

OpenClaw对硬件资源要求较低，主流个人设备与基础云服务器均可满足，具体配置要求如下，可根据实际使用场景（基础对话/复杂自动化任务）灵活调整：

1.2 核心软件依赖（必装，版本严格匹配）

OpenClaw基于Node.js开发，核心依赖版本需严格匹配，低版本会直接导致安装失败、服务无法启动，所有部署场景均需提前安装以下基础依赖，部分场景需额外安装补充依赖：

1. Node.js（强制必装）：作为OpenClaw运行的底层runtime，负责核心服务与前端界面渲染，版本必须≥22.x LTS（推荐v22.10.0长期支持版），低版本会出现依赖安装失败、服务启动报错等问题。

   • 安装命令（分系统）：
     • Windows（WSL2/Ubuntu子系统）：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
     • MacOS（Homebrew安装）：brew install node@22
     • Linux（Ubuntu）：curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
     • 验证命令：node -v，输出v22.x.x即为安装成功。

2. pnpm（推荐，替代npm）：OpenClaw官方推荐的包管理器，相比npm，依赖安装速度更快、占用空间更小，可避免npm依赖树卡死问题，提升部署效率。

   • 安装命令（全系统通用）：npm install -g pnpm
   • 验证命令：pnpm -v，输出正常版本号即为安装成功。

3. Git（可选，源码部署必装）：用于克隆OpenClaw官方仓库，适合需要二次开发、自定义skills的用户，基础部署可跳过。

   • 安装命令（分系统）：
     • Windows：官网下载Git安装包，双击安装并勾选“Add to PATH”
     • MacOS：brew install git
     • Linux（Ubuntu）：sudo apt install git
     • 验证命令：git --version，输出正常版本号即为安装成功。

4. Docker（可选，容器化部署必装）：实现环境隔离，避免与本地或云服务器上其他服务冲突，适合生产环境、多项目并行部署场景，基础部署可跳过。

   • 安装命令（分系统）：
     • Windows/MacOS：下载Docker Desktop安装包，双击安装并启动
     • Linux（Ubuntu）：curl -fsSL https://get.docker.com | bash
     • 验证命令：docker --version、docker compose version，输出正常版本号即为安装成功。

1.3 核心凭证准备（API配置必备）

部署完成后需配置大模型API以实现OpenClaw的智能交互与任务规划能力，需提前准备以下凭证，避免后续配置时中断操作：

1. 阿里云千问大模型API-Key：用于对接阿里云千问大模型，需提前注册阿里云账号并完成实名认证，访问登录阿里云百炼大模型服务平台开通百炼大模型服务后获取。
2. Coding Plan API-Key：市场上免费大模型API，可通过MiniMax开放平台订阅Coding Plan后获取，适合预算有限、无需高并发调用的用户。
3. 阿里云ECS相关凭证（仅阿里云部署需准备）：阿里云账号、ECS实例登录密码/密钥对、安全组配置权限，确保能正常登录ECS实例并配置端口。

二、2026年阿里云计算巢部署OpenClaw(Clawdbot)步骤流程

阿里云计算巢提供OpenClaw官方一键部署方案，可自动完成ECS实例创建、系统环境配置、OpenClaw安装及基础参数配置，无需手动调试依赖，是新手部署阿里云版本的最优选择，全程操作简单，无需复杂命令，具体步骤如下：

2.1 阿里云前期准备（必做）

1. 注册阿里云账号与实名认证：登录阿里云官网，完成账号注册，个人用户可通过身份证或支付宝授权完成实名认证，企业用户需上传营业执照、法人相关信息完成认证，审核周期1-3个工作日，未完成实名认证无法购买ECS资源及开通大模型服务。
2. 开通相关服务权限：登录阿里云控制台，在顶部搜索框输入“计算巢”“弹性计算（ECS）”“百炼大模型”，分别进入对应服务页面，按提示完成开通操作，确保账号拥有ECS实例创建、计算巢应用部署、百炼大模型调用的权限。
3. 费用保障：ECS云服务器采用按量付费或包年包月计费模式，百炼大模型调用会产生额外费用，需确保阿里云账号余额充足，或开通按量付费权限，新用户可申请ECS与百炼大模型的免费试用资源，降低测试成本。
4. 资源规划：
   • 地域选择：优先根据目标使用区域选择，例如华东地区用户优先选择华东1（杭州）地域，降低网络延迟；无需ICP备案可选择中国香港、新加坡等地域。
   • 实例规格：基础场景（简单对话、单一自动化任务）推荐2vCPU+4GiB内存，复杂场景（多skills集成、多任务并发）升级至4vCPU+8GiB及以上。
   • 存储配置：系统盘选择40GB及以上ESSD云盘，提升程序运行与缓存读写效率；需存储大量数据、日志的用户，可额外挂载100GB以上数据盘。
   • 网络配置：分配固定公网IPv4地址，带宽选择200Mbps及以上，确保模型调用、控制界面访问流畅。

阿里云用户零基础部署 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.2 计算巢一键部署操作（核心步骤）

1. 登录阿里云控制台，访问阿里云计算巢OpenClaw社区版部署页面，点击进入计算巢服务控制台，在服务列表中搜索“OpenClaw（原Clawdbot）”官方应用，点击“立即创建”，进入部署配置页面。
2. 基础信息配置：
   • 填写服务实例名称（长度≤4字符，以英文字母开头，可包含数字、短划线或下划线，如“Claw01”）。
   • 选择提前规划好的地域与可用区，优先选择资源充足的可用区，避免因可用区售罄导致创建失败。
   • 确认实例规格与存储配置，基础场景保持默认的2vCPU+4GiB内存、40GB ESSD系统盘，复杂场景按规划升级配置。
3. 网络与安全组配置：
   • 网络类型选择“专有网络”，若无已创建的专有网络与交换机，系统会自动创建，无需手动操作。
   • 安全组配置：重点放行OpenClaw核心运行端口，点击“添加规则”，分别添加以下两条规则：
     • 入方向：端口18789（网关通信与控制界面访问端口），授权对象选择“0.0.0.0/0”，允许所有IP访问；
     • 入方向：端口80（IM平台回调通信端口），授权对象选择“0.0.0.0/0”，确保后续对接IM工具时正常通信。
4. 登录配置：选择ECS实例的登录方式，推荐“密钥对登录”（更安全），若未创建密钥对，点击“创建密钥对”，下载密钥文件并妥善保存（仅下载一次，丢失无法找回）；也可选择“密码登录”，设置登录密码并牢记。
5. 确认部署：核对所有配置信息，确认无误后点击“确认创建”，系统会自动开始部署，部署过程约5-10分钟，期间可在计算巢控制台查看部署进度，显示“部署成功”即为完成。

2.3 阿里云部署后验证与基础配置

1. 服务访问：部署成功后，在计算巢控制台找到已创建的OpenClaw实例，复制ECS公网IP，在浏览器中输入“http://公网IP:18789”，即可进入OpenClaw控制界面，首次访问需完成初始化设置。
2. 初始化设置：
   • 安全确认：输入“Yes”确认授权OpenClaw访问系统资源，完成基础权限配置。
   • 配置模式：选择“QuickStart”快速启动模式，使用默认配置，新手无需自定义，后续可在配置文件中修改。
   • 消息渠道：可先跳过，后续需对接钉钉、飞书等IM工具时再进行配置。
3. 服务状态验证：登录ECS实例（密钥对登录命令：ssh -i 密钥文件路径 root@ECS公网IP），执行命令openclaw status，输出“running”即为服务正常运行；若显示“stopped”，执行命令openclaw start启动服务。

三、2026年本地多系统部署OpenClaw(Clawdbot)步骤流程

本地部署OpenClaw可实现数据完全本地化，无需依赖云服务，适合注重隐私安全、无需全天候远程访问的用户，以下分别详细讲解MacOS、Linux、Windows11三大系统的部署步骤，均提供三种部署方案，适配不同技术水平用户，步骤可复现、避坑性强。

3.1 MacOS系统部署（适配Intel/Apple Silicon芯片）

MacOS系统部署OpenClaw兼容性较好，支持一键脚本、npm手动、Docker容器化三种方案，新手优先选择一键脚本部署，开发者可选择npm手动部署用于二次开发，环境隔离需求可选择Docker部署。

3.1.1 前置准备（必做）

1. 安装Xcode命令行工具：打开终端，执行命令xcode-select --install，在弹出的对话框中点击“安装”，完成后即可正常执行后续命令。
2. 安装Homebrew（推荐）：若未安装Homebrew，执行命令/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，安装完成后验证：brew -v。
3. 验证系统环境：执行以下命令，确认系统版本、芯片架构及Node.js安装情况：

   # 查看MacOS版本
   sw_vers
   # 查看芯片架构（Apple Silicon输出arm64，Intel输出x86_64）
   uname -m
   # 验证Node.js版本
   node -v
   

3.1.2 方案一：一键脚本部署（新手首选，5分钟完成）

1. 打开终端，执行以下命令（二选一，推荐汉化版，适配中文用户）：
   • 官方原版脚本：curl -fsSL https://openclaw.ai/install.sh | bash
   • 汉化版脚本：curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh | bash
2. 脚本自动执行以下操作，无需手动干预：
   • 检测系统架构，适配Apple Silicon/Intel芯片；
   • 检查并自动安装Node.js 22+（若未安装）；
   • 下载并安装OpenClaw最新稳定版；
   • 配置环境变量，确保终端可直接执行OpenClaw命令。
3. 安装验证：执行以下命令，确认安装成功：

   # 查看OpenClaw版本
   openclaw --version
   # 查看OpenClaw帮助信息
   openclaw --help
   # 查看服务状态
   openclaw status
   

4. 启动服务：执行命令openclaw start，启动成功后，在浏览器中输入“http://localhost:18789”，进入OpenClaw控制界面，完成初始化设置（同阿里云部署初始化步骤）。

3.1.3 方案二：npm手动部署（开发者首选，自定义性强）

1. 安装Node.js 22+（若未安装），推荐使用nvm管理Node.js版本，执行以下命令：

   # 安装nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
   # 激活nvm
   source ~/.zshrc（或~/.bashrc，根据默认Shell类型选择）
   # 安装Node.js 22
   nvm install 22
   # 切换至Node.js 22版本
   nvm use 22
   

2. 安装OpenClaw，根据需求选择版本（稳定版/汉化版/Nightly版）：

   # 稳定版（推荐）
   npm install -g openclaw@latest
   # 汉化版
   npm install -g @qingchencloud/openclaw-zh@latest
   # Nightly版（开发版，含最新功能，不稳定）
   npm install -g openclaw@nightly
   

3. 解决Apple Silicon芯片编译问题：若安装过程中出现sharp模块编译错误，执行以下命令：

   # 重置Xcode路径
   sudo xcode-select --reset
   # 强制重新安装OpenClaw
   npm install -g openclaw --force
   

4. 验证与启动：执行openclaw --version确认安装成功，执行openclaw start启动服务，访问“http://localhost:18789”完成初始化。

3.1.4 方案三：Docker容器化部署（环境隔离，适合多项目并行）

1. 安装Docker Desktop：从Docker官网下载MacOS版本安装包，双击安装并启动，启动后在状态栏可见Docker图标，显示“Running”即为正常。
2. 验证Docker环境：执行以下命令，确认Docker安装成功：

   docker --version
   docker info
   

3. 创建Docker数据卷（用于存储OpenClaw配置文件与数据）：

   docker volume create openclaw-data
   

4. 初始化OpenClaw配置：

   docker run --rm -v openclaw-data:/root/.openclaw \
   openclaw/openclaw:nightly \
   openclaw setup
   

5. 启动Docker容器：

   docker run -d --name openclaw \
   -p 18789:18789 \
   -v openclaw-data:/root/.openclaw \
   --restart unless-stopped \
   openclaw/openclaw:nightly \
   openclaw gateway run
   

6. Docker常用命令（后续管理用）：

   # 查看容器日志
   docker logs -f openclaw
   # 进入容器终端
   docker exec -it openclaw sh
   # 重启容器
   docker restart openclaw
   # 停止容器
   docker stop openclaw
   # 删除容器
   docker rm openclaw
   

7. 访问验证：浏览器输入“http://localhost:18789”，完成初始化设置，即可使用OpenClaw。

3.2 Linux系统部署（以Ubuntu 22.04为例，适配所有Linux发行版）

Linux系统部署OpenClaw稳定性最高，适合长期运行，同样提供三种部署方案，新手推荐一键脚本部署，生产环境推荐Docker容器化部署，具体步骤如下：

3.2.1 前置准备（必做）

1. 更新系统软件包：执行以下命令，确保系统软件包处于最新状态，避免依赖冲突：

   sudo apt update && sudo apt upgrade -y
   

2. 安装核心依赖：参考1.2节，安装Node.js 22+、pnpm，若选择源码部署或Docker部署，额外安装Git、Docker。
3. 关闭防火墙（临时，避免端口拦截）：

   sudo ufw disable
   # 验证防火墙状态，输出inactive即为关闭
   sudo ufw status
   

   （注：生产环境可无需关闭防火墙，仅放行18789、80端口即可，命令：sudo ufw allow 18789 && sudo ufw allow 80）

3.2.2 方案一：一键脚本部署（新手首选）

1. 打开终端，执行官方一键安装脚本：

   curl -fsSL https://openclaw.ai/install.sh | bash
   

2. 脚本自动完成环境检测、依赖安装、OpenClaw部署，无需手动干预，安装完成后执行以下命令验证：

   openclaw --version
   openclaw status
   

3. 启动服务并设置开机自启：

   # 启动服务
   openclaw start
   # 设置开机自启（避免重启系统后服务停止）
   sudo systemctl enable openclaw
   sudo systemctl start openclaw
   # 验证开机自启配置
   sudo systemctl status openclaw
   

4. 访问验证：浏览器输入“http://服务器IP:18789”（本地部署输入“http://localhost:18789”），完成初始化设置。

3.2.3 方案二：npm手动部署（开发者首选）

1. 安装Node.js 22+，执行以下命令：

   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
   sudo apt install -y nodejs
   # 验证Node.js版本
   node -v
   

2. 安装pnpm与OpenClaw：

   npm install -g pnpm
   pnpm install -g openclaw@latest
   

3. 验证安装：openclaw --version，若输出正常版本号，说明安装成功。
4. 启动服务：openclaw start，访问“http://localhost:18789”完成初始化。

3.2.4 方案三：Docker容器化部署（生产环境首选）

1. 安装Docker与Docker Compose：

   # 安装Docker
   curl -fsSL https://get.docker.com | bash
   # 启动Docker服务并设置开机自启
   sudo systemctl enable docker
   sudo systemctl start docker
   # 验证Docker
   docker --version
   # 安装Docker Compose
   sudo apt install docker-compose -y
   docker-compose --version
   

2. 创建Docker数据卷与配置文件：

   # 创建数据卷
   docker volume create openclaw-data
   # 初始化配置
   docker run --rm -v openclaw-data:/root/.openclaw openclaw/openclaw:nightly openclaw setup
   

3. 启动容器：

   docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw --restart unless-stopped openclaw/openclaw:nightly openclaw gateway run
   

4. 验证容器状态：docker ps，若显示openclaw容器处于“Up”状态，说明启动成功，访问“http://服务器IP:18789”即可使用。

3.3 Windows11系统部署（推荐WSL2，避免原生环境兼容性问题）

Windows11原生环境部署OpenClaw易出现权限、路径、兼容性问题，强烈推荐使用WSL2（Ubuntu 22.04子系统）部署，步骤与Linux系统一致；若需原生环境部署，也可参考以下步骤，全程需以管理员身份操作。

3.3.1 方案一：WSL2（Ubuntu 22.04）部署（推荐）

1. 启用WSL2：以管理员身份打开PowerShell，执行以下命令，重启电脑后自动安装Ubuntu 22.04子系统：

   wsl --install
   

2. 启动Ubuntu子系统：重启电脑后，在开始菜单找到“Ubuntu 22.04 LTS”，打开后设置用户名与密码，完成初始化。
3. 后续部署步骤：完全参考3.2节Linux系统部署步骤（一键脚本、npm手动、Docker均可），此处不再重复，核心命令与Linux系统一致。

3.3.2 方案二：Windows11原生环境部署（不推荐，兼容性差）

1. 前置准备：
   • 解锁PowerShell执行策略：以管理员身份打开PowerShell，执行命令Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，输入“Yes”确认。
   • 安装Node.js 22+：从Node.js官网下载Windows安装包，双击安装，勾选“Add to PATH”，安装完成后验证：node -v。
   • 安装pnpm：npm install -g pnpm，验证：pnpm -v。
2. 一键脚本部署：
   • 以管理员身份打开Command Prompt（CMD），执行以下命令：

     curl -fsSL https://openclaw.ai/install.sh | bash
     

   • 若脚本执行失败，切换至PowerShell，执行相同命令，若仍失败，建议改用WSL2部署。
3. npm手动部署：

   npm install -g openclaw@latest
   

4. 启动服务与验证：

   # 启动服务
   openclaw start
   # 验证服务状态
   openclaw status
   

5. 访问验证：浏览器输入“http://localhost:18789”，完成初始化设置，若无法访问，检查Windows防火墙是否放行18789端口。

四、大模型API配置步骤（阿里云千问+免费Coding Plan）

OpenClaw的智能交互、任务规划及skills集成能力，依赖大模型API提供支持，本文提供两种配置方案，用户可根据自身需求选择：阿里云千问大模型（稳定性高、功能全面）、免费Coding Plan API（零成本、适合测试与基础使用），两种方案均详细讲解配置步骤，确保新手可顺利完成。

4.1 阿里云千问大模型API配置（2026最新）

阿里云千问大模型（通义千问3-Max、通义千问3-Coder-Plus等）兼容性强，可完美适配OpenClaw，支持复杂任务推理与多skills集成，配置步骤如下：

4.1.1 获取阿里云千问API-Key（必做）

1. 访问登录阿里云百炼大模型服务平台，若未开通百炼服务，按提示完成开通（需完成实名认证）。
2. 进入“密钥管理”页面（默认地域为华北2（北京），可根据部署地域选择邻近地域，降低网络延迟）。
3. 点击“创建API-Key”，系统自动生成一组API-Key凭证（含Access Key ID与Access Key Secret），点击“复制”分别保存至记事本，重要提醒：API-Key仅生成时可完整查看，后续无法再次获取，需严格保密，避免泄露导致模型调用额度被盗用；若怀疑泄露，需立即禁用旧密钥并重新创建。

4.1.2 API配置（分部署场景）

4.1.2.1 阿里云部署（计算巢）配置

1. 登录ECS实例，执行以下命令，打开OpenClaw主配置文件：

    nano ~/.openclaw/openclaw.json

1. 在配置文件中找到“model”节点，修改为以下内容（替换为自己的API-Key）：

    "model": {
   
      "provider": "dashscope",
      "model": "qwen-max",
      "apiKey": "你的阿里云千问API-Key",
      "baseUrl": "https://dashscope.aliyuncs.com/api/v1"
    }

1. 保存并退出配置文件：按“Ctrl+X”，输入“Y”，按“Enter”确认。
2. 重启OpenClaw服务，使配置生效：

    openclaw restart
    # 验证配置是否生效
    openclaw logs | grep "model initialized"

若输出“model initialized successfully”，说明配置成功。

4.1.2.2 本地部署（MacOS/Linux/Windows11）配置

1. 打开终端（MacOS/Linux）或PowerShell（Windows11），执行以下命令，打开OpenClaw主配置文件：
   • MacOS/Linux：nano ~/.openclaw/openclaw.json
   • Windows11（WSL2）：nano ~/.openclaw/openclaw.json
   • Windows11原生：notepad %USERPROFILE%/.openclaw/openclaw.json
2. 同阿里云部署配置，修改“model”节点，替换为自己的API-Key，保存退出。
3. 重启OpenClaw服务：
   • MacOS/Linux/Windows11（WSL2）：openclaw restart
   • Windows11原生：openclaw restart
4. 验证配置：执行openclaw logs | grep "model initialized"，输出成功信息即为配置生效。

4.1.3 环境变量配置（推荐，提升安全性）

为避免API-Key直接暴露在配置文件中，推荐将API-Key配置为系统环境变量，步骤如下：

1. MacOS/Linux（Zsh/Bash）：

    # 打开环境变量配置文件（Zsh用~/.zshrc，Bash用~/.bashrc）
    nano ~/.zshrc
    # 添加环境变量（替换为自己的API-Key）
    export DASHSCOPE_API_KEY="你的阿里云千问API-Key"
    # 保存生效
    source ~/.zshrc
    # 验证环境变量
    echo $DASHSCOPE_API_KEY

1. Windows11（PowerShell）：

    # 临时环境变量（仅当前会话有效）
    $env:DASHSCOPE_API_KEY="你的阿里云千问API-Key"
    # 永久环境变量（所有会话有效）
    [Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "你的阿里云千问API-Key", "User")
    # 验证环境变量
    echo $env:DASHSCOPE_API_KEY

1. 修改OpenClaw配置文件，引用环境变量：

    "model": {
   
      "provider": "dashscope",
      "model": "qwen-max",
      "apiKey": "${DASHSCOPE_API_KEY}",
      "baseUrl": "https://dashscope.aliyuncs.com/api/v1"
    }

1. 重启OpenClaw服务，验证配置生效。

4.2 免费大模型Coding Plan API配置（MiniMax）

Coding Plan是MiniMax开放平台提供的免费大模型API，支持文本交互、基础任务推理，零成本适合测试与基础使用，配置步骤如下：

4.2.1 获取Coding Plan API-Key（必做）

1. 访问MiniMax开放平台，完成账号注册与登录（支持手机号、邮箱注册）。
2. 进入“Coding Plan”页面，订阅免费Coding Plan套餐（无需付费，直接订阅即可）。
3. 进入“接口密钥”页面，点击“创建Coding Plan Key”，生成API-Key，复制并保存（仅自己可见，妥善保管），注意：此API-Key为Coding Plan专属，仅适用于文本模型，与按量计费API-Key不互通，仅在订阅有效期内有效。

4.2.2 API配置（全部署场景通用）

1. 打开OpenClaw主配置文件（步骤同4.1.2），找到“model”节点，修改为以下内容（替换为自己的Coding Plan API-Key）：

   "model": {
        
     "provider": "anthropic",
     "model": "MiniMax-M2.1",
     "apiKey": "你的Coding Plan API-Key",
     "baseUrl": "https://api.minimaxi.com/anthropic"
   }
   

2. 保存并退出配置文件，重启OpenClaw服务：openclaw restart。
3. 验证配置：执行以下命令，测试API调用是否正常：

   # 执行测试命令
   openclaw model test
   

   若输出正常的模型响应内容，说明配置成功；若提示“API Key invalid”，检查API-Key是否正确，或订阅是否有效。

4.2.3 API调用测试（可选）

可通过Python/Node.js脚本测试Coding Plan API是否正常，确保配置无误：

1. Python测试脚本：

   # 先安装Anthropic SDK
   # pip install anthropic
   import anthropic
   
   client = anthropic.Anthropic(
       api_key="你的Coding Plan API-Key",
       base_url="https://api.minimaxi.com/anthropic"
   )
   
   message = client.messages.create(
       model="MiniMax-M2.1",
       max_tokens=1000,
       system="You are a helpful assistant.",
       messages=[
           {
        
               "role": "user",
               "content": [{
        "type": "text", "text": "测试API调用，输出Hello World"}]
           }
       ]
   )
   
   for block in message.content:
       if block.type == "text":
           print(f"模型响应：{block.text}")
   

2. Node.js测试脚本：

   // 先安装Anthropic SDK
   // npm install @anthropic-ai/sdk
   const {
         Anthropic } = require("@anthropic-ai/sdk");
   
   const anthropic = new Anthropic({
        
       apiKey: "你的Coding Plan API-Key",
       baseURL: "https://api.minimaxi.com/anthropic"
   });
   
   async function testApi() {
        
       const message = await anthropic.messages.create({
        
           model: "MiniMax-M2.1",
           max_tokens: 1000,
           system: "You are a helpful assistant.",
           messages: [
               {
        
                   "role": "user",
                   "content": [{
        "type": "text", "text": "测试API调用，输出Hello World"}]
               }
           ]
       });
       console.log("模型响应：", message.content[0].text);
   }
   
   testApi();
   

五、OpenClaw(Clawdbot)常见问题解答（2026最新，避坑重点）

结合2026年OpenClaw最新版本特性及实测踩坑经验，整理以下常见问题，涵盖部署、API配置、服务运行、skills集成等核心场景，提供详细解决方案，帮助新手快速排查问题，避免走弯路。

5.1 部署相关问题

问题1：安装OpenClaw时，提示“Node.js版本过低”

• 原因：Node.js版本低于22.x，OpenClaw v2026.3强制要求Node.js≥22.x LTS。
• 解决方案：卸载当前低版本Node.js，重新安装Node.js 22.x LTS版本，具体命令参考1.2节，安装完成后执行node -v验证版本。

问题2：Windows11原生部署时，脚本执行失败，提示“权限不足”

• 原因：未以管理员身份运行终端/CMD，或PowerShell执行策略未解锁。
• 解决方案：以管理员身份打开PowerShell，执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，输入“Yes”确认，再重新执行安装脚本；若仍失败，改用WSL2部署（推荐）。

问题3：Docker部署时，容器启动失败，日志提示“端口18789已被占用”

• 原因：本地或云服务器上其他服务已占用18789端口，OpenClaw无法正常绑定端口。
• 解决方案：
  1. 查找占用18789端口的服务：
     • MacOS/Linux：sudo lsof -i:18789
     • Windows11：netstat -ano | findstr "18789"
  2. 停止占用端口的服务，或修改OpenClaw端口（修改配置文件openclaw.json中的“port”字段，重启服务）。

问题4：阿里云计算巢部署后，无法访问“http://公网IP:18789”

• 原因：安全组未放行18789端口，或ECS实例防火墙拦截端口，或服务未启动。
• 解决方案：
  1. 登录阿里云控制台，进入ECS实例安全组，确认已添加18789端口入方向规则，授权对象为“0.0.0.0/0”。
  2. 登录ECS实例，执行sudo ufw allow 18789（Linux系统），放行端口。
  3. 执行openclaw status，若服务未启动，执行openclaw start启动服务。

5.2 API配置相关问题

问题1：配置阿里云千问API后，提示“API Key invalid”

• 原因：API-Key输入错误、API-Key已过期或被禁用、配置文件中baseUrl错误。
• 解决方案：
  1. 核对API-Key，确保无多余空格、拼写错误，重新复制粘贴。
  2. 登录阿里云百炼平台，检查API-Key状态，若已禁用，重新创建API-Key。
  3. 确认配置文件中baseUrl为“https://dashscope.aliyuncs.com/api/v1”，不可修改。

问题2：配置Coding Plan API后，模型调用无响应，提示“baseUrl invalid”

• 原因：Coding Plan API的baseUrl配置错误，或API-Key未订阅Coding Plan套餐。
• 解决方案：
  1. 确认配置文件中baseUrl为“https://api.minimaxi.com/anthropic”，不可修改。
  2. 登录MiniMax开放平台，检查Coding Plan订阅状态，确保已成功订阅，API-Key为Coding Plan专属。

问题3：环境变量配置后，OpenClaw无法读取API-Key

• 原因：环境变量未生效，或配置文件中API-Key引用格式错误。
• 解决方案：
  1. 执行echo $DASHSCOPE_API_KEY（MacOS/Linux）或echo $env:DASHSCOPE_API_KEY（Windows11），验证环境变量是否生效，若未生效，重新执行source ~/.zshrc（MacOS/Linux）或重启终端（Windows11）。
  2. 检查配置文件中API-Key引用格式，确保为"apiKey": "${DASHSCOPE_API_KEY}"，不可遗漏${}。

5.3 服务运行相关问题

问题1：OpenClaw服务启动后，很快自动停止，日志提示“内存不足”

• 原因：设备内存低于最低要求（4GB），或同时运行其他占用内存的服务，导致内存不足。
• 解决方案：
  1. 关闭其他占用内存的服务，释放内存。
  2. 升级设备内存（本地部署），或升级ECS实例规格（阿里云部署），推荐升级至8GB内存。

问题2：访问OpenClaw控制界面，提示“初始化失败”

• 原因：服务未完全启动，或配置文件损坏，或大模型API配置错误。
• 解决方案：
  1. 执行openclaw restart，重启服务，等待3-5分钟后再访问。
  2. 备份配置文件~/.openclaw/openclaw.json，删除原文件，执行openclaw setup重新初始化配置。
  3. 检查大模型API配置，确保参数正确，重启服务后重试。

问题3：执行OpenClaw命令时，提示“command not found”

• 原因：环境变量未配置，OpenClaw可执行文件未加入系统PATH。
• 解决方案：
  1. MacOS/Intel芯片：执行export PATH=/usr/local/bin:$PATH，再执行openclaw --version。
  2. MacOS/Apple Silicon芯片：执行export PATH=/opt/homebrew/bin:$PATH，再执行openclaw --version。
  3. Linux/Windows11（WSL2）：执行export PATH=$HOME/.npm-global/bin:$PATH，再执行openclaw --version。
  4. 若仍失败，重新安装OpenClaw，确保安装过程中环境变量配置成功。

5.4 skills集成相关问题

问题1：无法添加skills，提示“权限不足”

• 原因：OpenClaw未获得系统资源访问权限，或skills插件版本与OpenClaw版本不兼容。
• 解决方案：
  1. 本地部署：授予OpenClaw文件访问、终端执行权限（MacOS在“系统设置-隐私与安全性”中添加权限；Windows11以管理员身份启动服务）。
  2. 阿里云部署：执行sudo chmod -R 777 ~/.openclaw/skills，赋予skills目录读写权限。
  3. 确保skills插件版本与OpenClaw v2026.3兼容，从官方仓库下载最新版skills。

问题2：添加skills后，无法执行相关操作，提示“插件加载失败”

• 原因：skills插件依赖未安装，或插件配置错误。
• 解决方案：
  1. 进入skills插件目录（~/.openclaw/skills），查看插件README文件，安装所需依赖。
  2. 检查插件配置文件，确保参数正确，重启OpenClaw服务后重试。

六、总结

本文基于2026年OpenClaw最新稳定版，全面覆盖阿里云计算巢部署与本地MacOS、Linux、Windows11三大系统部署流程，提供三种部署方案适配不同技术水平用户，同时详细讲解阿里云千问大模型API与免费Coding Plan API的配置方法，结合实测踩坑经验整理常见问题解决方案，全程无营销词汇、步骤清晰可复现，无需复杂的技术基础，新手也能快速完成部署与调试。

OpenClaw作为开源自托管AI智能体平台，其核心价值在于数据本地化、自定义灵活度高、成本可控，无论是个人搭建专属AI助手，还是小型团队实现办公自动化，都能满足需求。后续可根据自身需求，进一步探索OpenClaw的skills集成、IM工具对接等高级功能，充分发挥其“AI干活”的核心优势。