2026年最新部署 OpenClaw(Clawdbot) 保姆级图文教程

共计 9291 个字符，预计需要花费 24 分钟才能阅读完成。

2026 年 AI 智能代理工具迎来爆发式发展，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 一键部署专题页面：https://www.aliyun.com/activity/ecs/clawdbot



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

• 镜像：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. 核心参数配置（新手直接抄作业，无需修改）：
   • 镜像选择：默认选中「OpenClaw(Clawdbot)专属镜像」（2026 年默认版本 v2026.1.25，预装全部依赖组件与主程序，无需手动安装）；
   • 实例规格：个人测试 / 日常使用选择「2vCPU+2GiB 内存」，团队协作选择「4vCPU+8GiB 内存」；
   • 存储配置：默认 40GiB ESSD（个人）、80GiB ESSD（团队），无需修改；
   • 带宽配置：200Mbps 峰值公网带宽（个人）、500Mbps 峰值公网带宽（团队），无固定流量限制；
   • 地域选择：优先选择中国香港、美国弗吉尼亚等海外 / 港澳台地域，无需 ICP 备案，联网搜索功能完整；国内地域（除香港外）需完成 ICP 备案，否则无法公网访问；
   • 时长选择：短期测试选月付，长期使用选年付，核对费用后点击「立即支付」；
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 配置（核心步骤）：
   • 在「应用详情」页面找到「配置百炼 API-Key」选项，点击「一键配置」，粘贴提前保存的阿里云百炼 API-Key；
   • 点击「执行命令」，将 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-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# 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. 服务器实例启动失败，提示“配置不足”：
   • 原因：内存低于 2GB，或系统版本不兼容；
   • 解决方案：重新选购服务器，确保内存≥2GB，系统选择 Alibaba Cloud Linux 3.2104 LTS 或 Ubuntu 22.04 LTS 64 位。
2. API-Key 配置失败，提示“连接超时”：
   • 原因：API-Key 地域与服务器地域不匹配，或网络不通；
   • 解决方案：重新生成与服务器地域一致的 API-Key，执行ping dashscope.aliyuncs.com，检查网络连通性，若无法 ping 通，更换服务器地域。
3. 控制台无法访问，提示“Token 无效”：
   • 原因：Token 过期，或端口未放行；
   • 解决方案：重新执行 openclaw token generate 生成新 Token；进入服务器控制台，确认 18789 端口已放行。
4. 技能安装失败，提示“command not found: clawhub”：
   • 原因：ClawHub CLI 未安装成功，或环境变量未生效；
   • 解决方案：重新执行 npm install -g clawhub，执行source ~/.bashrc 刷新环境变量，再尝试安装技能。

（二）本地部署常见问题

1. 安装时提示“权限不足”：
   • 原因：未使用管理员模式执行命令；
   • 解决方案：Windows 打开管理员模式 PowerShell，Mac 在命令前加sudo（如sudo curl ...）。
2. 服务启动失败，提示“端口被占用”：
   • 原因：18789 端口被其他程序占用；
   • 解决方案：执行以下命令查看占用端口的进程，终止进程后重新启动服务：
     • Windows：netstat -ano | findstr "18789"，找到进程 ID，在任务管理器中终止；
     • Mac：lsof -i:18789，找到进程 ID，执行kill -9 进程 ID。
3. 无法调用模型，提示“API Key 无效”：
   • 原因：API-Key 输入错误，或未保存生效；
   • 解决方案：核对 API-Key 字符完整性，重新执行配置命令，重启服务后重试。
4. 本地控制台无法打开，提示“无法访问此网站”：
   • 原因：服务未启动，或本地防火墙拦截；
   • 解决方案：确认 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 智能代理工具成为提升工作效率的“数字员工”，覆盖个人办公、轻量团队协作等多场景需求。