AI小龙虾 OpenClaw 通关手册：阿里云部/本地安装、免费大模型API配置、必装Skill配置与问题排查指南

2026年的AI自动化工具生态中，OpenClaw（原Clawdbot，昵称AI小龙虾）凭借插件化技能生态+本地化执行+多端交互的核心优势成为热门，其核心竞争力并非模型本身，而是能通过Skills技能包实现“思考-执行-优化”的全流程自动化，让AI从“聊天顾问”变成“落地员工”。但多数用户在接触时会陷入两大困境：一是部署环节不知如何选择阿里云云端部署还是本地MacOS/Linux/Windows11部署，二是面对超1.8万个Skills技能包无从下手，同时还存在技能质量参差、权限失控等问题。本文将从部署前置准备、阿里云与本地多系统部署流程、阿里云百炼Coding Plan免费大模型API配置、必装Skills技能包选择与配置、常见问题解答五个维度，一次性讲透OpenClaw的落地与使用，全程附带可直接执行的代码命令，零基础也能上手。

一、部署前置准备：环境与工具核心要求

无论选择阿里云部署还是本地部署，都需先满足基础环境要求，提前准备核心工具与账号，全程无付费项，是落地OpenClaw的基础前提：

1. 系统与硬件要求

• Windows：Windows11（需启用WSL2，部分命令依赖Linux子系统），内存≥8GB（推荐16GB），硬盘剩余≥20GB，CPU开启虚拟化
• MacOS：macOS 10.15+，内存≥8GB，硬盘剩余≥20GB
• Linux：Ubuntu 20.04+/CentOS 8+，内存≥8GB，硬盘剩余≥20GB
• 阿里云：轻量应用服务器实例内存≥2GiB，推荐2核4GB，地域优先选择美国弗吉尼亚/新加坡（无网络限制，支持联网搜索等功能）

  2. 基础工具安装

  所有部署方式均需安装Node.js 18.x及以上版本（新版自动配置环境变量），验证命令如下，终端显示版本号即环境正常：

  node -v
  npm -v
  

  3. 账号与资源准备

• 阿里云账号：注册阿里云账号，完成个人/企业实名认证，确保无欠费，具备轻量应用服务器购买权限
• 阿里云百炼账号：完成实名认证，用于获取免费大模型API-Key，访问订阅阿里云百炼Coding Plan。
• Clawhub技能市场：无需注册，直接通过命令行安装技能，官网可查看技能详情：https://clawhub.ai/skills?sort=downloads

二、2026年OpenClaw全部署流程：阿里云+本地多系统实操

OpenClaw支持阿里云轻量应用服务器一键部署和MacOS/Linux/Windows11本地部署，阿里云部署适合追求便捷、无需占用本地设备的用户，本地部署则适合注重数据隐私、需要高频操作本地文件的用户，以下分平台附详细代码命令，步骤可直接复刻。

（一）阿里云轻量应用服务器一键部署：30分钟零基础落地

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

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

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

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

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

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

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼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 的地址。
  
  

2026年阿里云针对OpenClaw推出专属预装镜像，将原本数小时的环境配置简化为“一键部署”，无需手动安装依赖，具体步骤如下：

1. 购买并部署服务器
   访问阿里云OpenClaw一键部署专题页面，点击【一键购买并部署】，核心配置选择：
   • 镜像：OpenClaw(Moltbot)应用镜像（预装Node.js 22、Docker、OpenClaw核心程序）
   • 实例规格：2核4GB内存（最低2GiB，低于该配置服务启动失败）
   • 地域：美国弗吉尼亚/新加坡（国内地域除香港外，联网搜索功能受限）
     支付后等待5-10分钟，实例状态变为“运行中”即完成基础部署。
2. 服务器状态验证
   进入轻量应用服务器实例详情页，通过Web终端（新手推荐，无需SSH工具）登录，执行以下命令验证环境：

   uname -r # 查看系统内核，正常输出5.10.x-aliyun.x86_64
   docker -v # 查看Docker版本，正常输出20.10.x+
   systemctl status openclaw # 查看OpenClaw状态，正常输出active(running)
   

   若使用本地SSH工具（FinalShell/Xshell），登录命令为：ssh root@你的服务器公网IP（密码在阿里云控制台重置）。
3. 核心端口放行
   OpenClaw的控制台访问、技能通信依赖1878（控制台）和18789（服务通信）端口，需先放行，执行命令：

   # 放行端口并重启防火墙
   firewall-cmd --add-port=1878/tcp --permanent
   firewall-cmd --add-port=18789/tcp --permanent
   firewall-cmd --reload
   # 验证端口放行状态，输出1878/tcp、18789/tcp即为成功
   firewall-cmd --list-ports | grep -E "1878|18789"
   

   同时在阿里云控制台安全组中补充放行上述端口，确保外部可访问。
4. 生成访问Token
   在实例「应用详情」页执行命令生成OpenClaw访问Token，用于后续身份验证：

   openclaw token generate
   

   复制生成的Token，打开控制台提供的网站链接，输入Token即可进入OpenClaw对话页面。

（二）Windows11本地部署：PowerShell管理员模式操作

Windows11部署需以管理员身份运行PowerShell，避免权限不足导致安装失败，全程通过npm命令实现：

1. 全局安装OpenClaw主程序与Clawhub技能管理工具：

   npm install -g openclaw
   npm install -g clawhub
   

2. 初始化OpenClaw配置，终端将引导设置工作区路径、默认聊天应用等，新手直接按回车选默认：

   openclaw init
   

3. 验证安装成功，终端显示版本号即部署完成：

   openclaw --version
   clawhub --version
   

4. 启动OpenClaw主程序，终端显示“Gateway started”即为成功：

   openclaw start
   

5. 默认安装路径：C:\Users\用户名\.openclaw\，技能包与记忆文件均存放在该目录。

（三）MacOS本地部署：终端+Homebrew辅助安装

MacOS部署需通过终端操作，未安装Node.js的用户可通过Homebrew快速安装，步骤如下：

1. 打开终端（Launchpad-其他-终端），安装Node.js（已安装可跳过）：

   brew install node
   

2. 全局安装OpenClaw与Clawhub，添加sudo获取管理员权限（输入开机密码，终端无显示直接回车）：

   sudo npm install -g openclaw
   sudo npm install -g clawhub
   

3. 初始化配置并验证安装：

   openclaw init
   openclaw --version
   clawhub --version
   

4. 启动主程序：

   openclaw start
   

5. 默认安装路径：~/.openclaw/，终端输入open ~/.openclaw可直接打开该目录。

（四）Linux本地部署（Ubuntu为例，其他发行版通用）

Linux部署以Ubuntu为基础，CentOS/Deepin等发行版命令仅需微调包管理器，核心步骤一致：

1. 打开终端，更新系统源并安装Node.js和npm：

   sudo apt update && sudo apt install nodejs npm -y
   

2. 验证Node.js版本≥18.x，若版本过低可通过n模块升级：

   node -v
   sudo npm install -g n && sudo n stable
   

3. 全局安装OpenClaw与Clawhub：

   sudo npm install -g openclaw
   sudo npm install -g clawhub
   

4. 初始化配置并启动服务：

   openclaw init
   openclaw start
   

5. 默认安装路径：~/.openclaw/或/root/.openclaw/，通过ls ~/.openclaw可查看目录结构。

三、阿里云百炼Coding Plan API配置：对接免费大模型，赋予OpenClaw“思考能力”

OpenClaw的Agent“大脑”本身不具备思考能力，需对接外部大模型才能完成任务拆解与决策，2026年阿里云百炼Coding Plan提供免费大模型资源（如qwen-turbo、qwen-max），无需付费即可对接，是性价比最高的选择，以下为全部署方式通用的配置步骤：

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

1. 访问登录阿里云百炼大模型服务平台。
2. 进入「密钥管理」页面，点击【创建API-Key】，保存生成的Access Key ID和Access Key Secret（仅显示一次，务必妥善保存）。

2. 配置OpenClaw对接百炼API

（1）本地部署配置（Windows/MacOS/Linux通用）

1. 打开终端，执行命令进入OpenClaw配置文件编辑页面：

   openclaw config edit
   

2. 在配置文件中找到LLM相关配置项，将默认模型修改为阿里云百炼，替换为自己的API-Key：

   llm:
     type: "aliyun-bailian"
     accessKeyId: "你的Access Key ID"
     accessKeySecret: "你的Access Key Secret"
     endpoint: "https://dashscope.aliyuncs.com"
     model: "qwen-turbo" # 免费模型，也可选择qwen-max
   

3. 保存配置文件，重启OpenClaw使配置生效：

   openclaw restart
   

（2）阿里云部署配置

阿里云部署提供一键配置功能，无需手动编辑配置文件：

1. 进入轻量应用服务器实例「应用详情」页，点击【一键配置百炼API】；
2. 粘贴获取的Access Key ID和Access Key Secret，点击【执行命令】完成写入；
3. 重启OpenClaw服务：systemctl restart openclaw。

3. 验证API对接成功

执行以下命令，若终端返回“LLM connection successful”，即表示百炼大模型对接成功，OpenClaw已具备“思考能力”：

openclaw test llm

四、OpenClaw必装Skills技能包：精选高价值技能，避坑技能过载

OpenClaw的核心竞争力在于Skills技能包生态，但当前生态存在功能冗余、质量参差、权限失控等问题，超1.8万个技能中真正经生产验证的寥寥无几。本文精选12个高价值必装技能，包含新手入门、办公提效、开发必备三类，同时给出安装顺序、配置命令与避坑要点，让你避开技能过载陷阱，快速实现能力落地。

1. 技能安装核心命令

所有技能均通过Clawhub或npx命令安装，核心命令如下（替换“技能名称”即可），npx命令适用于未全局安装Clawhub的场景：

# 基础安装命令
clawhub install 技能名称
# npx备用安装命令（无需全局安装Clawhub）
npx clawhub@latest install 技能名称
# 查看已安装技能
clawhub list
# 卸载无用技能
clawhub uninstall 技能名称

新手推荐安装顺序：skill-vetter（安全扫描）→tavily-search（联网搜索）→self-improving-agent（自我迭代）→weather（天气查询）→summarize（内容总结），先搭建基础能力，再按需安装其他技能。

2. 必装技能清单与详细配置

（1）基础安全与核心能力类（新手必装，4个）

这类技能是OpenClaw的基础，保障使用安全与核心功能，其中skill-vetter为安装所有技能前的前置技能，避免恶意技能与过度权限。

（2）办公提效类（6个）

覆盖文件处理、日历管理、邮件自动化、内容总结等高频办公场景，替代机械重复操作，大幅提升效率。

（3）开发必备类（2个）

针对开发者设计，实现代码管理、网页自动化的全流程自动化，适合程序员、开发团队使用。

3. 技能配置核心避坑要点

1. 环境变量永久生效：如tavily-search、feishu-calendar等需要配置环境变量的技能，需将命令写入shell配置文件，以MacOS的zsh为例：

   # 将环境变量写入~/.zshrc
   echo 'export TAVILY_API_KEY="你的API-Key"' >> ~/.zshrc
   # 使配置生效
   source ~/.zshrc
   

2. CLI工具配套安装：github、gog、summarize、agent-browser四个技能需安装配套CLI工具，否则无法使用，不同系统需对应包管理器（brew/apt/yum）。
3. 权限最小化：安装技能时通过skill-vetter检测权限，拒绝索取“本地文件全读写”“系统命令执行”等过度权限的技能，避免数据泄露。
4. 技能版本兼容：若技能使用异常，执行clawhub update更新技能包，同时检查OpenClaw版本是否为最新：openclaw update。

五、OpenClaw常见问题解答：解决90%的部署与使用难题

在部署和使用OpenClaw的过程中，新手容易遇到环境、安装、API对接、技能配置等问题，以下为2026年最新高频问题及解决方案，覆盖阿里云与本地部署全场景，90%的问题可通过以下方法解决。

1. 部署类问题

（1）安装时提示“权限不足”？

• Windows11：确保以管理员身份运行PowerShell，而非普通终端；
• MacOS/Linux：在安装命令前添加sudo获取管理员权限，或执行以下命令修改npm全局权限：

  sudo chown -R $USER ~/.npm
  

• 阿里云：使用root用户执行命令，避免普通用户权限不足。

（2）执行openclaw start后，终端未显示“Gateway started”？

• 检查端口是否被占用，OpenClaw默认使用18789端口，检测命令：

  # Windows
  netstat -ano | findstr "18789"
  # MacOS/Linux/阿里云
  lsof -i:18789
  

• 杀死占用端口的进程，执行命令：

  # Windows，替换“进程号”为实际数值
  taskkill /F /PID 进程号
  # MacOS/Linux/阿里云，替换“进程号”为实际数值
  kill -9 进程号
  

• 重新启动OpenClaw即可。

（3）阿里云部署后，无法通过网页访问OpenClaw？

• 检查1878和18789端口是否已放行，重新执行端口放行命令并重启防火墙；
• 验证访问Token是否正确，重新生成Token：openclaw token generate；
• 确认服务器实例未停机/欠费，在阿里云控制台查看实例状态。

2. API对接类问题

（1）对接阿里云百炼API后，提示“连接失败”？

• 检查API-Key是否正确，确认Access Key ID和Secret无输入错误、无空格；
• 验证网络是否能访问百炼端点：ping dashscope.aliyuncs.com，阿里云海外地域可直接访问，本地部署需确保网络通畅；
• 确认百炼控制台已完成实名认证，未实名认证将限制API调用；
• 检查配置文件中的endpoint是否为https://dashscope.aliyuncs.com，不可修改为其他地址。

（2）执行openclaw test llm提示“模型调用失败”？

• 检查配置文件中的model字段是否为百炼支持的模型，如qwen-turbo、qwen-max，避免填写不存在的模型；
• 确认百炼API-Key未过期，若过期可在控制台重新创建；
• 重启OpenClaw服务，使配置生效：openclaw restart（本地）/systemctl restart openclaw（阿里云）。

3. 技能配置类问题

（1）安装技能后提示“环境变量未设置”？

• 确认环境变量已正确配置，执行echo 变量名验证，如echo TAVILY_API_KEY，若为空则重新配置；
• 将环境变量永久写入shell配置文件，避免重启终端失效；
• 执行source ~/.zshrc（MacOS/Linux）或重新打开PowerShell（Windows），使环境变量生效。

（2）技能安装成功但无法使用，提示“CLI工具未找到”？

• 确认配套CLI工具已安装，如github技能需安装gh CLI，执行gh --version验证；
• 若CLI工具安装失败，更换包管理器，如MacOS的brew失败可直接从官网下载安装包；
• 安装完成后重启OpenClaw，使技能识别CLI工具。

（3）skill-vetter扫描技能提示“过度权限”？

• 直接放弃安装该技能，选择功能类似但权限合理的替代技能；
• 若为必备技能，可在本地测试环境使用，避免在存放敏感数据的设备上运行。

4. 通用使用类问题

（1）发送指令后，OpenClaw无响应？

• 检查OpenClaw是否处于启动状态，执行openclaw status验证；
• 确认指令为规则明确的可执行任务，避免发送需要复杂主观判断的指令（如“帮我写一篇创意文案”）；
• 检查是否安装了对应技能，如执行邮件操作需先安装email技能：clawhub install email。

（2）本地部署后，找不到记忆文件和技能包？

• Windows11：默认路径C:\Users\用户名\.openclaw\；
• MacOS：默认路径~/.openclaw/，终端输入open ~/.openclaw直接打开；
• Linux/阿里云：默认路径~/.openclaw/或/root/.openclaw/；
• 执行openclaw config path可查看配置文件与数据文件的具体路径。

六、OpenClaw使用核心原则与人群建议

OpenClaw作为能操作电脑、读写文件、访问网络的自动化工具，能力越大风险越大，在使用前需遵守核心安全原则，同时结合自身需求判断是否安装，避免盲目跟风。

1. 核心安全使用原则

• 不使用存放公司机密、个人隐私、重要资料的主力电脑/服务器运行OpenClaw；
• 仅从Clawhub官方仓库安装技能，拒绝安装来路不明的第三方技能；
• 不将敏感信息（如银行卡号、密码、企业核心数据）发送给OpenClaw；
• 定期查看本地记忆文件，及时删除无关信息，避免数据堆积；
• 阿里云部署的服务器，定期修改登录密码与Access Key，降低泄露风险。

2. 分人群使用建议

1. 纯小白，对技术完全不感兴趣：暂时无需安装。先把ChatGPT、豆包、Kimi等聊天AI用熟，它们能解决80%的日常AI需求，等需要AI自动完成重复性工作时再尝试。
2. 小白，但愿意折腾、对新事物好奇：推荐尝试。跟随本文步骤复制粘贴命令即可完成部署，遇到报错可将报错信息发给AI（豆包、ChatGPT），基本能解决所有问题，折腾的过程也是学习AI工具的过程。
3. 职场办公族（电商/自媒体/行政）：优先安装。将文件整理、数据监控、信息采集、日程管理等机械工作交给OpenClaw，节省时间专注核心业务决策。
4. 开发者/技术人员：强烈推荐。OpenClaw的架构设计能帮你理解AI Agent的运作方式，同时可自定义技能、对接私有大模型，玩出更多个性化玩法，提升开发效率。
5. 企业用户：建议在测试环境部署后再落地生产。通过权限管控、环境隔离，避免OpenClaw接触企业核心数据，同时可基于OpenClaw二次开发，适配企业专属业务场景。

七、比安装更重要的：AI时代的工具使用思维

OpenClaw之所以能在2026年快速走红，并非因为它的技术有多超前，而是它把“调用大模型、操作电脑、管理技能、记忆信息”这些分散的能力，打包成了一套普通人也能上手的自动化体系。它让更多人第一次感受到：AI不再只是一个冰冷的聊天窗口，而是能真正落地、帮你解决实际问题的“数字员工”。

其实“要不要装OpenClaw”这个问题的背后，是AI时代每个人都需要思考的核心问题：我们该以什么姿势拥抱新工具？答案很简单：不要怕折腾，但也不要盲目跟风。工具永远是为人服务的，OpenClaw也好，其他AI工具也罢，最终的核心价值都是提升效率、解放生产力。哪怕你暂时不装OpenClaw，学会“遇到问题问AI”“借助工具解决重复工作”的思维，比掌握某一个具体工具更重要。

2026年的AI生态，早已不是“会不会用AI”的问题，而是“能不能让AI帮你干活”的问题。OpenClaw作为“AI自动化代理”的代表，只是一个开始，未来会有更多能落地、可操作的AI工具出现，而提前掌握这类工具的使用方法，就是抓住了AI时代的效率红利。与其纠结“要不要装”，不如从“敢不敢试”开始，在折腾中学会驾驭AI，让工具成为自己的核心竞争力。