2026年，AI Agent工具迎来爆发式增长，OpenClaw（原Clawdbot、Moltbot）凭借“开源可控、部署灵活、全场景适配”的核心优势，成为个人办公、轻量团队协作的首选自动化工具。截至2026年2月，OpenClaw在GitHub平台的星标数量已突破18.6万，Fork数超3.2万，拥有130余名核心贡献者，Discord社区在线成员超1.1万名，成为年度增长最快的开源项目之一。其前身为Clawdbot与Moltbot，因商标调整于2026年1月30日正式定名OpenClaw，寓意“开源赋能、精准高效”，更名后核心功能、技术架构完全不变，仍有不少老用户沿用Clawdbot旧称，本质上均指向同一套AI自动化代理系统。

OpenClaw的核心价值的在于，它并非单纯的聊天机器人，而是一款能自主执行任务的“数字员工”，可通过自然语言指令完成文件处理、跨工具协同、代码辅助、知识库搭建等各类流程化工作，无需用户掌握复杂编程技能。但很多新手被“部署难、配置复杂”的问题劝退，事实上，阿里云已针对2026年OpenClaw最新稳定版，推出计算巢一键部署方案，将复杂流程高度封装，零基础小白10分钟即可完成部署；同时阿里云轻量服务器部署、本地部署流程也已简化，搭配阿里云百炼Coding Plan免费API，可实现零成本解锁全量自动化能力。阿里云部署 OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。

👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。

本文基于全网实测经验、阿里云官方部署规范及OpenClaw开源社区文档，重写整理保姆级教程，不改变原意、不含指定无关平台，重点拆解新手零基础阿里云计算巢一键部署、轻量服务器部署步骤，详细讲解阿里云百炼Coding Plan API配置流程，补充技能集成方法与高频避坑指南，所有代码命令可直接复制执行，全程可视化、零代码门槛，助力新手快速上手，让OpenClaw(Clawdbot)真正成为0薪水的“数字化助手”。

一、核心认知：OpenClaw(Clawdbot)是什么？新手必看

（一）核心定位与优势

OpenClaw(Clawdbot)是遵循MIT协议的开源AI Agent平台，核心定位是“能动手的AI执行系统”，而非传统聊天机器人。其核心优势的在于“自动化闭环+多场景适配”，具体体现在三点：

全流程自动化：无需人工干预，从任务触发（定时/事件触发）到结果反馈（推送/存储）形成完整闭环，比如自动抓取新闻、生成摘要、推送至指定平台，全程无需手动操作；
部署灵活多样：支持阿里云计算巢一键部署（新手首选）、阿里云轻量服务器部署（长期运行首选）、本地部署（隐私优先），适配不同用户需求，零基础也能轻松上手；
技能可扩展：支持通过ClawHub安装、更新各类技能，涵盖信息聚合、内容生产、开发协作、运维监控等场景，同时支持自定义技能，满足个性化需求，技能加载有明确的优先级规则，可灵活配置。

（二）关键说明：OpenClaw与Clawdbot的关系

很多新手会混淆“OpenClaw”与“Clawdbot”，其实二者本质一致：Clawdbot是OpenClaw的旧称，因商标相关问题，于2026年1月正式更名OpenClaw，核心功能、技术架构、部署流程完全不变，本文中所有“OpenClaw”均等同于“Clawdbot”，部署与配置步骤通用，无需担心版本差异。

（三）核心依赖：阿里云百炼Coding Plan API

重要提醒：OpenClaw本身不具备大模型推理能力，需对接外部大模型才能实现“意图解析、任务规划”，而阿里云百炼Coding Plan是最适配的选择——新用户可领取90天免费额度，国内节点稳定、响应速度快，与OpenClaw无缝兼容，且支持成本控制，避免无效消耗，是新手零基础入门的最优解。

（四）部署方案对比（2026年最新，新手重点看）

为方便新手选择，整理3种主流部署方案对比，明确适配场景与操作难度，新手优先选择阿里云计算巢一键部署：

部署方案	核心优势	适用场景	操作难度	稳定性	成本
阿里云计算巢一键部署	零代码、可视化操作，10分钟完成，预置所有依赖，自动配置安全组	零基础小白、快速上线场景	极低	高（企业级运维）	服务器费用（56元/月起）
阿里云轻量服务器部署	灵活度高，支持自定义配置，可扩展高级功能，7×24小时稳定运行	有基础操作能力用户、团队协作、长期运行	低	高	服务器费用（56元/月起）
本地部署（Windows11/MacOS/Linux）	数据私有化，零服务器成本，低延迟，无需公网	个人用户、敏感数据处理、开发调试	低	中等（依赖本地设备）	零成本

二、部署前必做准备（所有方案通用，新手必看）

无论选择哪种部署方案，都需提前完成以下准备工作，避免因凭证缺失或配置不足导致部署失败，全程简单易操作，新手跟着做即可：

（一）账号与凭证准备

阿里云账号：注册阿里云账号 阿里云账号（官网直接注册），并完成实名认证（个人用户支付宝刷脸即可，无需复杂资质），确保账号无欠费，这是部署与API配置的基础；
阿里云百炼Coding Plan API Key：访问订阅阿里云百炼Coding Plan，这是OpenClaw的“智能大脑”，新用户可领取90天免费额度，后续详细讲解获取步骤；
辅助工具准备：推荐使用Chrome、Edge最新版本浏览器（访问阿里云控制台、OpenClaw配置页面更流畅）；可选终端工具（如FinalShell），用于远程连接服务器验证服务状态；准备文本编辑器（如记事本），记录公网IP、Token等关键参数，避免遗漏。

（二）基础工具安装（本地部署/轻量服务器部署需准备）

若选择阿里云计算巢一键部署，无需提前安装任何工具；若选择阿里云轻量服务器部署或本地部署，需提前安装基础工具，以下是全系统通用安装代码，直接复制执行即可：

# 1. 安装Node.js（OpenClaw核心依赖，必须v22.x版本，避免版本兼容问题）
# Windows11（PowerShell，管理员模式，新手必看：右键PowerShell选择“以管理员身份运行”）
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y

# MacOS（终端，直接复制执行，M芯片无需额外操作）
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Linux/Ubuntu（终端，阿里云轻量服务器默认系统，直接复制）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 2. 验证Node.js版本（显示v22.x.x即为成功，若失败重新执行安装命令）
node -v

# 3. 安装核心工具（Git、ClawHub CLI，技能集成必备）
# Windows11
winget install Git.Git -y
npm install -g clawhub@latest

# MacOS/Linux
brew install git  # MacOS
sudo apt install git -y  # Linux/阿里云轻量服务器
npm install -g clawhub@latest

# 4. 安装Docker（容器化部署必备，提升稳定性）
# Windows11：下载Docker Desktop并安装，开启“以管理员身份运行”（无需输命令）
# MacOS
brew install docker --cask
open -a Docker

# Linux/阿里云轻量服务器
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker
sudo systemctl enable docker

# 5. 配置国内镜像，解决下载超时问题（国内用户必做，避免踩坑）
npm config set registry https://registry.npmmirror.com
clawhub config set registry https://clawhub-mirror.aliyuncs.com

# 6. 验证工具安装（所有命令执行完成，无报错即为成功）
git --version && clawhub -V && docker --version

（三）新手注意事项

所有工具安装时，全程不要修改默认安装路径，避免出现路径错误，导致后续部署失败；
Windows系统需注意：安装路径必须为纯英文（如“D:\openclaw”），中文路径会导致启动报错；
安装过程中若出现“权限被拒绝”，Windows用户需确认PowerShell是管理员模式，MacOS/Linux用户在命令前加“sudo”；
国内用户务必配置国内镜像，否则会出现依赖下载超时、部署失败的问题，这是新手最易踩的坑之一。

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

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

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

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

轻量应用服务器OpenClaw镜像.png

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

阿里云百炼密钥管理图.png

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

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

阿里云百炼Coding Plan 配置教程：创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
在服务器概览页面单击应用详情页签，进入服务器详情页面。
端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。

三、新手零基础：阿里云计算巢一键部署OpenClaw(Clawdbot)（零代码，10分钟上手）

阿里云计算巢是2026年OpenClaw新手最推荐的部署方案，阿里云官方已将环境配置、依赖安装、安全组设置等复杂步骤高度封装，全程可视化操作，无需输入一行代码，零基础小白也能一次部署成功，同时支持资源统一管理与故障自动恢复，适合快速上线使用。
阿里云计算巢OpenClaw社区版部署.png

（一）部署步骤（全程截图级，新手跟着做）

访问阿里云计算巢OpenClaw社区版部署页面：打开浏览器，访问阿里云计算巢OpenClaw社区版部署页面（可通过阿里云官网搜索“OpenClaw 计算巢”进入），点击页面“立即部署”按钮，登录已完成实名认证的阿里云账号（已登录则直接进入配置页面）；
阅读协议并确认：仔细阅读服务协议与隐私政策，勾选“我已阅读并同意”，点击“下一步”，进入参数配置页面（新手无需修改协议相关内容，直接勾选即可）；
基础参数配置（可视化表单，零代码，重点看）：
- 地域配置：推荐选择中国香港、新加坡（无需ICP备案，支持完整联网功能，且与阿里云百炼API所属地域匹配，降低网络延迟）；中国内地地域（除香港外）联网搜索功能存在限制，不推荐新手选择；
- 资源配置：默认配置为2核2G内存、40GB ESSD存储、200Mbps峰值带宽，完全满足新手基础使用需求；若后续需要多任务并行、复杂推理，可升级至4核8G，存储建议不低于40GB，优先选择ESSD，提升数据读写速度；
- 网络配置：默认启用“公网IP”，无需手动配置端口，系统自动放行OpenClaw核心端口18789（TCP协议）；若需集成Web页面、飞书等应用，可勾选“额外放行80端口”；
- 登录配置：设置服务器登录密码（建议包含字母、数字、特殊符号，复杂度越高越安全），记录好密码，后续远程连接服务器会用到；
确认部署并等待：核对所有参数无误后，点击“创建”，系统开始自动部署，全程约3-5分钟，无需手动操作，新手只需耐心等待即可；
部署完成与验证：待页面显示“已部署”时，点击服务实例ID，在“输出”标签页找到OpenClaw Dashboard URL和初始Admin密码，复制保存；打开浏览器，输入该URL，输入初始密码登录，能成功进入OpenClaw控制台，即为部署成功。

（二）新手验证操作（必做，避免部署成功后无法使用）

部署成功后，建议立即进行简单验证，确保OpenClaw能正常运行：

登录OpenClaw控制台，点击左侧“技能中心”，查看默认技能是否正常加载；
点击“测试对话”，输入简单指令（如“帮我生成一段OpenClaw部署成功的提示语”），此时因未配置API，会提示“模型调用失败”，属于正常现象，后续配置完阿里云百炼API后即可正常使用；
记录控制台显示的“公网IP+端口”，后续配置API、远程访问都会用到，建议保存到文本编辑器中，避免遗漏。

（三）计算巢部署优势与注意事项

优势：零代码、零配置，无需担心环境依赖、端口配置等问题，新手最快5分钟即可完成部署，系统自动配置安全组，无需手动放行端口，降低踩坑概率；
注意事项：
- 部署完成后，不要随意修改服务器配置，避免导致服务异常；
- 初始密码建议及时修改，提升安全性，修改路径：控制台→设置→账号安全；
- 若部署失败，大概率是地域选择错误或资源配置不足，可重新选择地域（中国香港），保持默认资源配置，重新部署即可。

四、新手友好：阿里云轻量服务器部署OpenClaw(Clawdbot)（简单命令，全程复制）

若新手想长期运行OpenClaw，或需要自定义配置、扩展技能，可选择阿里云轻量服务器部署，操作难度低，全程代码可直接复制，无需手动编写，适合有基础操作能力（会复制粘贴命令）的新手，步骤如下：

（一）服务器选购与基础配置（新手必看）

访问阿里云轻量应用服务器控制台，选择“Ubuntu 22.04 LTS”系统镜像（新手首选，兼容性最好，避免版本兼容问题）；
核心配置：新手选择“2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽”即可，足够日常使用；团队使用可升级至4vCPU+8GiB内存+80GiB ESSD；
地域选择：优先选择中国香港（免备案）或华东1（杭州），镜像拉取速度最快，避免网络延迟；
提交订单：确认配置无误后，提交订单，支付完成后，进入阿里云轻量服务器控制台，记录服务器公网IP、默认登录账号（root）与密码，在控制台“安全组”中放行22（SSH）、18789（OpenClaw核心端口）、443（API调用端口），这是新手最易遗漏的步骤，不放行端口会导致无法远程连接和访问控制台。

（二）一键脚本部署（新手推荐，全程复制命令）

远程连接服务器：打开FinalShell（或其他SSH工具），输入服务器公网IP、登录账号（root）、密码，点击“连接”，连接成功后进入终端界面；
执行一键部署脚本（国内优化版，避免下载超时）：

# 1. 连接服务器后，直接复制执行以下命令，无需修改
curl -fsSL https://openclaw.ai/aliyun-install.sh | bash

# 2. 按向导完成核心配置（新手直接按回车键，选择默认配置即可，无需手动修改）
# 关键步骤提示（新手必看，避免选错）：
# ① 风险提示：选择Yes（输入y，按回车）
# ② 网关模式：选择remote（支持远程访问，默认已选中，按回车）
# ③ 绑定地址：0.0.0.0:18789（默认，按回车）
# ④ 模型选择：暂时选择“Custom Provider”（后续配置阿里云百炼API，按回车）
# ⑤ 认证设置：系统自动生成访问令牌，复制保存（登录WebUI用，务必记录，丢失无法找回）

验证部署与开机自启（确保服务能长期稳定运行）：

# 1. 查看服务状态，显示active(running)即为部署成功
systemctl status openclaw

# 2. 设置开机自启，避免服务器重启后服务失效
systemctl enable openclaw

# 3. 验证服务是否正常运行，返回healthy即为正常
curl http://127.0.0.1:18789/api/v1/health

远程访问控制台：打开浏览器，输入 http://服务器公网IP:18789，粘贴之前保存的访问令牌，登录OpenClaw控制台，能成功登录即为部署成功。

（三）Docker Compose部署（进阶新手，稳定性更强）

若新手想提升服务稳定性，实现环境隔离、数据持久化，可选择Docker Compose部署，步骤如下，代码同样可直接复制：

# 1. 登录服务器，安装Docker与Docker Compose（若已安装，可跳过）
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com | bash
sudo apt install docker-compose-plugin -y
sudo systemctl start docker && sudo systemctl enable docker

# 2. 创建项目目录与配置文件（无需修改路径，直接复制）
mkdir -p /opt/openclaw && cd /opt/openclaw
cat > docker-compose.yml << EOF
version: "3.8"
services:
  openclaw:
    image: openclaw/openclaw:2026-latest
    container_name: openclaw
    ports:
      - "18789:18789"
    volumes:
      - openclaw-data:/root/.openclaw
      - /var/log/openclaw:/var/log/openclaw  # 日志持久化，方便排查故障
    restart: unless-stopped
    command: ["openclaw", "gateway", "run"]
    environment:
      - TZ=Asia/Shanghai
      - GATEWAY_MODE=remote
      - GATEWAY_BIND=0.0.0.0:18789
volumes:
  openclaw-data:
EOF

# 3. 启动容器（部署核心步骤，直接复制执行）
docker compose up -d

# 4. 初始化配置（设置访问令牌，替换为你的高强度令牌，建议包含字母、数字、特殊符号）
docker compose exec openclaw openclaw config set gateway.auth.token "你的高强度令牌"

# 5. 查看日志，确认启动成功（无报错即为正常）
docker compose logs -f

部署成功后，同样通过 http://服务器公网IP:18789 访问控制台，粘贴令牌登录即可。

五、核心配置：阿里云百炼Coding Plan API配置（免费可用，新手必做）

OpenClaw本身不具备大模型能力，必须对接阿里云百炼Coding Plan API，才能实现“意图解析、任务规划、技能调用”，新用户可领取90天免费额度，零成本使用，配置步骤简单，新手跟着做即可，全程可视化，无需复杂操作。

（一）阿里云百炼Coding Plan API Key获取步骤（免费，新手必看）

访问登录阿里云百炼大模型服务平台，访问订阅阿里云百炼Coding Plan，进入服务订阅页面；
选择“免费套餐”（新用户可领90天免费额度，足够新手使用），点击“立即订阅”，完成订阅（RAM子账号需主账号授权，个人用户无需额外操作）；
订阅完成后，进入阿里云百炼控制台，点击左侧“密钥管理”，点击“创建API Key”，生成专属API Key（格式为sk-sp-xxxxx），生成后立即复制保存（仅显示一次，丢失无法找回），建议下载密钥文件备份，同时记录专属Base URL：https://coding.dashscope.aliyuncs.com/v1（OpenAI兼容协议，配置时需用到）；
验证API Key有效性：进入百炼控制台“API测试”页面，输入API Key，发送简单测试指令（如“你好”），能正常返回响应，即为API Key有效。

（二）OpenClaw对接百炼API（全程代码，直接复制）

无论选择哪种部署方案，API配置步骤一致，以下是全平台通用配置代码，新手只需替换自己的API Key即可：

# 1. 编辑OpenClaw配置文件（不同系统命令不同，对应复制）
# 阿里云计算巢/阿里云轻量服务器/Linux
nano ~/.openclaw/openclaw.json

# Windows11（PowerShell，管理员模式）
notepad $env:USERPROFILE\.openclaw\openclaw.json

# MacOS（终端）
nano ~/.openclaw/openclaw.json

# 2. 替换配置文件内容（删除原有内容，复制以下代码，替换你的API Key）
{
   
  "models": {
   
    "providers": {
   
      "bailian-coding": {
   
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",  # 固定Base URL，无需修改
        "apiKey": "你的阿里云百炼Coding Plan API Key",  # 替换为自己的API Key
        "api": "openai-completions",
        "models": [
          {
   
            "id": "qwen3.5-coding",
            "name": "百炼Coding Plan Qwen3.5",
            "contextWindow": 32768,
            "maxTokens": 4096,
            "reasoning": false  # 国内模型必设，否则回复为空，新手不要修改
          }
        ],
        "timeout": 30000,  # 超时时间30秒，无需修改
        "maxRetries": 2  # 重试次数，减少无效消耗，新手不要修改
      }
    },
    "default": "bailian-coding/qwen3.5-coding"  # 默认使用百炼模型，无需修改
  },
  "heartbeat": {
     # 成本控制核心，避免免费额度浪费，新手不要修改
    "enabled": true,
    "interval": 300000,  # 心跳间隔5分钟
    "maxIdleTime": 1800000  # 闲置30分钟自动休眠，避免无效Token消耗
  },
  "tools": {
   
    "agentCommunication": {
   
      "enabled": true,
      "allowCrossAgent": true
    }
  }
}

# 3. 保存配置并重启网关（使配置生效，对应系统复制命令）
# 阿里云计算巢/阿里云轻量服务器/Linux
openclaw gateway restart

# MacOS（终端）
pkill -f openclaw && nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 &

# Windows11（PowerShell）
openclaw gateway stop && openclaw gateway start

（三）API配置验证（新手必做，确保配置成功）

配置完成后，必须进行验证，避免因配置错误导致无法使用：

登录OpenClaw控制台，点击“测试对话”，输入指令（如“帮我整理OpenClaw的核心部署步骤”）；
若能返回结构化、完整的响应结果，即为API配置成功；
若提示“模型调用失败”，检查以下3点（新手常见问题）：
- API Key是否正确，是否复制完整（无多余空格）；
- Base URL是否为 https://coding.dashscope.aliyuncs.com/v1，不要修改；
- 网关是否重启，未重启则重新执行重启命令。

（四）API成本控制要点（新手必看，避免免费额度浪费）

启用Heartbeat休眠：配置文件中已默认启用，闲置30分钟自动停止模型调用，避免无效Token消耗，新手不要修改相关参数；
限制maxTokens：普通任务无需修改（默认4096），简单任务可改为2048，不盲目追求高参数，减少Token消耗；
减少重试次数：默认maxRetries=2，避免网络波动导致重复调用，浪费额度；
定期监控额度：登录阿里云百炼控制台，查看剩余免费额度，避免超额，若额度不足，可重新订阅免费套餐（新用户专属）。

六、技能集成：OpenClaw(Clawdbot)技能安装与使用（新手零基础）

OpenClaw的核心价值在于技能扩展，通过ClawHub可快速安装各类技能，涵盖信息聚合、内容生产、开发协作等场景，新手无需编写代码，直接复制命令即可安装，步骤如下：

（一）技能加载规则（新手了解）

OpenClaw的技能从三个地方加载，优先级从高到低为：工作区技能（/skills）> 托管/本地技能（~/.openclaw/skills）> 捆绑技能（随安装一起提供），若技能名称冲突，高优先级技能会覆盖低优先级技能。新手可通过ClawHub安装技能，默认安装到当前工作区，方便管理。

（二）高频技能安装（直接复制命令，新手首选）

以下是新手常用的高频技能，涵盖日常办公、内容生产场景，直接复制命令安装，安装完成后即可使用：

# 1. 安装新闻摘要技能（自动抓取新闻，生成摘要，新手必装）
clawhub install news-aggregator

# 2. 安装飞书集成技能（推送内容到飞书群，团队协作必备）
clawhub install feishu-integration

# 3. 安装密钥扫描技能（避免API Key误提交，开发新手必备）
clawhub install secret-scanner

# 4. 安装PDF摘要技能（提取PDF内容，生成笔记，办公必备）
clawhub install pdf-summary-notes

# 5. 安装多平台内容同步技能（公众号→知乎→小红书，创作者必备）
clawhub install multi-platform-sync

# 6. 安装OCR技能（图片文字提取，含表格，日常实用）
clawhub install ocr-image-to-text

# 7. 更新所有已安装技能（定期更新，修复bug，提升稳定性）
clawhub update --all

# 8. 查看已安装技能（确认技能安装成功）
clawhub list

（三）技能使用示例（新手必看，快速上手）

以“新闻摘要技能”为例，教新手快速使用已安装的技能，全程简单易操作：

安装完成后，登录OpenClaw控制台，点击左侧“技能中心”，找到“news-aggregator”（新闻摘要技能），点击“配置”；
配置新闻来源（如TechCrunch、AI行业资讯）、分类（如AI、科技），保存配置；
点击“测试对话”，输入指令：“帮我抓取今天的3条AI行业新闻，生成摘要”；
OpenClaw会自动抓取新闻、生成结构化摘要，无需人工干预，完成后可通过飞书技能推送至指定群聊，实现全流程自动化。

（四）技能安装避坑要点

安装技能前，确保ClawHub已正确安装（执行clawhub -V验证），若提示“command not found”，执行source ~/.zshrc（MacOS/Linux）或重启PowerShell（Windows）；
安装第三方技能前，建议先使用技能审计工具扫描，避免安全风险，命令：clawhub install skill-auditor && openclaw skills run skill-auditor --skill "第三方技能名称" --output "audit.md"；
若技能安装后无法调用，执行以下命令修复：
```bash
刷新技能列表
openclaw skills refresh

安装技能缺失依赖（替换为无法调用的技能名称）

cd ~/.openclaw/skills/技能名称 && pnpm install


## 七、新手避坑指南：OpenClaw(Clawdbot)部署+API配置高频坑（必看，少走弯路）
结合全网实测经验与新手反馈，整理10个最常见的坑，每个坑都给出具体解决方案，新手提前看，可避免90%的部署失败问题，重点关注：

### （一）环境依赖类坑（新手最常踩）
1.  坑1：Node.js版本不兼容
    - 现象：启动OpenClaw时，报错“ERR_MODULE_NOT_FOUND”“Unsupported engine”；
    - 原因：安装了过低（<18.x）或过高（>23.x）版本，OpenClaw核心依赖Node.js 22.x LTS版本，版本偏差会导致依赖包加载失败；
    - 解决方案：卸载现有Node.js，重新安装v22.2.0版本，命令如下：
```bash
# Windows：控制面板卸载Node.js，重新执行安装命令
# MacOS
brew uninstall node
arch -arm64 brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Linux/阿里云轻量服务器
sudo npm install -g n && sudo n 22.2.0

坑2：权限不足导致安装/部署失败
- 现象：Windows用普通cmd/PowerShell执行脚本，报错“权限被拒绝”；MacOS/Linux执行curl脚本后提示“Permission denied”；
- 原因：安装过程需要写系统目录、创建服务，普通权限不够；
- 解决方案：Windows右键启动PowerShell（管理员）；MacOS/Linux在脚本前加“sudo”，如sudo curl -fsSL https://openclaw.ai/install.sh | bash。

（二）网络/镜像类坑（国内用户高发）

坑3：拉取依赖/镜像超时

现象：执行pnpm install/docker pull时卡住，提示“Timeout”“无法连接到registry”；
原因：默认镜像源在海外，国内网络访问慢/被拦截；

解决方案：配置国内镜像，执行以下命令（已在基础工具安装中配置，若仍超时，重新执行）：

# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 配置ClawHub国内镜像
clawhub config set registry https://clawhub-mirror.aliyuncs.com
# 配置Docker国内镜像（阿里云轻量服务器专属）
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
       
"registry-mirrors": ["https://docker.mirrors.aliyun.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

坑4：API Key配置后无法调用模型
- 现象：填了API Key后，测试发送消息提示“模型调用失败”“API Key无效”；
- 原因：① API Key选错平台；② Key未启用；③ 免费额度已用完；
- 解决方案：核对API Key格式（sk-sp-xxxxx），确认Base URL正确；登录阿里云百炼控制台，确认Key状态为“启用”；查看剩余额度，若额度不足，重新订阅免费套餐。

（三）部署类坑（新手重点关注）

坑5：阿里云计算巢部署后，无法访问控制台
- 现象：输入Dashboard URL，无法打开页面，提示“无法访问此网站”；
- 原因：地域选择错误（如选择国内内地地域），或安全组未自动放行端口；
- 解决方案：重新部署，选择中国香港地域；进入阿里云控制台，手动放行18789端口，重启部署服务。
坑6：阿里云轻量服务器部署后，端口被占用
- 现象：启动服务时，提示“Port 18789 is already in use”，服务无法启动；
- 原因：18789端口被其他软件占用；
- 解决方案：查看占用端口的进程，结束进程，或修改OpenClaw端口：
```
# 查看端口占用（Linux/阿里云轻量服务器）
lsof -i:18789
# 结束占用进程（替换为查询到的PID）
sudo kill -9 PID
# 或修改端口（新手不推荐，容易导致后续配置异常）
openclaw configure
```
坑7：Docker部署后容器“秒退”
- 现象：执行docker run后，用docker ps看不到容器，日志提示“permission denied”“config file not found”；
- 原因：挂载目录权限不足，或配置文件未生成；
- 解决方案：给挂载目录加权限，先执行配置向导再启动：
```
# 给挂载目录加权限（Linux/macOS/阿里云）
sudo chmod 777 ~/.openclaw
# 执行配置向导
docker exec -it openclaw openclaw onboard
# 重启容器
docker compose restart openclaw
```

（四）系统兼容类坑

坑8：Windows系统中文路径导致失败
- 现象：安装OpenClaw到中文路径（如“D:\我的文件\openclaw”），启动报错；
- 原因：Windows系统不支持中文路径，导致文件加载失败；
- 解决方案：卸载OpenClaw，重新安装到纯英文路径（如“D:\openclaw”），安装过程中不要修改默认路径。
坑9：MacOS提示“无法打开openclaw，因为无法验证开发者”
- 现象：安装完成后，启动OpenClaw，提示无法验证开发者，无法打开；
- 原因：MacOS安全机制拦截未签名的二进制文件；
- 解决方案：右键OpenClaw执行文件→选择“打开”（首次需手动确认）；或执行命令解除隔离：xattr -d com.apple.quarantine /usr/local/bin/openclaw。

（五）认知类坑（最易被骗）

坑10：相信“付费激活/代部署”
- 现象：找第三方“代装OpenClaw”，付费50-200元，结果用的还是官方免费脚本；
- 真相：OpenClaw全程开源免费，官方一键脚本/镜像无任何“激活费、会员费、授权费”；
- 解决方案：拒绝任何收费代装、激活码，直接按照本文步骤，使用官方脚本部署，全程免费。

八、常见问题解答（FAQ）：新手遇到问题，直接查这里

（一）部署类问题

问题1：阿里云计算巢部署成功后，忘记初始Admin密码怎么办？
- 解决方案：进入阿里云计算巢控制台，找到对应服务实例，点击“重置密码”，重新设置密码后，重启服务即可。
问题2：阿里云轻量服务器部署后，远程连接失败？
- 解决方案：① 确认服务器公网IP正确；② 确认安全组已放行22端口；③ 确认登录账号（root）和密码正确；④ 若仍失败，重启服务器，重新连接。
问题3：本地部署后，无法访问控制台？
- 解决方案：① 检查端口是否被占用，结束占用进程；② 确认OpenClaw服务已启动（执行openclaw gateway status）；③ 确认防火墙已放行18789端口。

（二）API与技能类问题

问题1：阿里云百炼API调用提示“鉴权失败”？
- 解决方案：① 核对API Key格式，确保无多余空格；② 确认Base URL为https://coding.dashscope.aliyuncs.com/v1；③ 检查RAM子账号权限（个人用户无需操作）；④ 重新生成API Key，重新配置。
问题2：技能安装后，无法在控制台找到？
- 解决方案：执行openclaw skills refresh刷新技能列表；若仍无法找到，重新安装技能，检查ClawHub是否正常运行（执行clawhub -V）。
问题3：定时任务未执行？
- 解决方案：① 检查cron服务是否运行（Linux：systemctl status cron）；② 验证cron表达式正确性（可通过在线工具校验）；③ 查看日志：tail -f ~/.openclaw/logs/cron.log，排查错误原因。

（三）其他问题

问题1：OpenClaw响应速度慢？
- 解决方案：① 更换阿里云地域（如华东用户选杭州）；② 降低maxTokens参数（改为2048）；③ 卸载不常用技能，减少资源占用；④ 检查网络状态，确保网络通畅。
问题2：如何备份OpenClaw数据？
- 解决方案：默认数据存储在~/.openclaw目录（Windows：C:\Users\你的用户名\.openclaw），定期复制该目录，保存到本地或云盘，即可完成备份；阿里云部署可开启云盘快照，每天自动备份。

九、总结

2026年，OpenClaw(Clawdbot)已成为新手零基础入门AI Agent的首选工具，而阿里云提供的计算巢一键部署、轻量服务器部署方案，彻底降低了部署门槛，搭配阿里云百炼Coding Plan免费API，新手可零成本解锁全量自动化能力，无需复杂编程技能，全程复制代码、可视化操作即可完成部署与配置。

本文核心要点总结，新手必记：

部署选择：零基础小白优先选阿里云计算巢一键部署（零代码、10分钟上手）；想长期运行、自定义配置，选阿里云轻量服务器部署；隐私需求高，选本地部署；
API配置：阿里云百炼Coding Plan是核心，新用户可领90天免费额度，配置时务必核对API Key和Base URL，重启网关使配置生效；
技能集成：通过ClawHub可快速安装各类技能，新手从高频技能（新闻摘要、OCR）入手，逐步扩展，安装后可直接使用，无需额外配置；
避坑关键：严格匹配Node.js v22版本，配置国内镜像，放行对应端口，避免中文路径，拒绝付费代部署，启用Heartbeat控制成本；
问题排查：遇到问题先查看日志，或对照本文FAQ，90%的新手问题都能快速解决，无需额外求助。

通过本文的保姆级教程，新手可快速完成OpenClaw(Clawdbot)的部署、API配置与技能集成，真正让这款开源工具成为自己的“数字化助手”，实现工作自动化，节省时间成本，无论是日常办公、内容创作，还是开发协作，都能大幅提升效率。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

阿里云计算巢部署 Hermes Agent / OpenClaw、配置百炼API+避坑教程