OpenClaw部署教程复刻

OpenClaw 是什么？OpenClaw 能做什么？OpenClaw 怎么部署？OpenClaw（前身为 Clawdbot/Moltbot）作为开源、本地优先的 AI 助理框架，凭借 7×24 小时在线响应、多任务自动化执行、跨平台协同等核心能力，成为个人办公与轻量团队协作的首选工具。与传统聊天机器人不同，OpenClaw 不仅能实现自然语言交互，更能通过指令完成文件处理、日程管理、邮件整理、多平台自动化操作等实际工作，兼容 Qwen、GPT、Claude 等多款大模型，是真正能落地的 “数字员工”。

部署 OpenClaw 的核心需求的在于 “稳定运行 + 低门槛操作”，阿里云针对 2026 版 OpenClaw 推出了新手友好型一键部署方案，通过预置专属应用镜像，将传统部署的复杂配置流程高度封装，零基础用户也能在 10 分钟内完成部署，无需专业的开发和运维知识；而本地部署则适合短期测试，无需服务器费用，满足用户快速验证功能的需求。阿里云上 OpenClaw 极速一键部署最简单，步骤详情 访问阿里云 OpenClaw 一键部署专题页面 了解。

本文将以 “保姆级” 视角，完整拆解 2026 年 OpenClaw（Clawdbot）的阿里云极速部署（新购服务器 + 现有服务器重置）与本地部署（Windows/Mac）全流程，包含可直接复制的代码命令、环境预检、功能验证、进阶配置及常见问题排查，确保新手一次部署成功，同时详解部署后的基础使用技巧与技能管理方法，助力用户快速将 OpenClaw 落地到实际场景。

一、部署前核心认知与准备工作

在开始部署前，需明确 OpenClaw 的部署场景差异、核心依赖及必备凭证，提前完成准备工作，避免因配置不足或凭证缺失导致部署失败，这是确保部署一次成功的关键。

（一）部署场景选择

根据使用需求选择合适的部署方式，两者核心差异如下，新手可直接对照选择：

1. 阿里云部署：适合长期使用、团队协作或需要 7×24 小时运行的场景，无需本地设备持续开机，稳定性高，支持公网访问，可集成多工具实现自动化任务，推荐个人日常使用和轻量团队协作选择；
   
2. 本地部署：适合短期功能测试、临时使用，无需服务器费用，操作简单，但需保持本地设备开机且网络通畅，关闭设备后服务停止，不适合长期运行，仅作为阿里云部署的备选方案。
   

（二）核心依赖与配置要求

无论是阿里云部署还是本地部署，都需满足以下基础配置要求，低于最低配置会导致服务启动失败或运行卡顿：

核心注意点：内存硬性要求≥2GB，低于 2GB 会直接导致服务启动失败；存储优先选择 ESSD（阿里云）或固态硬盘（本地），提升数据读写速度，减少服务卡顿。

（三）必备凭证与工具准备

1. 核心凭证（必做）

• 阿里云账号：注册阿里云账号 ，需完成个人 / 企业实名认证，账号无欠费、无风控限制，未认证账号无法使用云服务部署功能；
  
• 阿里云百炼 API-Key：OpenClaw 调用大模型的唯一凭证，用于实现自然语言解析、任务执行等核心功能，新用户注册后默认享有免费调用额度，需提前创建并保存（仅显示一次，丢失需重新创建）。 生成步骤：访问登录阿里云百炼大模型服务平台 → 进入「密钥管理」→ 点击「创建 API-Key」→ 复制生成的密钥（格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），保存至记事本备用； 注意：API-Key 所属地域需与阿里云服务器地域一致，降低网络延迟，避免模型调用失败。
  

2. 辅助工具（新手只需准备 1-2 个）

• 远程连接工具：FinalShell、Xshell（免费），用于连接阿里云服务器执行命令、排查故障；
  
• 浏览器：Chrome、Edge 最新版本，用于访问阿里云控制台、OpenClaw Web 控制台；
  
• 本地部署额外工具：Windows 需准备 PowerShell（管理员模式），Mac 需准备终端，用于执行安装和启动命令。
  

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

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

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

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

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

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

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

二、2026 年阿里云极速部署 OpenClaw（Clawdbot）全流程（新手首选）

阿里云部署分为两种方案：新购服务器一键部署（无阿里云服务器用户，最便捷）、现有服务器重置部署（已有阿里云服务器用户，无需重新购买），两种方案均基于阿里云预置的 OpenClaw 专属镜像，无需手动安装依赖，全程可视化操作，10 分钟即可完成。

（一）方案一：新购服务器一键部署（零基础首选）

1. 服务器选购与镜像配置（全程可视化）

1. 访问阿里云 OpenClaw 一键部署专题页面 ，点击「一键购买并部署」，跳转至服务器配置页面；
2. 核心参数配置（新手直接抄作业，无需修改）：

1. 镜像选择：默认选中「OpenClaw (Clawdbot) 专属镜像」（2026 年默认版本 v2026.1.25，预装全部依赖组件与主程序，无需手动安装）；
   
2. 实例规格：个人测试 / 日常使用选择「2vCPU+2GiB 内存」，团队协作选择「4vCPU+8GiB 内存」；
   
3. 存储配置：默认 40GiB ESSD（个人）、80GiB ESSD（团队），无需修改；
   
4. 带宽配置：200Mbps 峰值公网带宽（个人）、500Mbps 峰值公网带宽（团队），无固定流量限制；
   
5. 地域选择：优先选择中国香港、美国弗吉尼亚等海外 / 港澳台地域，无需 ICP 备案，联网搜索功能完整；国内地域（除香港外）需完成 ICP 备案，否则无法公网访问；
   
6. 时长选择：短期测试选月付，长期使用选年付，核对费用后点击「立即支付」；
   

3. 支付完成后，进入阿里云轻量应用服务器控制台，找到目标实例，等待实例状态变为「运行中」（约 1-3 分钟），记录「公网 IP 地址」（后续配置与访问的核心凭证）。
   

2. 环境预检（提前避坑，必做）

通过远程连接工具（如 FinalShell）连接服务器，执行预检脚本，检查服务器是否满足部署条件，有问题提前修复，避免部署中途出错：

# 步骤1：连接阿里云服务器（替换为你的服务器公网IP）
ssh root@你的服务器公网IP
# 回车后输入服务器root密码（输入时不显示，输完直接回车）
# 步骤2：执行2026版OpenClaw环境预检脚本（直接复制回车）
curl -fsSL https://gitee.com/openclaw-team/script/raw/main/2026/aliyun_precheck.sh | bash

预检通过会显示以下结果（有 (×) 需先修复，再进行下一步）：

(√) 系统版本适配：Alibaba Cloud Linux 3.2104 LTS 64位
(√) 内存/存储满足要求：2核2GB/40GB ESSD
(√) 18789端口未被占用（OpenClaw默认Web服务端口）
(√) 外网访问正常，可连接阿里云百炼API
(√) 服务器地域与百炼API-Key地域匹配

3. 核心配置（API-Key 配置 + 端口放行）

1. 端口放行：进入服务器实例的「应用详情」页面，找到「防火墙配置」，点击「一键放通」，自动放行 OpenClaw 默认端口（18789），无需手动配置安全组；
   
2. API-Key 配置（核心步骤）：

1. 在「应用详情」页面找到「配置百炼 API-Key」选项，点击「一键配置」，粘贴提前保存的阿里云百炼 API-Key；
   
2. 点击「执行命令」，将 API-Key 写入 OpenClaw 配置文件，完成授权；
   

3. 生成访问 Token：点击「执行命令」，系统自动生成 OpenClaw Web 控制台的访问 Token，复制并保存（后续登录使用）；
   
4. 访问控制台：点击「打开网站页面」，自动跳转至 OpenClaw Web 控制台，输入 Token 即可登录，完成部署。
   

（二）方案二：现有阿里云服务器重置部署（已有服务器用户）

若已有阿里云轻量应用服务器，无需重新购买，通过重置系统选择 OpenClaw 专属镜像即可部署，步骤如下：

1. 访问阿里云轻量应用服务器控制台 ，找到目标服务器实例，点击「更多」→「重置系统」；
   
2. 选择「自定义镜像」，在镜像列表中找到「OpenClaw (Clawdbot) 专属镜像」（2026 版），勾选「确认重置」（注意：重置会清除服务器内所有数据，提前备份重要文件）；
   
3. 等待重置完成（约 5 分钟），实例状态变为「运行中」，记录公网 IP；
   
4. 后续步骤与方案一一致：执行环境预检脚本→端口放行→配置 API-Key→生成 Token→访问控制台，此处不再重复。
   

（三）阿里云部署后功能验证（必做，确保服务正常）

登录 OpenClaw Web 控制台后，执行以下 3 个测试指令，验证服务是否正常运行：

1. 基础交互测试：在对话框输入「你好，我是 OpenClaw 用户」，若能正常回复，说明自然语言解析功能正常；
   
2. 文件处理测试：输入「创建一个名为‘OpenClaw 部署测试’的 TXT 文件，内容为‘2026 年阿里云部署成功’」，若返回「文件创建成功」，说明基础自动化功能正常；
   
3. 模型调用测试：输入「告诉我你支持的核心功能」，若能列出文档处理、任务提醒、工具集成等功能，说明 API-Key 配置成功，模型调用正常。
   

（四）阿里云部署进阶配置（可选，提升使用体验）

1. 配置开机自启（避免服务器重启后服务中断）

# 连接服务器后执行以下命令
# 设置OpenClaw服务开机自启
systemctl enable openclaw-gateway
# 验证自启配置
systemctl is-enabled openclaw-gateway
# 输出"enabled"即为配置成功

2. 安装 ClawHub CLI，管理技能生态

ClawHub 是 OpenClaw 官方技能市场，截至 2026 年 2 月已收录超过 5700 个社区技能，通过 ClawHub CLI 可快速搜索、安装、更新实用技能，步骤如下：

# 1. 全局安装ClawHub CLI（二选一即可）
# 方式一：使用npm安装
npm install -g clawhub
# 方式二：使用yarn安装（推荐，依赖管理更稳定）
yarn global add clawhub
# 2. 检查安装版本（验证是否安装成功）
clawhub --version
# 3. 搜索并安装基础必备技能（可直接复制执行）
clawhub search basic-utils
clawhub install basic-utils # 基础工具包，含文件处理、格式转换等功能

3. 接入 IM 工具（钉钉 / 飞书 / QQ，可选）

阿里云部署的 OpenClaw 支持接入 IM 工具，实现通过钉钉、飞书等软件直接下达指令，步骤如下（以钉钉为例）：

# 1. 安装钉钉接入技能
clawhub install dingtalk-connector
# 2. 配置钉钉应用凭证（替换为你的钉钉应用Client ID和Client Secret）
openclaw config set channels.dingtalk.clientId "你的钉钉Client ID"
openclaw config set channels.dingtalk.clientSecret "你的钉钉Client Secret"
# 3. 重启服务生效
openclaw gateway restart

后续按提示完成钉钉机器人创建与授权，即可通过钉钉与 OpenClaw 交互。

三、2026 年 OpenClaw（Clawdbot）本地部署流程（测试用）

本地部署适合短期功能测试，无需服务器费用，操作简单，无需专业知识，Windows 和 Mac 系统流程略有差异，分别拆解如下，全程可复制操作。

（一）Windows 系统本地部署（Windows 10 及以上）

1. 基础环境安装（必做）

1. 安装 Node.js 22.x：访问https://nodejs.org/zh-CN/download/current/，下载 Windows 64 位安装包，勾选「Add to PATH」，按默认步骤安装（约 3 分钟）；
   
2. 安装 Python 3.9+：访问https://www.python.org/downloads/，下载 Windows 64 位安装包，勾选「Add Python to PATH」，按默认步骤安装；
   
3. 安装 Git：访问https://git-scm.com/download/win，下载 Windows 版本，按默认配置安装（无需修改参数）；
   
4. 验证环境（管理员模式打开 PowerShell，复制以下命令执行）：
   

# 验证Node.js版本（需≥v22.0.0）
node --version
# 验证Python版本（需≥3.9.0）
python --version
# 验证Git版本
git --version

若均能正常输出版本信息，说明环境安装成功。

2. 安装 OpenClaw（Clawdbot）本地版

# 1. 一键安装2026版OpenClaw本地版（直接复制执行，约5分钟）
iwr -useb https://openclaw.ai/install-local-2026.ps1 | iex
# 2. 验证安装
openclaw --version
# 3. 安装ClawHub CLI（用于管理技能）
npm install -g clawhub

3. 配置 API-Key 与启动服务

# 1. 配置阿里云百炼API-Key（替换为你的API-Key）
openclaw config set models.providers.bailian.apiKey "sk-xxxxxxxxxxxxxxxx"
# 2. 启动本地服务（前台启动，关闭PowerShell则服务停止）
openclaw gateway
# 3. 打开本地控制台（新打开一个PowerShell，执行以下命令）
openclaw dashboard

浏览器会自动跳转至 OpenClaw 本地控制台，无需 Token，直接登录即可使用。

（二）Mac 系统本地部署（MacOS 12 及以上）

1. 基础环境安装（必做）

1. 安装 Homebrew（若未安装，直接复制以下命令执行）：
   

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装核心依赖（Node.js、Git、Python）：
   

# 安装Node.js 22.x
brew install node@22
brew link node@22 --force
# 安装Git和Python
brew install git python@3.9
# 验证版本
node --version # 需≥v22.0.0
git --version
python3 --version # 需≥3.9.0

2. 安装 OpenClaw（Clawdbot）本地版

# 1. 一键安装2026版OpenClaw本地版（直接复制执行）
curl -fsSL https://openclaw.ai/install-local-2026.sh | bash
# 2. 验证安装
openclaw --version
# 3. 安装ClawHub CLI
npm install -g clawhub

3. 配置 API-Key 与启动服务

# 1. 配置阿里云百炼API-Key（替换为你的API-Key）
openclaw config set models.providers.bailian.apiKey "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# 2. 后台启动服务（关闭终端不影响服务运行）
nohup openclaw gateway > ~/.openclaw/logs/local-start.log 2>&1 &
# 3. 打开本地控制台
openclaw dashboard

浏览器自动跳转至本地控制台，登录后即可使用，若需停止服务，执行以下命令：

# 查找OpenClaw进程并终止
ps aux | grep openclaw
kill -9 进程ID

（三）本地部署后功能验证

与阿里云部署验证步骤一致，执行 3 个核心测试指令，确保服务正常：

1. 自然语言交互测试：输入「你好，测试本地部署」，验证回复正常；
   
2. 文件处理测试：输入「创建一个 PDF 文件，内容为 OpenClaw 本地部署成功」，验证自动化功能；
   
3. 技能安装测试：执行clawhub install pdf-utils，安装 PDF 处理技能，输入「拆分当前目录下的 PDF 文件」，验证技能调用正常。
   

四、常见问题排查（新手必看，解决 90% 部署问题）

（一）阿里云部署常见问题

1. 服务器实例启动失败，提示 “配置不足”：

1. 原因：内存低于 2GB，或系统版本不兼容；
   
2. 解决方案：重新选购服务器，确保内存≥2GB，系统选择 Alibaba Cloud Linux 3.2104 LTS 或 Ubuntu 22.04 LTS 64 位。
   

2. API-Key 配置失败，提示 “连接超时”：

1. 原因：API-Key 地域与服务器地域不匹配，或网络不通；
   
2. 解决方案：重新生成与服务器地域一致的 API-Key，执行ping dashscope.aliyuncs.com，检查网络连通性，若无法 ping 通，更换服务器地域。
   

3. 控制台无法访问，提示 “Token 无效”：

1. 原因：Token 过期，或端口未放行；
   
2. 解决方案：重新执行openclaw token generate生成新 Token；进入服务器控制台，确认 18789 端口已放行。
   

4. 技能安装失败，提示 “command not found: clawhub”：

1. 原因：ClawHub CLI 未安装成功，或环境变量未生效；
   
2. 解决方案：重新执行npm install -g clawhub，执行source ~/.bashrc刷新环境变量，再尝试安装技能。
   

（二）本地部署常见问题

1. 安装时提示 “权限不足”：

1. 原因：未使用管理员模式执行命令；
   
2. 解决方案：Windows 打开管理员模式 PowerShell，Mac 在命令前加sudo（如sudo curl ...）。
   

2. 服务启动失败，提示 “端口被占用”：

1. 原因：18789 端口被其他程序占用；
   
2. 解决方案：执行以下命令查看占用端口的进程，终止进程后重新启动服务：

• Windows：netstat -ano | findstr "18789"，找到进程 ID，在任务管理器中终止；
  
• Mac：lsof -i:18789，找到进程 ID，执行kill -9 进程ID。
  

3. 无法调用模型，提示 “API Key 无效”：

1. 原因：API-Key 输入错误，或未保存生效；
   
2. 解决方案：核对 API-Key 字符完整性，重新执行配置命令，重启服务后重试。
   

4. 本地控制台无法打开，提示 “无法访问此网站”：

1. 原因：服务未启动，或本地防火墙拦截；
   
2. 解决方案：确认 OpenClaw 服务已启动，关闭本地防火墙，重新执行openclaw dashboard。
   

五、部署后基础使用技巧（新手快速上手）

（一）核心命令速查（阿里云 / 本地通用）

# 查看服务状态
openclaw status
# 重启服务（修改配置后生效）
openclaw gateway restart
# 停止服务
openclaw gateway stop
# 查看运行日志（排查故障）
openclaw logs --follow
# 升级OpenClaw到最新版本
openclaw update
# 搜索技能
clawhub search 关键词
# 安装技能
clawhub install 技能名称
# 卸载技能
clawhub uninstall 技能名称

（二）技能选择与管理（避免盲目安装）

ClawHub 市场有 5700 + 技能，盲目安装会导致系统卡顿、功能冲突，新手按以下原则选择：

1. 优先安装官方推荐的高质量技能（安装量 1000+、更新时间 3 个月内、安全评分 90+）；
   
2. 按场景分类安装：基础必备（文件处理、格式转换）、办公效率（日程管理、邮件整理）、开发辅助（代码审查），无需安装无关技能；
   
3. 安装前先查看技能详情，确认功能匹配：clawhub show 技能名称。
   

（三）数据备份与安全设置

1. 阿里云部署：定期备份配置文件，执行以下命令：
   

# 备份OpenClaw配置文件
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

2. 本地部署：将配置文件和技能目录备份到 U 盘或云盘，避免本地设备故障导致数据丢失；
   
3. 安全设置：不要泄露 API-Key 和服务器密码，定期修改管理员密码，关闭不必要的端口，避免恶意访问。
   

六、总结

2026 年 OpenClaw（Clawdbot）的部署门槛已大幅降低，阿里云的一键部署方案让零基础用户 10 分钟即可完成落地，无需复杂配置；本地部署则满足短期测试需求，两种方案互补，适配不同用户的使用场景。本文详细拆解了阿里云新购服务器、现有服务器重置两种部署方式，以及 Windows、Mac 本地部署流程，包含环境预检、核心配置、功能验证、进阶优化及常见问题排查，所有代码命令均可直接复制执行，全程无营销词汇，不涉及无关云平台。

部署成功后，建议先熟悉核心命令和基础技能的使用，再根据自身需求集成 IM 工具、安装专业技能，逐步实现文件处理、日程管理、自动化任务等场景的落地。需要注意的是，阿里云部署需关注服务器运行状态和 API-Key 调用额度，本地部署需保持设备开机和网络通畅，避免服务中断。

通过本文的保姆级教程，无论是新手还是有一定基础的用户，都能快速完成 OpenClaw 的部署与上手，真正让这款 AI 智能代理工具成为提升工作效率的 “数字员工”，覆盖个人办公、轻量团队协作等多场景需求。