OpenClaw（原Clawdbot、Moltbot）是一款开源、可自托管的AI智能体框架，核心功能在于通过自然语言驱动实现全场景自动化，支持代码编写、文件处理、数据分析、系统管理等多样化任务，可灵活适配云端与本地部署场景。其显著优势在于数据本地化可控、自定义程度高，且2026年最新稳定版（v2026.3）进一步优化了阿里云生态适配性，完美兼容阿里云轻量服务器与阿里云百炼大模型，同时支持本地MacOS、Linux、Windows11三大系统部署，兼顾长期稳定运行与隐私安全需求。
本文基于2026年最新实测经验，结合全网技术资料，全面拆解OpenClaw的全场景部署流程，重点讲解阿里云轻量服务器部署（适合7×24小时公网访问、团队共享）、本地多系统部署（适合隐私优先、离线使用），详细说明阿里云百炼（千问大模型）API与免费Coding Plan（MiniMax）API的配置步骤，同步整理部署、API配置、服务运行中的高频问题与避坑技巧，全程无营销词汇、步骤清晰可复现，代码可直接复制执行，零基础用户也能快速完成部署与调试，顺利解锁OpenClaw的核心功能。目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
一、部署前核心准备（通用要求，全场景适用）
无论选择阿里云轻量服务器部署还是本地部署，提前完成硬件、软件与核心凭证准备，是避免后续出现兼容性报错、权限不足、API调用失败的关键，所有部署场景均需遵循以下要求，确保流程顺畅。
1.1 硬件配置要求（2026最新适配）
OpenClaw对硬件资源要求较低，阿里云轻量服务器基础规格与主流个人设备均可满足，可根据使用场景（基础交互/复杂自动化/多任务并发）灵活调整，具体配置如下：
| 配置项 | 最低要求 | 推荐配置 | 备注 |
|---|---|---|---|
| 操作系统 | 阿里云轻量服务器（Ubuntu 20.04+/CentOS 8+）、Windows 10+/macOS 12+/Ubuntu 20.04+ | 阿里云轻量服务器（Ubuntu 22.04）、Windows 11/macOS 14+/Ubuntu 22.04 | 阿里云轻量服务器推荐Ubuntu系统，稳定性更高；Windows原生环境兼容性较差，本地部署优先选WSL2；macOS支持Intel/Apple Silicon芯片 |
| CPU | 2核及以上 | 4核及以上 | 复杂任务、多插件运行、本地模型推理需更高算力，阿里云轻量服务器可按需升级规格 |
| 内存 | 4GB | 8GB+ | 服务启动、模型缓存及插件运行需充足内存，内存不足会导致服务崩溃或卡顿 |
| 磁盘空间 | 10GB空闲 | 20GB+ | 包含程序安装包、依赖文件、运行日志，阿里云轻量服务器需预留额外空间用于系统备份与数据存储 |
| 网络 | 稳定联网 | 阿里云轻量服务器带宽10Mbps+、本地有线网络/5G WiFi | 依赖下载、API调用、远程访问需稳定网络，阿里云轻量服务器海外节点（香港/新加坡）免备案，公网访问更便捷 |
1.2 核心软件依赖（必装，版本严格匹配）
OpenClaw基于Node.js开发，核心依赖版本直接影响部署成败，低版本会导致依赖安装失败、服务无法启动，所有部署场景均需提前安装以下基础依赖：
Node.js（强制必装）：作为OpenClaw运行的底层环境，版本必须≥22.x LTS（推荐v22.10.0长期支持版），低版本会出现兼容性问题。
- 安装命令（分系统）：
- 阿里云轻量服务器（Ubuntu/CentOS）/Linux（Ubuntu）：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs - Windows 11：官网下载Node.js安装包，双击安装并勾选“Add to PATH”（自动配置环境变量）
- MacOS（Homebrew安装）：
brew install node@22 - 验证命令：
node -v，输出v22.x.x即为安装成功。
- 阿里云轻量服务器（Ubuntu/CentOS）/Linux（Ubuntu）：
- 安装命令（分系统）：
pnpm（推荐，替代npm）：OpenClaw官方推荐的包管理器，相比npm，依赖安装速度更快、占用空间更小，可避免依赖树卡死问题。
- 安装命令（全系统通用）：
npm install -g pnpm - 验证命令：
pnpm -v，输出正常版本号即为安装成功。
- 安装命令（全系统通用）：
Git（可选，源码部署/插件手动安装必装）：用于克隆OpenClaw官方仓库与插件资源，适合需要二次开发、自定义插件的用户，基础部署可跳过。
- 安装命令（分系统）：
- 阿里云轻量服务器（Ubuntu）/Linux（Ubuntu）：
sudo apt install git -y - Windows 11：官网下载Git安装包，双击安装并勾选“Add to PATH”
- MacOS：
brew install git - 验证命令：
git --version，输出正常版本号即为安装成功。
- 阿里云轻量服务器（Ubuntu）/Linux（Ubuntu）：
- 安装命令（分系统）：
Docker（可选，容器化部署必装）：实现环境隔离，避免与阿里云轻量服务器或本地设备上其他服务冲突，适合生产环境、多项目并行部署场景，基础部署可跳过。
- 安装命令（分系统）：
- 阿里云轻量服务器（Ubuntu）/Linux（Ubuntu）：
curl -fsSL https://get.docker.com | bash - Windows 11/MacOS：下载Docker Desktop安装包，双击安装并启动
- 验证命令：
docker --version、docker compose version，输出正常版本号即为安装成功。
- 阿里云轻量服务器（Ubuntu）/Linux（Ubuntu）：
- 安装命令（分系统）：
1.3 核心凭证准备（API配置必备）
部署完成后，需配置大模型API以激活OpenClaw的智能交互与任务规划能力，需提前准备以下凭证，避免配置时中断操作：
- 阿里云百炼API-Key：用于对接阿里云千问大模型（通义千问3-Max、通义千问3-Coder-Plus等），需注册阿里云账号并完成实名认证，访问登录阿里云百炼大模型服务平台开通百炼大模型服务后获取，首次开通可领取新人免费额度（有效期90天）。
- Coding Plan API-Key：MiniMax开放平台提供的免费大模型API，零成本适合测试与基础使用，兼容OpenClaw的Anthropic接口协议，订阅免费套餐后即可获取。
- 阿里云轻量服务器相关凭证（仅阿里云部署需准备）：阿里云账号、轻量服务器登录密码/密钥、服务器公网IP，确保能正常登录服务器并配置端口、防火墙。
二、2026年阿里云轻量服务器部署OpenClaw(Clawdbot)步骤流程
阿里云轻量服务器部署适合需要7×24小时在线、公网访问、团队共享的场景，2026年优化后支持一键部署与手动部署两种方案，新手首选一键部署（无需手动配置环境），开发者可选择手动部署实现自定义配置，全程包含可复制的代码命令，零技术基础也能操作。
2.1 阿里云轻量服务器前期准备（必做）
- 注册阿里云账号与实名认证：登录阿里云官网，完成账号注册，个人用户可通过身份证或支付宝授权完成实名认证，未完成实名认证无法购买轻量服务器、开通百炼大模型服务。
- 轻量服务器实例购买与配置：
- 登录阿里云控制台，搜索“轻量应用服务器”，点击“创建实例”，选择“应用镜像”，找到“OpenClaw（Clawdbot）2026官方镜像”（已预装基础环境，无需手动安装依赖）。
- 实例规格选择：基础场景推荐2核4GB内存、40GB ESSD系统盘、10Mbps带宽；复杂场景（多插件、高并发）推荐4核8GB内存、80GB ESSD系统盘、20Mbps带宽。
- 地域选择：优先选择海外节点（中国香港/新加坡/美国弗吉尼亚），免备案，公网访问无限制；国内节点需完成ICP备案后才能正常访问。
- 登录配置：设置服务器登录密码或绑定密钥对，牢记登录凭证，完成支付后，等待5-10分钟，实例状态变为“运行中”，记录服务器公网IP（后续访问与配置需用到）。
- 防火墙端口放行：OpenClaw默认使用18789端口提供Web服务，必须放行该端口，否则无法访问控制界面：
- 进入轻量服务器实例详情页，找到“防火墙”选项，点击“添加规则”。
- 协议选择TCP，端口填写18789，策略选择“允许”，授权对象填写“0.0.0.0/0”（允许所有IP访问），保存生效。
阿里云用户零基础部署 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 方案一：一键部署（新手首选，10分钟完成）
阿里云轻量服务器的OpenClaw官方镜像已预装所有基础依赖与程序，一键部署仅需完成初始化配置与服务启动，步骤如下：
- SSH登录服务器：使用SSH工具（FinalShell/Xshell）或本地终端，执行以下命令登录（替换为你的服务器公网IP）：
输入服务器登录密码，确认登录（首次登录会提示确认密钥，输入“yes”即可）。ssh root@你的服务器公网IP - 系统更新与环境验证：执行以下命令，更新系统软件包，验证依赖是否正常：
# 更新系统软件包 sudo apt update && sudo apt upgrade -y # 验证Node.js版本 node -v # 验证pnpm版本 pnpm -v # 验证OpenClaw是否预装成功 openclaw --version - 初始化OpenClaw配置：执行以下命令，启动配置向导，按提示完成基础设置：
配置向导操作步骤（新手直接按以下选择，无需自定义）：openclaw onboard- 提示“I understand this is powerful and inherently risky. Continue?”，选择Yes
- Onboarding mode，选择QuickStart
- Model/auth provider，选择Skip for now（后续配置百炼API）
- Filter models by provider，选择All providers
- Default model，选择Keep current
- Select channel (QuickStart)，选择Skip for now
- Configure skills now? (recommended)，选择No
- Enable hooks?，按空格键选中，按回车键进入下一步
- How do you want to hatch your bot?，选择Do this later
- 启动服务并设置开机自启：
若输出“active (running)”，说明服务启动成功；若显示“failed”，执行# 启动OpenClaw服务 sudo systemctl start openclaw # 设置开机自启（避免重启服务器后服务停止） sudo systemctl enable openclaw # 查看服务状态，确认是否正常运行 sudo systemctl status openclawjournalctl -u openclaw查看报错信息，针对性解决。 - 访问验证：打开本地浏览器，输入“http://你的服务器公网IP:18789”，首次访问需生成访问Token，执行以下命令：
复制生成的Token，在浏览器地址栏输入“http://你的服务器公网IP:18789/?token=你的Token”，进入OpenClaw控制界面，即为部署成功。openclaw token generate
2.3 方案二：手动部署（开发者首选，自定义性强）
若需自定义配置环境、修改服务端口或进行二次开发，可选择手动部署，步骤如下（基于Ubuntu 22.04系统）：
- SSH登录服务器：同2.2.1步骤，登录服务器后，执行系统更新：
sudo apt update && sudo apt upgrade -y - 安装核心依赖：参考1.2节，执行以下命令安装Node.js 22+、pnpm，若选择Docker部署，额外安装Docker：
# 安装Node.js 22+ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs # 安装pnpm npm install -g pnpm # （可选）安装Docker curl -fsSL https://get.docker.com | bash # 验证依赖安装 node -v && pnpm -v - 安装OpenClaw：执行以下命令，安装最新稳定版OpenClaw：
pnpm install -g openclaw@latest # 验证安装成功 openclaw --version - 初始化配置：执行
openclaw onboard，按2.2.3步骤完成配置向导，或手动编辑配置文件：
根据需求修改配置（如端口、存储路径等），保存退出（Ctrl+X→输入Y→Enter）。# 打开配置文件 nano ~/.openclaw/openclaw.json - 启动服务与设置开机自启：同2.2.4步骤，启动服务并验证状态，确保服务正常运行。
- 访问验证：同2.2.5步骤，通过浏览器访问控制界面，完成部署。
三、2026年本地多系统部署OpenClaw(Clawdbot)步骤流程
本地部署可实现数据完全本地化，无需依赖云服务，适合注重隐私安全、无需全天候远程访问的用户，以下分别详细讲解MacOS、Linux、Windows11三大系统的部署步骤，均提供一键脚本与手动部署两种方案，适配不同技术水平用户，避坑性强。
3.1 MacOS系统部署（适配Intel/Apple Silicon芯片）
MacOS系统部署OpenClaw兼容性较好，无需复杂配置，新手优先选择一键脚本部署，开发者可选择手动部署用于二次开发，具体步骤如下：
3.1.1 前置准备（必做）
- 安装Xcode命令行工具：打开终端，执行命令
xcode-select --install，在弹出的对话框中点击“安装”，完成后即可正常执行后续命令（解决编译依赖问题）。 - 安装Homebrew（推荐）：若未安装Homebrew，执行以下命令安装，方便后续依赖管理：
安装完成后验证：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"brew -v，输出正常版本号即为安装成功。 - 验证系统环境：执行以下命令，确认系统版本、芯片架构及Node.js安装情况：
# 查看MacOS版本 sw_vers # 查看芯片架构（Apple Silicon输出arm64，Intel输出x86_64） uname -m # 验证Node.js版本 node -v
3.1.2 方案一：一键脚本部署（新手首选，5分钟完成）
- 打开终端，执行以下命令（二选一，推荐汉化版，适配中文用户）：
- 官方原版脚本：
curl -fsSL https://openclaw.ai/install.sh | bash - 汉化版脚本：
curl -fsSL https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh | bash
- 官方原版脚本：
- 脚本自动执行以下操作，无需手动干预：
- 检测系统架构，适配Apple Silicon/Intel芯片；
- 检查并自动安装Node.js 22+（若未安装）；
- 下载并安装OpenClaw最新稳定版；
- 配置环境变量，确保终端可直接执行OpenClaw命令。
- 安装验证：执行以下命令，确认安装成功：
# 查看OpenClaw版本 openclaw --version # 查看服务状态 openclaw status - 启动服务：执行命令
openclaw start，启动成功后，在浏览器中输入“http://localhost:18789”，进入OpenClaw控制界面，完成初始化设置（同阿里云部署的配置向导步骤）。
3.1.3 方案二：手动部署（开发者首选）
- 安装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 - 安装OpenClaw，根据需求选择版本（稳定版/汉化版/Nightly版）：
# 稳定版（推荐） npm install -g openclaw@latest # 汉化版 npm install -g @qingchencloud/openclaw-zh@latest # Nightly版（开发版，含最新功能，不稳定） npm install -g openclaw@nightly - 解决Apple Silicon芯片编译问题：若安装过程中出现sharp模块编译错误，执行以下命令：
# 重置Xcode路径 sudo xcode-select --reset # 强制重新安装OpenClaw npm install -g openclaw --force - 验证与启动：执行
openclaw --version确认安装成功，执行openclaw start启动服务，访问“http://localhost:18789”完成初始化。
3.2 Linux系统部署（以Ubuntu 22.04为例，适配所有Linux发行版）
Linux系统部署OpenClaw稳定性最高，适合长期运行与多插件集成，提供一键脚本、npm手动两种部署方案，新手推荐一键脚本部署，生产环境推荐结合Docker实现环境隔离，具体步骤如下：
3.2.1 前置准备（必做）
- 更新系统软件包：执行以下命令，确保系统软件包处于最新状态，避免依赖冲突：
sudo apt update && sudo apt upgrade -y - 安装核心依赖：参考1.2节，安装Node.js 22+、pnpm，若选择源码部署或插件手动安装，额外安装Git。
- 端口放行：执行以下命令，放行18789端口，避免防火墙拦截：
# 放行18789端口 sudo ufw allow 18789 # 重启防火墙使配置生效 sudo ufw reload # 验证端口放行状态 sudo ufw status | grep 18789
3.2.2 方案一：一键脚本部署（新手首选）
- 打开终端，执行官方一键安装脚本：
curl -fsSL https://openclaw.ai/install.sh | bash - 脚本自动完成环境检测、依赖安装、OpenClaw部署，无需手动干预，安装完成后执行以下命令验证：
openclaw --version openclaw status - 启动服务并设置开机自启：
# 启动服务 openclaw start # 设置开机自启（避免重启系统后服务停止） sudo systemctl enable openclaw sudo systemctl start openclaw # 验证开机自启配置 sudo systemctl status openclaw - 访问验证：浏览器输入“http://localhost:18789”（若为服务器，输入“http://服务器IP:18789”），完成初始化设置。
3.2.3 方案二：npm手动部署（开发者首选）
- 安装Node.js 22+，执行以下命令：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs # 验证Node.js版本 node -v - 安装pnpm与OpenClaw：
npm install -g pnpm pnpm install -g openclaw@latest - 验证安装：
openclaw --version，若输出正常版本号，说明安装成功。 - 启动服务：
openclaw start，访问“http://localhost:18789”完成初始化。
3.3 Windows11系统部署（推荐WSL2，避免原生环境兼容性问题）
Windows11原生环境部署OpenClaw易出现权限、路径、兼容性问题（如脚本执行失败、服务启动异常），强烈推荐使用WSL2（Ubuntu 22.04子系统）部署，步骤与Linux系统一致；若需原生环境部署，也可参考以下步骤，全程需以管理员身份操作。
3.3.1 方案一：WSL2（Ubuntu 22.04）部署（推荐）
- 启用WSL2：以管理员身份打开PowerShell，执行以下命令，重启电脑后自动安装Ubuntu 22.04子系统：
wsl --install - 启动Ubuntu子系统：重启电脑后，在开始菜单找到“Ubuntu 22.04 LTS”，打开后设置用户名与密码，完成初始化。
- 后续部署步骤：完全参考3.2节Linux系统部署步骤（一键脚本、npm手动均可），核心命令与Linux系统一致，此处不再重复。
3.3.2 方案二：Windows11原生环境部署（不推荐，兼容性差）
- 前置准备：
- 解锁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。
- 解锁PowerShell执行策略：以管理员身份打开PowerShell，执行命令
- 一键脚本部署：
- 以管理员身份打开Command Prompt（CMD），执行以下命令：
curl -fsSL https://openclaw.ai/install.sh | bash - 若脚本执行失败，切换至PowerShell，执行相同命令，若仍失败，建议改用WSL2部署。
- 以管理员身份打开Command Prompt（CMD），执行以下命令：
- npm手动部署：
npm install -g openclaw@latest - 启动服务与验证：
# 启动服务 openclaw start # 验证服务状态 openclaw status - 访问验证：浏览器输入“http://localhost:18789”，完成初始化设置，若无法访问，检查Windows防火墙是否放行18789端口。
四、大模型API配置步骤（阿里云百炼+免费Coding Plan）
OpenClaw的智能交互、任务规划能力完全依赖大模型API，本文提供两种配置方案，用户可根据自身需求选择：阿里云百炼（千问大模型）API（稳定性高、功能全面，适配复杂任务与插件集成）、免费Coding Plan（MiniMax）API（零成本、适合测试与基础使用），两种方案均详细讲解配置步骤，确保新手可顺利完成。
4.1 阿里云百炼（千问大模型）API配置（2026最新）
阿里云百炼大模型兼容性强，可完美适配OpenClaw，支持通义千问3-Max、通义千问3-Coder-Plus等多种模型，配置步骤分部署场景操作，确保参数正确、调用稳定。
4.1.1 获取阿里云百炼API-Key（必做）
- 访问登录阿里云百炼大模型服务平台，若未开通百炼服务，按提示完成开通（需完成实名认证），首次开通可领取新人免费额度（有效期90天）。
- 进入“密钥管理”页面（默认地域为华北2（北京），可根据部署地域选择邻近地域，降低网络延迟）。
- 点击“创建API-Key”，系统自动生成一组API-Key凭证（含Access Key ID与Access Key Secret），点击“复制”分别保存至记事本，重要提醒：API-Key仅生成时可完整查看，后续无法再次获取，需严格保密，避免泄露导致模型调用额度被盗用；若怀疑泄露，需立即禁用旧密钥并重新创建。
4.1.2 API配置（分部署场景）
4.1.2.1 阿里云轻量服务器部署配置
- SSH登录阿里云轻量服务器，执行以下命令，打开OpenClaw主配置文件：
nano ~/.openclaw/openclaw.json - 在配置文件中找到“model”节点，修改为以下内容（替换为自己的API-Key，根据地域选择对应baseUrl）：
备注：不同地域baseUrl不同，新加坡："model": { "mode": "merge", "providers": { "bailian": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", // 华北2（北京）地域 "apiKey": "你的阿里云百炼API-Key", "model": "qwen3-max-2026-01-23", // 模型ID，可根据需求替换 "reasoning": false // 必须设为false，否则回复为空 } } }https://dashscope-intl.aliyuncs.com/compatible-mode/v1；美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1；若使用百炼Coding Plan，baseUrl改为https://coding.dashscope.aliyuncs.com/v1。 - 保存并退出配置文件：按“Ctrl+X”，输入“Y”，按“Enter”确认。
- 重启OpenClaw服务，使配置生效：
若输出“model initialized successfully”，说明配置成功。sudo systemctl restart openclaw # 验证配置是否生效 openclaw logs | grep "model initialized"
4.1.2.2 本地部署（MacOS/Linux/Windows11）配置
- 打开终端（MacOS/Linux）或PowerShell（Windows11），执行以下命令，打开OpenClaw主配置文件：
- MacOS/Linux：
nano ~/.openclaw/openclaw.json - Windows11（WSL2）：
nano ~/.openclaw/openclaw.json - Windows11原生：
notepad %USERPROFILE%/.openclaw/openclaw.json
- MacOS/Linux：
- 同阿里云轻量服务器部署配置，修改“model”节点，替换为自己的API-Key与对应baseUrl，保存退出。
- 重启OpenClaw服务：
- MacOS/Linux/Windows11（WSL2）：
openclaw restart - Windows11原生：
openclaw restart
- MacOS/Linux/Windows11（WSL2）：
- 验证配置：执行
openclaw logs | grep "model initialized"，输出成功信息即为配置生效。
4.1.3 环境变量配置（推荐，提升安全性）
为避免API-Key直接暴露在配置文件中，推荐将API-Key配置为系统环境变量，步骤如下：
- 阿里云轻量服务器（Ubuntu）/MacOS/Linux：
# 打开环境变量配置文件（Zsh用~/.zshrc，Bash用~/.bashrc）
nano ~/.zshrc
# 添加环境变量（替换为自己的API-Key）
export DASHSCOPE_API_KEY="你的阿里云百炼API-Key"
# 保存生效
source ~/.zshrc
# 验证环境变量
echo $DASHSCOPE_API_KEY
- Windows11/阿里云轻量服务器（Windows）：
# 临时环境变量（仅当前会话有效）
$env:DASHSCOPE_API_KEY="你的阿里云百炼API-Key"
# 永久环境变量（所有会话有效）
[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "你的阿里云百炼API-Key", "User")
# 验证环境变量
echo $env:DASHSCOPE_API_KEY
- 修改OpenClaw配置文件，引用环境变量：
"model": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "${DASHSCOPE_API_KEY}",
"model": "qwen3-max-2026-01-23",
"reasoning": false
}
}
}
- 重启OpenClaw服务，验证配置生效。
4.2 免费大模型Coding Plan API配置（MiniMax）
Coding Plan是MiniMax开放平台提供的免费大模型API，支持文本交互、基础任务推理，零成本适合测试与基础使用，兼容OpenClaw的Anthropic接口协议，配置步骤全部署场景通用，具体如下：
4.2.1 获取Coding Plan API-Key（必做）
- 访问MiniMax开放平台，完成账号注册与登录（支持手机号、邮箱注册）。
- 进入“Coding Plan”页面，订阅免费Coding Plan套餐（无需付费，直接订阅即可）。
- 进入“接口密钥”页面，点击“创建Coding Plan Key”，生成API-Key，复制并保存（仅自己可见，妥善保管），注意：此API-Key为Coding Plan专属，仅适用于文本模型，与按量计费API-Key不互通，仅在订阅有效期内有效。
4.2.2 API配置（全部署场景通用）
- 先清除Anthropic相关环境变量，避免影响配置（重要，否则会导致API调用失败）：
- 阿里云轻量服务器（Ubuntu）/MacOS/Linux：
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL
- Windows11/阿里云轻量服务器（Windows）：
```powershell
Remove-Item Env:ANTHROPIC_AUTH_TOKEN
Remove-Item Env:ANTHROPIC_BASE_URL
```
- 打开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"
}
- 保存并退出配置文件，重启OpenClaw服务：
openclaw restart（阿里云轻量服务器需加sudo）。 - 验证配置：执行以下命令，测试API调用是否正常：
若输出正常的模型响应内容，说明配置成功；若提示“API Key invalid”，检查API-Key是否正确，或订阅是否有效。# 执行测试命令 openclaw model test
4.2.3 API调用测试（可选）
可通过Python/Node.js脚本测试Coding Plan API是否正常，确保配置无误：
- 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}")
- 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配置、服务运行等核心场景，提供详细解决方案，帮助新手快速排查问题，避免走弯路。
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：阿里云轻量服务器部署后，无法访问“http://公网IP:18789”
- 原因：安全组未放行18789端口，或防火墙拦截端口，或服务未启动，或国内节点未备案。
- 解决方案：
- 登录阿里云控制台，进入轻量服务器安全组，确认已添加18789端口入方向规则，授权对象为“0.0.0.0/0”。
- SSH登录服务器，执行
sudo ufw allow 18789 && sudo ufw reload，放行端口。 - 执行
sudo systemctl status openclaw，若服务未启动，执行sudo systemctl start openclaw。 - 国内节点需完成ICP备案后才能正常访问，临时可切换至海外节点。
问题3：Windows11原生部署时，脚本执行失败，提示“权限不足”
- 原因：未以管理员身份运行终端/CMD，或PowerShell执行策略未解锁。
- 解决方案：以管理员身份打开PowerShell，执行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，输入“Yes”确认，再重新执行安装脚本；若仍失败，改用WSL2部署（推荐）。
问题4：执行OpenClaw命令时，提示“command not found”
- 原因：环境变量未配置，OpenClaw可执行文件未加入系统PATH。
- 解决方案：
- 阿里云轻量服务器（Ubuntu）/Linux/WSL2：执行
export PATH=$HOME/.npm-global/bin:$PATH，再执行openclaw --version。 - MacOS/Intel芯片：
export PATH=/usr/local/bin:$PATH；Apple Silicon芯片：export PATH=/opt/homebrew/bin:$PATH。 - 若仍失败，重新安装OpenClaw，确保安装过程中环境变量配置成功。
- 阿里云轻量服务器（Ubuntu）/Linux/WSL2：执行
5.2 API配置相关问题
问题1：配置阿里云百炼API后，提示“API Key invalid”
- 原因：API-Key输入错误、API-Key已过期或被禁用、配置文件中baseUrl错误，或model与地域不匹配。
- 解决方案：
- 核对API-Key，确保无多余空格、拼写错误，重新复制粘贴。
- 登录阿里云百炼平台，检查API-Key状态，若已禁用，重新创建API-Key。
- 确认baseUrl与部署地域匹配，model ID为对应地域支持的模型，且“reasoning”设为false。
问题2：配置Coding Plan API后，模型调用无响应，提示“baseUrl invalid”
- 原因：Coding Plan API的baseUrl配置错误，或未清除Anthropic相关环境变量，或API-Key未订阅Coding Plan套餐。
- 解决方案：
- 确认配置文件中baseUrl为“https://api.minimaxi.com/anthropic”，不可修改。
- 执行清除Anthropic环境变量的命令（参考4.2.2），重启OpenClaw服务。
- 登录MiniMax开放平台，检查Coding Plan订阅状态，确保已成功订阅，API-Key为Coding Plan专属。
问题3：环境变量配置后，OpenClaw无法读取API-Key
- 原因：环境变量未生效，或配置文件中API-Key引用格式错误。
- 解决方案：
- 执行
echo $DASHSCOPE_API_KEY（阿里云轻量服务器/MacOS/Linux）或echo $env:DASHSCOPE_API_KEY（Windows），验证环境变量是否生效，若未生效，重新执行source ~/.zshrc（阿里云轻量服务器/MacOS/Linux）或重启终端（Windows）。 - 检查配置文件中API-Key引用格式，确保为
"apiKey": "${DASHSCOPE_API_KEY}"，不可遗漏${}。
- 执行
5.3 服务运行相关问题
问题1：OpenClaw服务启动后，很快自动停止，日志提示“内存不足”
- 原因：设备内存低于最低要求（4GB），或同时运行其他占用内存的服务，或多插件集成后内存负载过高。
- 解决方案：
- 关闭其他占用内存的服务，释放内存。
- 升级设备内存（本地部署），或升级阿里云轻量服务器实例规格（推荐升级至8GB内存）。
- 卸载不常用的插件，降低内存占用。
问题2：访问OpenClaw控制界面，提示“初始化失败”
- 原因：服务未完全启动，或配置文件损坏，或大模型API配置错误。
- 解决方案：
- 执行
openclaw restart（阿里云轻量服务器需加sudo），重启服务，等待3-5分钟后再访问。 - 备份配置文件
~/.openclaw/openclaw.json，删除原文件，执行openclaw setup重新初始化配置。 - 检查大模型API配置，确保参数正确，重启服务后重试。
- 执行
问题3：OpenClaw原名相关命令兼容问题
- 原因：OpenClaw原名Clawdbot、Moltbot，部分命令尚未完成迁移，使用新命令可能出现“command not found”错误。
- 解决方案：若执行
openclaw dashboard提示错误，可切换为旧命令clawdbot dashboard或moltbot dashboard，其他命令同理，后续版本会逐步完成迁移。
六、总结
本文基于2026年OpenClaw最新稳定版，全面覆盖阿里云轻量服务器部署（一键部署+手动部署）与本地MacOS、Linux、Windows11三大系统部署流程，提供多种部署方案适配不同技术水平用户，详细讲解阿里云百炼（千问大模型）API与免费Coding Plan（MiniMax）API的配置步骤，结合实测踩坑经验整理常见问题解决方案，全程无营销词汇、步骤清晰可复现，代码可直接复制，无需复杂的技术基础，新手也能快速完成部署、API配置与调试。
OpenClaw作为开源自托管AI智能体框架，其核心价值在于数据本地化、自定义灵活度高、成本可控，无论是个人搭建专属AI助手，还是小型团队实现办公自动化、开发辅助，都能满足需求。后续可根据自身需求，进一步探索OpenClaw的插件集成、多终端对接等高级功能，充分发挥其“自然语言驱动、全场景自动化”的核心优势。
