保姆级教程：OpenClaw(Clawdbot)汉化/原版部署（阿里云/Win11/MacOS/Linux）+百炼/Coding Plan API配置+FAQ

“AI不仅能聊天，更能替你干活”——这是OpenClaw（原Clawdbot/Moltbot）的核心主张。作为由彼得·斯坦伯格开发的开源个人AI代理，它以“龙虾”为标识，凭借“软件操作+长期记忆”的核心能力，2026年获得特斯拉前AI主管Karpathy公开提及，成为开源AI领域的现象级项目。不同于传统聊天机器人，OpenClaw真正践行了“The AI that actually does things”的口号，能通过自然语言指令完成文件处理、自动化办公、代码开发等实际任务。

参考文章详细拆解了Windows和Linux系统下OpenClaw原版与汉化版的部署流程，重点突出配置向导的关键步骤。本文基于该核心逻辑，补充2026年阿里云部署方案及MacOS本地部署流程，完善阿里云百炼免费API配置与Coding Plan API配置细节，新增全面的常见问题解答，所有代码可直接复制执行，助力不同系统、不同需求的用户快速搭建专属AI助手。阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw的核心价值与部署选型

（一）OpenClaw是什么？不止是AI，更是“数字员工”

OpenClaw是一款基于TypeScript开发的开源AI智能体，核心定位为“个人AI代理”，其核心价值体现在三点：

1. 能动手执行：区别于仅能对话的AI工具，它可操作软件、处理文件、执行脚本，真正将指令落地；
2. 长期记忆能力：记住用户习惯、偏好与工作流程，越用越贴合个人需求；
3. 双版本适配：提供原版（英文）与汉化版（中文界面，更适合国内用户），支持多模型接入与技能扩展。

截至2026年3月，ClawHub技能市场已收录超1700个功能插件，覆盖办公、开发、生活等全场景，搭配阿里云百炼等免费大模型，可实现“零成本打造专属AI员工”。

（二）部署方案选型：阿里云vs本地，按需选择

结合使用场景、设备条件与隐私需求，双部署方案适配性如下，用户可直接对号入座：

选型建议：

• 个人用户/注重隐私：优先本地部署，选择汉化版（中文界面，配置更便捷）；
• 需长期运行/多设备访问：选择阿里云部署，享受稳定运行与远程访问能力；
• 开发者/编程需求：可配置Coding Plan API，解锁专业编程模型能力。

（三）前置准备（全方案通用）

1. 账号准备：注册阿里云账号并完成实名认证（用于服务器购买与百炼API开通）；GitHub账号（可选，用于下载汉化版源码）；
2. 工具准备：远程连接工具（FinalShell，用于阿里云操作）、文本编辑器（VS Code/记事本）、Git（可选，源码部署必需）、Chrome浏览器；
3. 核心认知：OpenClaw依赖Node.js 24.x版本（参考文章推荐，兼容最新功能）；部署前需仔细阅读安全提示，启用工具后注意权限控制；阿里云百炼提供7000万Token免费额度（90天），访问订阅阿里云百炼Coding Plan，Coding Plan API支持多款编程模型，按需选择。

二、2026全平台部署流程（阿里云+本地多系统）

（一）方案一：本地部署（Win11/MacOS/Linux，个人首选）

本地部署支持原版与汉化版，分系统详细拆解步骤，所有代码可直接复制执行：

1. Windows11系统（PowerShell，管理员模式）

参考文章核心部署方案，补充细节优化：

# 步骤1：安装Node.js 24.x（推荐压缩包安装，避免权限问题）
# 下载地址：https://nodejs.org/en/download，选择node-v24.13.0-win-x64.zip
# 解压到指定目录（示例路径：D:\tools）
$nodePath = "D:\tools\node-v24.13.0-win-x64"
# 设置环境变量
[Environment]::SetEnvironmentVariable("NODE_HOME", $nodePath, "Machine")
$currentPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
[Environment]::SetEnvironmentVariable("Path", "$currentPath;$nodePath;D:\tools\node_global", "Machine")

# 步骤2：配置npm国内镜像与缓存
npm config set registry https://registry.npmmirror.com/
npm config set prefix "D:\tools\node_global"
npm config set cache "D:\tools\node_cache"

# 步骤3：升级npm
npm install -g npm@latest

# 步骤4：安装OpenClaw（二选一，推荐汉化版）
# 选项A：安装汉化版（中文界面，推荐国内用户）
npm install -g openclaw-cn@latest
# 选项B：安装原版（英文界面）
# npm install -g openclaw@latest

# 步骤5：运行配置向导（以汉化版为例）
openclaw-cn onboard --install-daemon

# 步骤6：启动网关服务
openclaw-cn gateway --port 18789 --verbose

配置向导关键步骤（参考文章核心流程）：

1. 安全警告：左右方向键选择“Yes”，回车确认；
2. 安装引导模式：上下方向键选择“快速开始”，回车；
3. 模型/认证提供商：选择“阿里云百炼(DashScope)”，回车；
4. 输入API-Key：粘贴提前获取的阿里云百炼API-Key，回车；
5. 模型选择：保持默认“dashscope/qwen-plus”，回车；
6. 通道选择：选择“暂时跳过”，后续可通过命令添加；
7. 技能配置：选择“Yes”，技能安装管理器选择“npm”；
8. 钩子配置：空格键勾选“暂时跳过”，回车；
9. 获取Token：配置完成后，在用户目录下的.openclaw\openclaw.json中找到gateway.auth.token字段，复制Token。

2. MacOS系统（终端，补充参考文章未覆盖的流程）

# 步骤1：安装Homebrew（已安装可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 步骤2：安装Node.js 24.x
brew install node@24
# 配置环境变量
echo 'export PATH="/usr/local/opt/node@24/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 步骤3：配置npm国内镜像
npm config set registry https://registry.npmmirror.com/

# 步骤4：安装OpenClaw（二选一）
# 选项A：安装汉化版
npm install -g openclaw-cn@latest
# 选项B：安装原版
# npm install -g openclaw@latest

# 步骤5：运行配置向导（汉化版）
openclaw-cn onboard --install-daemon

# 步骤6：修复MacOS可能出现的路径问题
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 步骤7：启动网关
openclaw-cn gateway --port 18789 --verbose

MacOS专属优化：
若启动后提示“command not found”，执行source ~/.zshrc或重启终端；若出现模型超时问题，手动修正配置文件：

nano ~/.openclaw/openclaw.json

确保models部分配置正确，删除残留的无效提供商配置，保存后重启服务：

openclaw-cn gateway restart

3. Linux系统（Ubuntu 20.04+，参考文章优化版）

# 步骤1：安装Node.js 24.x
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
# 升级npm
sudo npm install -g npm@latest

# 步骤2：配置npm国内镜像
npm config set registry https://registry.npmmirror.com/

# 步骤3：安装OpenClaw（二选一）
# 选项A：汉化版
sudo npm install -g openclaw-cn@latest --unsafe-perm
# 选项B：原版
# sudo npm install -g openclaw@latest --unsafe-perm

# 步骤4：运行配置向导
openclaw-cn onboard --install-daemon

# 步骤5：启动网关并设置开机自启
openclaw-cn gateway --port 18789 --verbose &
# 设置开机自启
echo "openclaw-cn gateway --port 18789 --verbose" >> ~/start-openclaw.sh
chmod +x ~/start-openclaw.sh
sudo echo "@reboot ~/start-openclaw.sh" >> /etc/crontab

4. 本地部署验证

1. 复制配置向导生成的仪表盘链接（含Token），格式为http://127.0.0.1:18789/?token=你的Token；
2. 浏览器打开链接，若显示“已连接”，且能正常进入聊天界面，说明部署成功；
3. 发送测试指令（如“帮我总结OpenClaw的核心功能”），验证模型是否正常响应。

（二）方案二：阿里云部署（长期运行首选）

参考阿里云官方优化方案，实现一键部署，步骤如下：

新手零基础阿里云上部署OpenClaw喂饭级步骤流程

第一步：打开访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。

第二步：打开选购阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

1. 服务器配置与实例创建

1. 访问阿里云OpenClaw一键部署专题页面，点击“一键购买并部署”；
2. 核心配置选择（新手直接照搬）：
   • 地域选择：中国香港/新加坡（免备案，网络通畅）；
   • 镜像选择：应用镜像→OpenClaw（已预装所有依赖）；
   • 实例规格：推荐2vCPU+4GiB内存+40GiB ESSD+3Mbps带宽；
   • 付费类型：按需付费（测试）/ 包年包月（长期）；
3. 支付完成后，等待1-5分钟，实例状态变为“运行中”，自动完成基础部署。

2. 服务器配置与验证

1. 访问阿里云轻量应用服务器控制台，找到目标实例，进入“应用详情”页面；
2. 端口放行：确认18789端口已自动放行，若未放行，手动添加规则（端口18789，授权对象0.0.0.0/0）；
3. 配置API-Key：在应用详情页找到“配置向导”，选择“阿里云百炼”，粘贴API-Key，保存配置；
4. 获取访问链接：应用详情页会显示含Token的访问链接，复制链接；
5. 验证部署：浏览器打开链接，能正常进入OpenClaw界面，说明部署成功。

三、API配置：阿里云百炼+ Coding Plan双方案

（一）方案一：阿里云百炼免费API配置（推荐，零成本）

1. 获取阿里云百炼API-Key

1. 访问登录阿里云百炼大模型服务平台，进入“密钥管理”页面；
2. 点击“创建API-Key”，复制生成的密钥（仅显示一次，妥善保存）；
3. 进入“额度管理”页面，点击“领取免费额度”，7000万Token自动到账（90天有效期）。

2. 配置OpenClaw关联API（配置向导之外的手动补充）

若配置向导中未完成API配置，可手动编辑配置文件：

# 进入配置目录
cd ~/.openclaw
# 编辑配置文件（Win11用notepad，Mac/Linux用nano）
nano config.yaml

粘贴以下配置（替换为你的API-Key）：

model:
  provider: alibaba-cloud
  apiKey: "你的百炼API-Key"
  baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1"
  defaultModel: "bailian/qwen-plus"
  parameters:
    temperature: 0.7
    maxTokens: 8192
skills:
  autoLoad: true
  scanPath: ["~/.openclaw/skills", "~/clawd/skills"]
security:
  sensitiveDataFilter: true
  sandboxMode: true

重启服务生效：

# 汉化版
openclaw-cn gateway restart
# 原版
openclaw gateway restart

（二）方案二：Coding Plan API配置（编程场景首选）

Coding Plan支持多款专业编程模型，适配开发场景，配置步骤如下：

1. 获取Coding Plan API-Key

1. 登录阿里云百炼Coding Plan页面，完成订阅（按提示操作）；
2. 进入“密钥管理”页面，创建并复制Coding Plan专属API-Key；
3. 查看调用限制：了解每月调用额度（不同套餐不同），避免违规使用。

2. 配置OpenClaw关联Coding Plan

# 编辑配置文件
nano ~/.openclaw/config.yaml

替换model节点配置：

model:
  provider: alibaba-cloud
  apiKey: "你的Coding Plan API-Key"
  baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1"
  defaultModel: "bailian/glm-5"  # 编程专用模型
  parameters:
    temperature: 0.6  # 降低创造性，提升代码准确性
    maxTokens: 128000
  restrictions:
    allowBatchCalls: false  # 禁止批量调用，符合Coding Plan规则

重启服务生效，验证编程功能：

openclaw-cn gateway restart
# 发送测试指令："帮我写一个Python脚本，实现Excel文件数据统计"

注意事项：

• Coding Plan API仅限交互式编程场景使用，禁止自动化脚本调用，否则可能导致API-Key被封禁；
• 复杂编程任务单次调用可能消耗多次额度，合理规划使用场景。

四、常见问题解答（FAQ，避坑关键）

（一）部署相关问题

1. 问题1：安装时提示“Node.js版本过低”？
   解决方案：卸载旧版本Node.js，按本文步骤安装Node.js 24.x：

   # Windows卸载（通过控制面板→程序和功能）
   # Mac卸载
   brew uninstall node@旧版本号
   # Linux卸载
   sudo apt remove -y nodejs
   # 重新安装Node.js 24.x（参考对应系统步骤）
   

2. 问题2：配置向导中找不到“阿里云百炼”选项？
   解决方案：

   • 确认安装的是OpenClaw最新版本（npm update -g openclaw-cn）；
   • 若仍未找到，选择“Skip for now”，后续通过手动配置文件添加（参考API配置部分）；
   • 检查网络通畅性，确保能正常访问阿里云百炼控制台。

3. 问题3：阿里云部署后，无法访问OpenClaw界面？
   解决方案：

   • 确认服务器实例状态为“运行中”；
   • 检查18789端口已放行；
   • 核对访问链接中的公网IP与服务器IP一致；
   • 执行docker ps | grep openclaw（阿里云镜像基于Docker），确认容器正常运行。

4. 问题4：MacOS启动后提示“command not found”？
   解决方案：

   # 手动添加路径
   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc
   # 重新验证
   openclaw-cn --version
   

（二）API与模型问题

1. 问题1：阿里云百炼提示“额度不足”？
   解决方案：

   • 进入百炼控制台领取免费额度；
   • 调整maxTokens参数（日常任务设为4096）；
   • 关闭不常用技能，减少无效调用；
   • 切换至Coding Plan API（若有订阅）。

2. 问题2：Coding Plan API调用提示“违规使用”？
   解决方案：

   • 确认未用于自动化脚本或批量调用；
   • 检查配置文件中allowBatchCalls设为false；
   • 避免高频连续调用，合理控制请求频率；
   • 参考Coding Plan使用规则，仅用于交互式编程场景。

3. 问题3：模型响应慢或超时？
   解决方案：

   • 阿里云部署选择中国香港/新加坡地域，降低延迟；
   • 本地部署关闭代理，确保网络通畅；
   • 调整配置文件中的超时参数（timeoutSeconds: 60）；
   • 选择轻量模型（如bailian/qwen-turbo），提升响应速度。

（三）功能与安全问题

1. 问题1：OpenClaw无法操作本地文件？
   解决方案：

   • 以管理员/root权限启动服务；
   • 配置文件中添加文件访问权限：

     security:
       fileAccessPath: ["~/Documents", "~/Desktop"]
     

   • 避免访问系统敏感目录（如/etc、C:\Windows）。

2. 问题2：汉化版界面显示乱码？
   解决方案：

   • 确认系统编码为UTF-8；
   • 卸载汉化版重新安装：

     npm uninstall -g openclaw-cn
     npm install -g openclaw-cn@latest
     

   • 重启网关服务，清除浏览器缓存。

3. 问题3：如何备份与迁移配置？
   解决方案：

   • 备份配置文件：cp ~/.openclaw/* 备份目录；
   • 迁移时将备份文件复制到新设备的~/.openclaw目录；
   • 重新启动服务，无需重新配置API-Key与技能。

（四）技能安装问题

1. 问题1：安装技能提示“网络超时”？
   解决方案：

   • 配置clawhub国内镜像：

     npm config set registry https://registry.npmmirror.com/
     

   • 手动安装技能：下载技能压缩包，解压到~/.openclaw/skills目录，执行openclaw-cn skills enable 技能名。

2. 问题2：技能安装后无法调用？
   解决方案：

   • 确认技能已启用（openclaw-cn skills list --status enabled）；
   • 重启网关服务；
   • 检查技能依赖是否安装（进入技能目录执行npm install）。

五、总结：从部署到实战，OpenClaw的核心使用逻辑

OpenClaw的核心魅力在于“能动手、可定制、零成本”，无论是个人日常办公，还是开发者编程辅助，都能通过简单配置满足需求。本文基于参考文章的部署流程，补充阿里云与MacOS部署方案，完善双API配置细节，新手可按以下步骤快速上手：

1. 选型：个人用户选本地汉化版，长期运行选阿里云部署；
2. 部署：按对应系统步骤安装Node.js与OpenClaw，完成配置向导；
3. 配置：选择阿里云百炼（免费）或Coding Plan（编程场景）API，实现模型联动；
4. 实战：安装核心技能（如文件处理、浏览器自动化），发送自然语言指令测试功能；
5. 优化：根据使用场景调整配置参数，解决响应慢、权限不足等问题。

记住，OpenClaw的安全使用至关重要：定期执行openclaw-cn security audit --deep进行安全审计，避免授予过高权限，将敏感数据隔离在AI可访问范围之外。按照本文步骤操作，即可快速拥有一款真正“能干活”的AI助手，解放重复劳动，聚焦核心价值创造。