OpenClaw小龙虾进阶教程：部署与Skills及大模型API配置

2026-06-14阅读 0热度 0

OpenClaw

OpenClaw——把AI管家变成现实

OpenClaw（这里不妨叫它“小龙虾”，毕竟这昵称足够亲切）是2026年开源AI智能体圈子里的明星。它的核心价值一句话就能说清：通过Skills（技能插件）把AI的“嘴炮”变成实打实的动手能力。默认状态下它只能陪你聊天解闷，但一旦配上合适的部署环境、装好适配的Skills、再对接上AI模型API，它就能摇身一变，成为能自动化办公、全网检索、帮你管理代码的“全能管家”。

OpenClawo.png

新手用起来最头疼什么？无非两点：一是部署流程看着就头大，不知道哪个方案适合自己；二是安全意识不够，盲目装了一堆Skills，结果不是信息泄露就是系统崩溃。这篇文章基于2026年OpenClaw最新稳定版（v1.9.2），结合官方文档和自己动手实测的经验，把阿里云云端部署、本地多系统（MacOS/Linux/Windows11）的流程掰开揉碎了讲明白，附上阿里云百炼和免费大模型Coding Plan API的配置方法，还有Skills安装的正确顺序和高频实用清单。另外，90%的用户会遇到的问题排查方案也一并奉上。所有代码命令只管复制执行，目标是让新手能安全又高效地把OpenClaw的完整能力用起来。

OpenClaw1.png

OpenClaw2.png

一、部署前的基础准备

硬件与软件要求

要确保顺利跑起来，硬件方面得跟上：云端部署推荐2核2G及以上的服务器，4核4G体验会更好；本地部署至少需要4核CPU、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）。

核心服务与资源准备

阿里云服务开通（主要面向云端部署）：先去注册阿里云账号，完成实名认证，然后开通“轻量应用服务器”和“阿里云百炼”这两个服务。注意，开通都是免费的，但服务器租赁要花钱，百炼平台的话新用户可以领取90天的免费调用额度。

免费大模型资源整理：把支持Coding Plan API的免费模型平台收集一下，比如通义千问开放平台、GLM开源社区等。提前注册好账号，摸清API调用规则和免费额度有多少。

安全这根弦不能松：Skills安装的优先级要明确，安全类的必须排在前面。不要碰那些来路不明的第三方技能，API密钥、Cookie这些敏感信息一旦泄露，后果很麻烦。

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

阿里云云端部署（推荐，7×24小时在线）

阿里云给OpenClaw准备了专属镜像，部署流程简化了不少，不用手动去配置各种依赖，特别适合需要长期稳定运行的用户。

新手零基础阿里云部署OpenClaw的步骤（喂饭级）

第一步：在阿里云OpenClaw一键部署专题页面找到【一键购买并部署】按钮，点它。

OpenClaw1.png

OpenClaw2.png

OpenClaw02.png

OpenClaw03.png

OpenClaw04.png

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

镜像选OpenClaw(Moltbot)镜像（如果已经买过服务器，可以重置系统重新选镜像）。实例方面，内存必须是2GiB或以上。地域默认是美国（弗吉尼亚），需要注意，中国大陆地域（除了香港）的轻量应用服务器，联网搜索功能是受限的。时长就根据自己的需求和预算来决定。

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

bailian1.png

bailian2.png

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

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

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

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

端口放通：找到防火墙设置，单击一键放通就可以。配置百炼API-Key：同样单击一键配置，输入百炼的API-Key，单击执行命令。配置OpenClaw：执行命令，生成访问用的Token。最后访问控制页面，单击打开网站页面就能进入OpenClaw的对话页面了。

服务器购买与配置：在专题页面点击【一键购买并部署】，镜像勾选“OpenClaw 2026.3.3（Moltbot）”，实例选2核2G或以上（注意，内存如果小于等于2GiB，跑Skills会卡顿），系统盘40GiB ESSD，地域推荐美国（弗吉尼亚）或中国香港（国内地域除香港外联网搜索受限），购买时长按需选择，测试的话一个月就够。支付完成后，在控制台获取服务器的公网IP、默认用户名（root）和密码。

服务器连接与端口配置：打开FinalShell，新建连接，填好公网IP、用户名和密码。然后开放默认端口18789，执行下面的命令：

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

# Ubuntu系统
ufw allow 18789
ufw reload

初始化OpenClaw配置：在服务器控制台点击实例ID进入概览页，切换到“应用详情”标签页。执行基础配置命令，依次点“初始化OpenClaw配置”“查看Token”“开启公网访问”对应的执行按钮，系统会自动完成环境初始化。

验证部署：获取Web UI面板地址（在应用详情页执行“获取Web UI面板地址”命令），然后在本地浏览器访问这个地址，能看到交互界面就说明部署成功了。

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

MacOS系统部署

依赖环境安装：打开终端，执行以下命令来安装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

源码下载与初始化：

# 创建工作目录
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

启动与验证：

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

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

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

系统更新与依赖安装：

# 更新系统包
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

源码部署与配置：

# 创建工作目录并授权
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

设置开机自启（可选）：创建系统服务文件：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

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

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

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

依赖安装与源码部署：在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

本地直接部署（无WSL2）：下载并安装Git与Node.js（记得勾选“Add to PATH”），打开PowerShell执行：

# 创建工作目录
mkdir -Force C:openclaworkspace
cd C:openclaworkspace
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部署方案（跨平台通用，推荐服务器/自托管）

这个方案适合那些希望隔离运行环境、避免依赖冲突的用户。先安装Docker（根据操作系统选择Docker Desktop或Docker Engine），确保服务正常运行。然后拉取镜像并启动：

# 拉取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

浏览器打开http://localhost:18789，按提示完成初始设置即可。

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

阿里云百炼API配置

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

接下来配置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配置（以通义千问开放平台为例）

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

然后配置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 ta vily-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，并启用它”或者“安装ta vily-search技能，完成后帮我配置API密钥”。

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

OpenClaw的架构是模块化依赖型的，技能安装顺序搞错了很容易引发冲突、资源抢占甚至崩溃。正确的优先级应该这样排：

第一梯队：环境校验与核心依赖。先执行openclaw check env校验环境，然后安装memory-manager（内存管理）、dependency-checker（依赖检查）、process-guard（进程守护）这三个核心依赖技能。

第二梯队：安全与权限组件。安全类技能必须优先安装，先把防护屏障建起来：

# 安装技能安全扫描工具
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

第三梯队：通用基础技能。安装文件读写（file-master）、文本处理（text-pro）、数据解析（data-parser）、网络请求（web-fetch）这些通用技能，为后面的专项技能打好基础。

第四梯队：场景专项技能。根据自己的需求来，是办公还是开发还是自动化，按需安装，别一股脑全装上。

第五梯队：调度与优化技能。最后安装task-scheduler（任务调度）、cache-opt（缓存优化）、auto-updater（自动更新），提升整体运行效率。

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

1. 检索类技能

Ta vily Search：AI优化的搜索引擎，输出结果结构清晰，支持实时资讯获取：

clawhub install ta vily-search
# 使用示例
openclaw run --command "用Ta vily 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%的使用问题）

部署相关问题

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

# Linux/MacOS查看占用18789端口的进程
lsof -i :18789
# 终止进程（替换PID为实际进程ID）
kill -9 PID

# Windows系统
netstat -ano | findstr :18789
taskkill /F /PID PID
# 或修改配置文件更换端口（编辑config.json的port字段）

依赖安装慢或失败：先切换国内镜像源：npm config set registry https://registry.npmmirror.com。然后清除npm缓存：npm cache clean --force。如果还是不行，根据错误提示手动安装缺失依赖，比如pip3 install 依赖库名称。

阿里云服务器部署后无法访问：先检查服务器状态，确认实例处于“运行中”。然后验证端口是否开放，执行firewall-cmd --list-ports（CentOS）或ufw status（Ubuntu），确认18789端口已开放。最后检查服务状态：docker exec -it openclaw openclaw status（Docker部署），确保服务正常运行。

API配置相关问题

调用提示“权限不足”或“密钥无效”：先检查密钥的正确性，确认AccessKey ID/Secret没有拼写错误，注意区分大小写。然后确认额度和有效期，去阿里云百炼控制台看看免费额度是不是用完了，Coding Plan有没有过期。最后检查网络连通性，云端服务器最好选择香港或海外地域，避免国内网络限制。

模型调用提示“模型不存在”：确认模型名称是否正确，参考官方文档填写完整的模型标识（比如“Qwen3.5-Plus”，而不是“qwen3.5-plus”）。另外，检查模型订阅状态，确保已经在API平台订阅了该模型，没订阅的模型是调不动的。

Skills相关问题

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

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

技能安装后无法启用：先检查依赖，执行openclaw skills check <技能名称>查看缺失的依赖，按提示安装。然后验证版本兼容性，看看技能文档，确认它支持当前OpenClaw版本（v1.9.2）。最后可以尝试重新安装：clawhub install <技能名称> --force。

安全类技能拦截正常安装：先查看扫描报告，确认技能是否有过度索取权限的行为（比如无理由访问本地文件）。如果确认安全，可以临时关闭强制检查：openclaw config set security.clawsec.autoCheck false。安装完后记得马上开启：openclaw config set security.clawsec.autoCheck true。

系统稳定性问题

运行中崩溃或卡顿：先关闭冗余技能，只启用当前需要的，执行openclaw skills disable <技能名称>。然后检查内存占用，用top（Linux/MacOS）或任务管理器（Windows）查看，关掉那些占用过高的其他程序。如果还是不行，就按正确顺序重新安装技能：重置Skills目录，按“环境校验→安全组件→基础技能→专项技能→调度优化”的顺序重装。

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

六、核心要点总结

部署方案选择：需要长期运行的话，阿里云云端部署是首选，有专属镜像省心省力；本地测试或者个性化配置就选本地部署，Docker方案能有效避免依赖冲突。

安全优先原则：安装任何技能之前，先启用skill-vetter扫一扫。涉及敏感操作的话，ClawSec和x402janus是必装的，find-skills这种高危技能直接禁用。

API配置技巧：新手可以先拿免费大模型API练手，熟悉流程之后，复杂场景再切换到阿里云百炼Coding Plan，稳定性和精度都会好很多。

Skills安装原则：严格按照“环境→安全→基础→专项→调度”的顺序来装，遵循“少而精”的原则，不要贪多，冗余技能最容易引发冲突。

问题排查逻辑：遇到问题别慌，按“网络连通性→依赖完整性→配置正确性→权限充足性”这个顺序来排查，绝大多数问题都能快速定位解决。

通过这篇文章的流程和技巧，新手应该能在1-2小时内完成OpenClaw的全流程部署和核心配置，让AI智能体真正具备实际任务执行能力，从重复劳动中解放出来，把精力集中在核心工作上。如果想进一步拓展，还可以探索自定义Skills开发、多角色团队搭建等进阶内容，继续挖掘OpenClaw的自动化潜力。