“小龙虾”OpenClaw 进阶保姆级教程！阿里云/本地部署、百炼Coding Plan API配置+常见Skills安装指南

OpenClaw（昵称“小龙虾”，曾用名Clawdbot、Moltbot）作为2026年热门的开源AI智能体工具，核心价值在于通过Skills（技能插件）扩展实际任务执行能力。默认状态下的OpenClaw仅能满足基础聊天需求，而合理配置部署环境、安装适配Skills、对接AI模型API后，它可实现自动化办公、全网检索、代码管理等多样化功能，真正成为“能做事的AI管家”。

新手使用时常面临两大痛点：一是部署流程混乱，不清楚适配自身场景的方案；二是忽视安全风险盲目安装Skills，导致信息泄露或系统崩溃。本文基于2026年OpenClaw最新稳定版（v1.9.2），结合官方文档与实测经验，详细拆解阿里云云端部署、本地多系统（MacOS/Linux/Windows11）部署流程，补充阿里云百炼及免费大模型Coding Plan API配置方法，梳理Skills安装的正确顺序与高频实用清单，附上90%用户会遇到的问题排查方案，所有代码命令可直接复制执行，助力新手安全高效解锁OpenClaw完整能力。阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、部署前基础准备

（一）硬件与软件要求

• 硬件配置：云端部署推荐2核2G及以上服务器（4核4G更佳）；本地部署需CPU≥4核、内存≥8GB、硬盘剩余空间≥20GB，确保多Skills同时运行流畅。
• 必备工具：Git（版本控制）、Node.js（≥22.0.0 LTS版，Skills管理核心依赖）、终端工具（Windows推荐WSL2+Ubuntu，MacOS/Linux自带终端）、远程连接工具（如FinalShell，用于云端部署）、文本编辑器（如VS Code，修改配置文件）。
• 网络要求：稳定的互联网连接，部署过程需下载源码与依赖包，建议带宽≥10Mbps；国内用户本地部署时，可切换国内镜像源加速下载。
• 账号准备：阿里云账号（云端部署与百炼API配置用）、GitHub账号（可选，获取Skills源码）、目标AI模型平台账号（免费API配置用）。

（二）核心服务与资源准备

1. 阿里云服务开通（云端部署专用）：注册阿里云账号，登录阿里云官网完成实名认证，开通“轻量应用服务器”与“阿里云百炼”服务，两者均免费开通，仅服务器租赁需付费，百炼可领取新用户90天免费调用额度。
2. 免费大模型资源整理：收集支持Coding Plan API的免费模型平台，如通义千问开放平台、GLM开源社区等，提前注册账号并了解API调用规则与免费额度。
3. 安全防护意识：明确Skills安装优先级，安全类技能需优先部署，避免安装来源不明的第三方技能，防止API密钥、Cookie等敏感信息泄露。

二、多场景部署流程（2026实测稳定版）

（一）阿里云云端部署（推荐，支持7×24小时运行）

阿里云提供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. 服务器购买与配置：

• 访问阿里云OpenClaw一键部署专题页面，点击【一键购买并部署】。
• 配置选择：镜像勾选“OpenClaw 2026.3.3（Moltbot）”，实例选择2核2G及以上（内存≤2GiB会导致Skills运行卡顿），系统盘40GiB ESSD，地域推荐美国（弗吉尼亚）或中国香港（国内地域除香港外，联网搜索功能受限），购买时长根据需求选择（测试阶段可选1个月）。
• 支付完成后，在阿里云控制台获取服务器公网IP、默认用户名（root）与登录密码（购买时设置）。

1. 服务器连接与端口配置：

• 打开FinalShell，新建连接，输入公网IP、用户名与密码，建立远程连接。
• 开放默认端口：执行以下命令放行OpenClaw服务端口（默认18789），避免防火墙拦截：

  # CentOS系统
  firewall-cmd --zone=public --add-port=18789/tcp --permanent
  firewall-cmd --reload
  # Ubuntu系统
  ufw allow 18789
  ufw reload
  

1. 初始化OpenClaw配置：

• 在服务器控制台点击实例ID进入概览页，切换至“应用详情”标签页。
• 执行基础配置命令：依次点击“初始化OpenClaw配置”“查看Token”“开启公网访问”对应的执行按钮，系统会自动完成环境初始化。
• 验证部署：获取Web UI面板地址（应用详情页执行“获取Web UI面板地址”命令），在本地浏览器访问该地址，若出现交互界面则部署成功。

（二）本地部署流程（MacOS/Linux/Windows11）

1. MacOS系统部署

1. 依赖环境安装：
   打开终端，执行以下命令安装Git、Node.js与核心依赖：

   # 安装Homebrew（已安装可跳过）
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   # 安装Git与Node.js（Node.js≥22.0.0）
   brew install git nodejs
   # 切换npm国内镜像源，加速依赖下载
   npm config set registry https://registry.npmmirror.com
   # 验证版本
   node -v  # 显示v22.x.x即为合格
   git --version
   

2. 源码下载与初始化：

   # 创建工作目录
   mkdir -p ~/openclaw/workspace
   cd ~/openclaw/workspace
   # 克隆OpenClaw源码
   git clone https://github.com/openclaw/openclaw.git ./openclaw-core
   cd openclaw-core
   # 安装项目依赖
   pnpm install  # 无pnpm可先执行npm install -g pnpm
   # 编译项目
   pnpm build
   # 全局链接，便于终端直接调用命令
   pnpm link --global
   # 初始化配置文件
   cp config.example.json config.json
   

3. 启动与验证：

   # 启动OpenClaw服务
   openclaw start
   # 后台运行（可选）
   nohup openclaw start > openclaw.log 2>&1 &
   

   启动成功后，访问http://localhost:18789即可进入Web UI交互界面。

2. Linux系统部署（以Ubuntu 22.04为例）

1. 系统更新与依赖安装：

   # 更新系统包
   sudo apt update && sudo apt upgrade -y
   # 安装Git、Node.js与编译依赖
   sudo apt install git nodejs npm build-essential -y
   # 升级npm与安装pnpm
   npm install -g npm@latest pnpm
   # 切换国内镜像源
   npm config set registry https://registry.npmmirror.com
   

2. 源码部署与配置：

   # 创建工作目录并授权
   sudo mkdir -p /opt/openclaw
   sudo chown $USER:$USER /opt/openclaw
   cd /opt/openclaw
   # 克隆源码
   git clone https://github.com/openclaw/openclaw.git ./openclaw-core
   cd openclaw-core
   # 安装依赖与编译
   pnpm install
   pnpm build
   # 全局链接
   pnpm link --global
   # 复制配置文件
   cp config.example.json config.json
   

3. 设置开机自启（可选）：

   # 创建系统服务文件
   sudo nano /etc/systemd/system/openclaw.service
   

   粘贴以下内容：

[Unit]
Description=OpenClaw Service
After=network.target

[Service]
User=root
WorkingDirectory=/opt/openclaw/openclaw-core
ExecStart=/usr/local/bin/openclaw start
Restart=always

[Install]
WantedBy=multi-user.target

保存后执行：

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
# 查看运行状态
sudo systemctl status openclaw

3. Windows11系统部署（推荐WSL2环境）

1. 启用WSL2与安装Ubuntu：
   以管理员身份打开PowerShell，执行以下命令：

   # 启用WSL2
   wsl --install
   # 重启电脑后，打开Microsoft Store搜索Ubuntu并安装
   # 启动Ubuntu，设置用户名与密码
   

2. 依赖安装与源码部署：
   在Ubuntu终端中执行：

   # 安装依赖
   sudo apt update && sudo apt install git nodejs npm -y
   npm install -g pnpm
   npm config set registry https://registry.npmmirror.com
   # 下载源码
   mkdir -p ~/openclaw/workspace
   cd ~/openclaw/workspace
   git clone https://github.com/openclaw/openclaw.git ./openclaw-core
   cd openclaw-core
   pnpm install
   pnpm build
   pnpm link --global
   cp config.example.json config.json
   # 启动服务
   openclaw start
   

3. 本地直接部署（无WSL2）：

• 下载并安装Git与Node.js（勾选“Add to PATH”），打开PowerShell执行：

  # 创建工作目录
  mkdir -Force C:\openclaw\workspace
  cd C:\openclaw\workspace
  git clone https://github.com/openclaw/openclaw.git .\openclaw-core
  cd .\openclaw-core
  npm install -g pnpm
  pnpm install
  pnpm build
  pnpm link --global
  copy config.example.json config.json
  openclaw start
  

（三）Docker部署方案（跨平台通用，推荐服务器/自托管）

适合需要隔离运行环境、避免依赖冲突的用户：

1. 安装Docker：根据操作系统安装Docker Desktop（Windows/MacOS）或Docker Engine（Linux），确保Docker服务正常运行。
2. 拉取镜像并启动：

   # 拉取OpenClaw官方最新镜像
   docker pull openclaw/openclaw:latest
   # 启动容器
   docker run -d \
   --name openclaw \
   -p 18789:18789 \
   -v ~/openclaw-data:/root/.openclaw \
   --restart always \
   openclaw/openclaw:latest
   # 进入容器完成初始化
   docker exec -it openclaw openclaw onboard
   

3. 访问验证：浏览器打开http://localhost:18789，按提示完成初始设置即可。

三、AI模型API配置（阿里云百炼+免费Coding Plan）

（一）阿里云百炼API配置

1. 购买Coding Plan与获取密钥：

• 访问登录阿里云百炼大模型服务平台，选择“Coding Plan”，根据需求购买套餐（首购低至7.9元/月，支持通义千问、Kimi-k2.5等多模型）。
• 进入“API密钥管理”，点击“创建密钥”，生成AccessKey ID与AccessKey Secret，妥善保存（仅显示一次，泄露需及时重置）。
• 复制套餐专属Base URL：兼容OpenAI接口协议的地址为https://coding.dashscope.aliyuncs.com/v1。

1. 配置OpenClaw调用：

• 打开配置文件（本地路径：~/openclaw/workspace/openclaw-core/config.json；云端路径：/opt/openclaw/openclaw-core/config.json）。
• 编辑模型配置字段：

  "llm": {
       
  "provider": "aliyun-bailian",
  "accessKeyId": "你的AccessKey ID",
  "accessKeySecret": "你的AccessKey Secret",
  "model": "Qwen3.5-Plus",  // 选择已订阅的模型
  "endpoint": "https://coding.dashscope.aliyuncs.com/v1"
  }
  

• 重启服务生效：

  # 本地部署
  openclaw restart
  # 云端部署（Docker容器）
  docker restart openclaw
  

（二）免费大模型Coding Plan API配置（以通义千问开放平台为例）

1. 获取API密钥：

• 登录通义千问开放平台，完成实名认证后，进入“API密钥管理”创建密钥，获取api_key与api_secret。
• 查看免费额度：新用户可领取一定额度的免费调用次数，支持Qwen-Tiny、Qwen-Lite等模型。

1. 配置OpenClaw：
   修改config.json文件：

   "llm": {
        
   "provider": "qwen",
   "apiKey": "你的api_key",
   "apiSecret": "你的api_secret",
   "model": "qwen-tiny",
   "endpoint": "https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation"
   }
   

   重启服务后，发送测试指令（如“总结OpenClaw的核心功能”），若正常返回结果则配置成功。

四、Skills安装：正确顺序与高频实用清单

（一）Skills安装的4种方法（从易到难）

1. 自带基础Skills启用（零配置，适合测试）

OpenClaw默认预装53个基础Skills（如文件读写、简单文本处理），通过以下命令管理：

# 列出所有自带Skills
openclaw skills list
# 查看当前可用技能
openclaw skills list --eligible
# 启用指定技能（如文件管理）
openclaw skills enable file-master
# 禁用存在安全风险的技能（如find-skills）
openclaw skills disable find-skills
# 检查技能状态
openclaw skills check text-pro

2. ClawHub安装（推荐，资源丰富且安全）

ClawHub是OpenClaw官方技能商店，操作简洁且技能经过基础验证：

# 安装ClawHub客户端
npm i -g clawhub
# 搜索技能（如搜索日程管理相关）
clawhub search "calendar"
# 安装指定技能（可指定版本）
clawhub install calendar-manager --version 1.2.0
# 强制覆盖已安装技能
clawhub install office-automator --force
# 更新单个技能
clawhub update tavily-search
# 更新所有已安装技能
clawhub update --all
# 查看已安装技能
clawhub list

3. GitHub批量安装（适合进阶用户）

通过GitHub仓库链接批量下载Skills源码：

# 进入Skills工作目录
cd ~/.openclaw/workspace/skills
# 克隆技能仓库
git clone https://github.com/openclaw/awesome-openclaw-skills.git ./basic-skills
# 重启OpenClaw加载技能
openclaw restart

4. 自然语言自动安装（新手首选）

直接在OpenClaw Web UI交互界面发送指令，无需手动输入命令：
“请帮我安装GitHub链接为https://github.com/prompt-security/clawsec的Skills，并启用它”
“安装tavily-search技能，完成后帮我配置API密钥”

（二）Skills安装的正确顺序（避免崩溃）

OpenClaw采用模块化依赖架构，技能安装顺序错误会导致冲突、资源抢占或崩溃，按以下优先级安装：

1. 环境校验与核心依赖：先执行openclaw check env校验环境，安装memory-manager（内存管理）、dependency-checker（依赖检查）、process-guard（进程守护）3个核心依赖技能。
2. 安全与权限组件：优先安装安全类技能，建立防护屏障：

   # 安装技能安全扫描工具
   clawhub install skill-vetter
   # 安装安全配置指南（慢雾团队推出）
   git clone https://github.com/slowmist/openclaw-security-practice-guide.git ./skills/security-guide
   # 安装强制安全检查工具
   clawhub install clawsec
   # 启用安全扫描（安装新技能前执行）
   skill-vetter office-automator
   

3. 通用基础技能：安装文件读写（file-master）、文本处理（text-pro）、数据解析（data-parser）、网络请求（web-fetch）等通用技能，为专项技能提供基础支持。
4. 场景专项技能：根据自身需求安装办公、开发、自动化等场景技能，避免盲目全装。
5. 调度与优化技能：最后安装task-scheduler（任务调度）、cache-opt（缓存优化）、auto-updater（自动更新）技能，提升整体运行效率。

（三）2026高频实用Skills清单（安全验证版）

1. 检索类技能

• Tavily Search：AI优化搜索引擎，结构化输出结果，支持实时资讯获取：

  clawhub install tavily-search
  # 使用示例
  openclaw run --command "用Tavily Search查找2026年Python最新特性，提炼3个核心升级点"
  

• Multi Search Engine：聚合17个搜索引擎，信息更全面：

  clawhub install multi-search-engine
  

2. 办公自动化技能

• Office Automator：批量处理Word/Excel/PDF，支持格式转换与数据统计：

  clawhub install office-automator
  # 安装依赖
  pip3 install python-docx pandas pdfplumber --index-url=https://pypi.tuna.tsinghua.edu.cn/simple
  # 使用示例
  openclaw run --command "分析'销售数据.xlsx'，统计各产品销售额占比"
  

• Calendar Manager：管理多平台日程，支持会议创建与提醒：

  clawhub install calendar-manager
  

3. 开发者必备技能

• GitHub Skill：对接GitHub，支持仓库管理与PR检查：

  clawhub install github
  # 配置GitHub Token
  openclaw config set skills.github.token "你的GitHub Personal Access Token"
  

• Code Review：自动审查代码语法错误与安全漏洞：

  clawhub install code-review
  

4. 自动化与工具类技能

• Agent Browser：模拟浏览器操作，支持网页抓取与表单填写：

  clawhub install agent-browser
  

• Auto Backup：定期备份配置与数据，避免丢失：

  clawhub install auto-backup
  # 配置备份路径与周期（每天0点备份）
  openclaw config set skills.auto-backup.path "~/.openclaw/backup" --schedule "0 0 * * *"
  

五、常见问题排查（解决90%的使用问题）

（一）部署相关问题

1. 启动失败提示“端口被占用”：

   # Linux/MacOS查看占用18789端口的进程
   lsof -i :18789
   # 终止进程（替换PID为实际进程ID）
   kill -9 PID
   # Windows系统
   netstat -ano | findstr :18789
   taskkill /F /PID PID
   # 或修改配置文件更换端口（编辑config.json的port字段）
   

2. 依赖安装慢或失败：

• 切换国内镜像源：npm config set registry https://registry.npmmirror.com
• 清除npm缓存：npm cache clean --force
• 手动安装缺失依赖：根据错误提示执行pip3 install 依赖库名称

1. 阿里云服务器部署后无法访问：

• 检查服务器状态：阿里云控制台确认实例处于“运行中”状态。
• 验证端口开放：执行firewall-cmd --list-ports（CentOS）或ufw status（Ubuntu），确认18789端口已开放。
• 检查服务状态：docker exec -it openclaw openclaw status（Docker部署），确保服务正常运行。

（二）API配置相关问题

1. 调用提示“权限不足”或“密钥无效”：

• 检查密钥正确性：确认AccessKey ID/Secret无拼写错误，区分大小写。
• 验证额度与有效期：阿里云百炼控制台查看免费额度是否用尽，Coding Plan是否过期。
• 检查网络连通性：云端服务器选择香港/海外地域，避免国内网络限制。

1. 模型调用提示“模型不存在”：

• 确认模型名称正确：参考官方文档填写模型标识（如“Qwen3.5-Plus”而非“qwen3.5-plus”）。
• 检查模型订阅状态：确保已在API平台订阅该模型，未订阅的模型无法调用。

（三）Skills相关问题

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

   # Linux/MacOS赋予Skills目录读写权限
   chmod -R 777 ~/.openclaw/workspace/skills
   # Windows以管理员身份运行终端
   

2. 技能安装后无法启用：

• 检查依赖：执行openclaw skills check <技能名称>查看缺失依赖，按提示安装。
• 验证版本兼容性：查看技能文档，确认支持当前OpenClaw版本（v1.9.2）。
• 重新安装技能：clawhub install <技能名称> --force

1. 安全类技能拦截正常安装：

• 查看扫描报告：确认技能是否索取过度权限（如无理由访问本地文件）。
• 临时关闭强制检查（确认安全后）：

  openclaw config set security.clawsec.autoCheck false
  

• 安装后立即开启：openclaw config set security.clawsec.autoCheck true

（四）系统稳定性问题

1. 运行中崩溃或卡顿：

• 关闭冗余技能：仅启用当前需要的技能，执行openclaw skills disable <技能名称>。
• 检查内存占用：top（Linux/MacOS）或任务管理器（Windows），关闭占用过高的其他程序。
• 按正确顺序重新安装技能：重置Skills目录，按“环境校验→安全组件→基础技能→专项技能→调度优化”顺序重装。

1. 技能执行无响应：

• 重启OpenClaw服务：openclaw restart
• 验证网络连接：确保能正常访问外部网络，检索类技能需联网运行。
• 检查API配置：确认模型API密钥有效、额度充足，重新配置后重启服务。

六、核心要点总结

1. 部署方案选择：需要长期运行选阿里云云端部署，利用专属镜像简化流程；本地测试或个性化配置选本地部署，Docker方案可避免依赖冲突。
2. 安全优先原则：安装任何技能前先启用skill-vetter扫描，涉及敏感操作必装ClawSec与x402janus，禁用find-skills等高危技能。
3. API配置技巧：新手可先使用免费大模型API熟悉流程，复杂场景切换阿里云百炼Coding Plan，提升执行稳定性与精度。
4. Skills安装原则：按“环境→安全→基础→专项→调度”顺序安装，遵循“少而精”，避免冗余技能导致冲突。
5. 问题排查逻辑：遇到问题优先排查“网络连通性→依赖完整性→配置正确性→权限充足性”，多数问题可快速定位解决。

通过本文的流程与技巧，新手可在1-2小时内完成OpenClaw全流程部署与核心配置，让AI智能体真正具备实际任务执行能力，从重复劳动中解放，专注核心工作。如需进一步拓展功能，可探索自定义Skills开发、多角色团队搭建等进阶内容，持续挖掘OpenClaw的自动化潜力。