OpenClaw(Clawdbot)的核心价值在于通过Skills(技能)扩展实现功能定制,结合阿里云轻量服务器的稳定运行与本地环境的灵活开发,可快速搭建适配业务场景的AI智能体。本文基于2026年最新稳定版,从阿里云轻量服务器与本地(MacOS/Linux/Windows11)部署OpenClaw,到Skills集成、自定义开发及避坑指南,全程提供可直接复制的代码命令,助力零基础用户快速完成技能扩展,打造高效智能助手。
一、核心原理与准备工作
1.1 核心原理
OpenClaw集成Skills的核心是通过技能目录加载机制实现功能扩展,流程如下:
- Skills以目录形式存在,包含SKILL.md(YAML元数据+Markdown说明)与工具脚本;
- OpenClaw从内置目录、用户目录、工作区目录加载技能,工作区目录优先级最高;
- 用户触发指令→OpenClaw匹配对应技能→调用工具执行→返回结果,支持文本、文件、网络等多类型操作。
- 阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。

1.2 准备清单
| 资源类型 | 具体要求 | 获取渠道 |
|---|---|---|
| 阿里云轻量服务器 | 2vCPU+2GiB内存+40GiB ESSD(最低),推荐2核4GiB | 阿里云官网轻量应用服务器专区 |
| 本地环境 | MacOS 12+/Linux(Ubuntu 22.04)/Windows 11,2核4GiB内存 | 本地PC/笔记本 |
| 基础工具 | SSH客户端、Git、Docker(本地部署用) | Windows用PowerShell,Mac/Linux用终端 |
| OpenClaw镜像 | OpenClaw(Clawdbot)官方镜像 | 阿里云轻量应用服务器镜像市场 |
| ClawHub账号 | 用于安装公共技能 | ClawHub官网(https://clawhub.com) |
1.3 风险提示
- Skills可能包含系统命令执行权限,安装第三方技能前需通过skill-vetter审查,防止恶意代码;
- 阿里云服务器需放通18789端口,避免开放过多端口导致安全风险;
- 本地部署需关闭不必要的防火墙规则,确保OpenClaw正常访问网络。
二、新手零基础阿里云上部署OpenClaw简单步骤及避坑指南
零基础部署 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 获取、配置保姆级教程:
创建API-Key,推荐访问订阅阿里云百炼Coding Plan,阿里云百炼Coding Plan每天两场抢购活动,从按tokens计费升级为按次收费,可以进一步节省费用!
- 购买后,在控制台生成API Key。注:这里复制并保存好你的API Key,后面要用。

- 回到轻量应用服务器-控制台,单击服务器卡片中的实例 ID,进入服务器概览页。

- 在服务器概览页面单击应用详情页签,进入服务器详情页面。

- 端口放通在OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw 服务运行端口的防火墙。

- 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key,直接选择就可以。

- 获取访问地址单击访问 Web UI 面板下的执行命令,获取 OpenClaw WebUI 的地址。


2.1 阿里云服务器创建(5分钟完成)
- 登录阿里云官网,访问阿里云OpenClaw一键部署专题页面;
- 选择“OpenClaw(Clawdbot)官方镜像”,点击“立即购买”;
- 配置选择(新手推荐):
- 地域:国内用户选华东1(杭州)/华北2(北京),海外用户选中国香港/新加坡(免备案);
- 实例规格:2vCPU+2GiB内存+40GiB ESSD(最低),推荐2核4GiB;
- 系统镜像:Ubuntu 22.04 LTS(OpenClaw官方推荐);
- 点击“立即购买”,完成支付后等待实例创建(约3分钟),记录公网IP;
- 避坑点1:地域选择错误导致网络延迟高,国内用户优先选国内地域,海外用户选免备案地域。
2.2 实例初始化与端口放行(关键步骤)
- 访问阿里云轻量应用服务器控制台,找到创建的实例,点击“远程连接”→“Workbench远程连接”,输入密码登录;
- 放行核心端口(必须操作,否则无法访问控制台与技能调用):
# 放行OpenClaw管理端口(18789)和HTTPS端口(443) sudo iptables -A INPUT -p tcp --dport 18789 -j ACCEPT sudo iptables -A INPUT -p tcp --dport 443 -j ACCEPT sudo iptables-save - 安全组配置(阿里云控制台操作):
- 进入实例→“安全组”→“添加规则”;
- 端口范围:18789、443;
- 授权对象:0.0.0.0/0(允许所有IP访问,也可限制特定IP);
- 避坑点2:端口放行不完整导致无法访问控制台,必须同时配置系统防火墙和阿里云安全组,两者缺一不可。
2.3 安装与初始化OpenClaw(一键部署)
- 连接服务器后,执行一键部署脚本(镜像已预装,仅需初始化):
# 一键初始化OpenClaw
openclaw init --mode cloud --port 18789 --sandbox enable
# 启动网关服务
openclaw gateway start
# 设置开机自启
openclaw config set gateway.autoStart true
- 初始化完成后,访问Web控制台:http://公网IP:18789(首次访问需设置管理员密码);
- 避坑点3:忘记设置开机自启,实例重启后服务停止,需重新启动,执行
openclaw config set gateway.autoStart true即可解决。
2.4 基础技能安装(ClawHub市场)
- 安装ClawHub CLI工具:
npm install -g clawhub
- 安装核心技能(新手推荐):
# 安装文件处理技能
clawhub install file-operations
# 安装网页搜索技能
clawhub install web-search
# 安装代码生成技能
clawhub install code-interpreter
# 安装文档摘要技能
clawhub install summarize
# 安装安全审查技能
clawhub install skill-vetter
- 验证安装:
clawhub list
显示已安装技能列表表示成功;
- 避坑点4:ClawHub安装失败,检查网络连通性,执行
npm config set registry https://registry.npm.taobao.org切换镜像源。
三、本地部署OpenClaw(MacOS/Linux/Windows11)
3.1 MacOS部署步骤
- 安装Homebrew(已安装跳过):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装Docker:
brew install --cask docker - 启动Docker后,拉取OpenClaw镜像并运行:
docker pull openclaw/clawdbot:latest docker run -d -p 18789:18789 --name openclaw openclaw/clawdbot:latest - 初始化OpenClaw:
docker exec -it openclaw openclaw init --mode local --port 18789 - 访问本地控制台:http://localhost:18789。
3.2 Linux(Ubuntu 22.04)部署步骤
- 安装Docker:
sudo apt update sudo apt install -y docker.io sudo systemctl start docker sudo systemctl enable docker - 拉取镜像并运行:
sudo docker pull openclaw/clawdbot:latest sudo docker run -d -p 18789:18789 --name openclaw openclaw/clawdbot:latest - 初始化:
sudo docker exec -it openclaw openclaw init --mode local --port 18789 - 访问控制台:http://localhost:18789。
3.3 Windows11部署步骤
- 安装WSL2与Ubuntu 22.04:
- 以管理员身份运行PowerShell:
wsl --install -d Ubuntu-22.04
- 以管理员身份运行PowerShell:
- 安装Docker Desktop并启用WSL2集成;
- 在Ubuntu终端中执行:
docker pull openclaw/clawdbot:latest docker run -d -p 18789:18789 --name openclaw openclaw/clawdbot:latest docker exec -it openclaw openclaw init --mode local --port 18789 - 访问控制台:http://localhost:18789。
3.4 本地部署避坑点
- 避坑点5:Docker未启动导致容器运行失败,启动Docker后重新运行容器;
- 避坑点6:端口占用,使用
lsof -i :18789查看占用进程,关闭后重新映射端口; - 避坑点7:Windows防火墙阻止访问,放行18789端口或关闭防火墙测试。
四、Skills集成全流程(安装、配置、使用)
4.1 公共技能安装(三种方式)
方式一:ClawHub CLI安装(推荐)
# 搜索技能
clawhub search "email"
# 安装邮件技能
clawhub install email
# 升级所有技能
clawhub update --all
# 卸载技能
clawhub uninstall email
方式二:Web控制台安装(可视化操作)
- 访问OpenClaw Web控制台,进入“Skills”页面;
- 在搜索框输入技能名称(如“web-search”),点击“安装”;
- 安装完成后,点击“启用”即可使用。
方式三:对话指令安装(AI辅助)
- 在对话窗口输入:“帮我安装文件处理技能”;
- OpenClaw自动搜索并安装file-operations技能;
- 安装完成后,输入“更新技能列表”激活。
4.2 核心技能配置与使用示例
示例1:文件处理技能(file-operations)
- 安装后,配置权限:
openclaw config set skills.file-operations.enabled true openclaw config set skills.file-operations.permissions --json '["read", "write", "delete"]' - 使用示例:
# 让OpenClaw创建文件 openclaw chat --prompt "创建一个名为test.txt的文件,内容为'Hello OpenClaw'" - 验证:
返回“Hello OpenClaw”表示成功。docker exec -it openclaw cat /root/.openclaw/workspace/test.txt
示例2:网页搜索技能(web-search)
- 安装并启用:
clawhub install web-search openclaw config set skills.web-search.enabled true - 使用示例:
OpenClaw返回搜索结果并总结关键信息。openclaw chat --prompt "搜索2026年AI领域最新突破"
示例3:代码生成技能(code-interpreter)
- 安装:
clawhub install code-interpreter - 使用示例:
OpenClaw生成代码并执行,返回结果。openclaw chat --prompt "写一个Python脚本,实现计算斐波那契数列前10项"
4.3 自定义技能开发(从零开始)
- 创建技能目录:
mkdir -p ~/.openclaw/workspace/skills/hello-world
- 编写SKILL.md文件:
cat > ~/.openclaw/workspace/skills/hello-world/SKILL.md << 'EOF'
---
name: hello_world
description: 简单的问候技能
author: 你的名字
version: 1.0.0
tools:
- echo
---
# 问候技能
当用户输入“你好”“问候”等指令时,使用echo工具返回“Hello from OpenClaw Skills!”。
EOF
- 刷新技能列表:
openclaw skills refresh
- 测试:
返回“Hello from OpenClaw Skills!”表示成功。openclaw chat --prompt "你好"
4.4 技能优先级与冲突解决
- 技能加载优先级:工作区目录>用户目录>内置目录;
- 解决冲突:
# 查看技能优先级
openclaw skills list --verbose
# 禁用内置技能
openclaw config set skills.builtin.file-operations.enabled false
- 避坑点8:技能名称冲突导致无法正常调用,修改自定义技能名称或禁用冲突的内置技能。
五、Skills安全与性能优化
5.1 安全审计(skill-vetter)
- 安装安全审查技能:
clawhub install skill-vetter - 审查第三方技能:
openclaw chat --prompt "审查web-search技能的安全性" - 输出结果包含权限、风险等级等信息,高风险技能建议禁用。
5.2 性能优化
- 启用技能缓存:
openclaw config set skills.cache.enabled true openclaw config set skills.cache.ttl 3600 - 限制并发执行:
openclaw config set skills.maxConcurrency 3 - 定期清理无用技能:
clawhub list --unused | xargs clawhub uninstall - 避坑点9:并发数过高导致服务器资源耗尽,根据硬件配置调整,推荐2-3个并发。
六、常见问题解答(新手必看)
6.1 部署问题
- 阿里云服务器无法访问控制台
- 排查:检查安全组18789端口放行;执行
openclaw gateway status查看服务状态;重启网关openclaw gateway restart;
- 排查:检查安全组18789端口放行;执行
- 本地部署端口占用
- 解决方案:Windows用
netstat -ano | findstr :18789查找进程并结束;Linux/Mac用lsof -i :18789 | awk '{print $2}' | xargs kill。
- 解决方案:Windows用
6.2 Skills安装问题
- ClawHub安装失败
- 原因:网络问题,切换npm镜像:
npm config set registry https://registry.npm.taobao.org
- 原因:网络问题,切换npm镜像:
- 技能安装后无法启用
- 排查:检查配置文件中技能enabled为true;执行
openclaw skills refresh刷新。
- 排查:检查配置文件中技能enabled为true;执行
6.3 技能使用问题
- 技能调用无响应
- 排查:检查技能权限配置;查看日志
openclaw logs --skills找错误信息;
- 排查:检查技能权限配置;查看日志
- 自定义技能不生效
- 解决方案:确认SKILL.md格式正确;工作区目录路径正确;执行
openclaw skills refresh。
- 解决方案:确认SKILL.md格式正确;工作区目录路径正确;执行
七、优化建议与最佳实践
7.1 技能管理
- 分类安装技能:基础技能(file-operations、web-search)、业务技能(email、data-analysis)、安全技能(skill-vetter);
- 定期备份技能配置:
cp ~/.openclaw/skills ~/.openclaw/skills_backup -r
7.2 多环境同步
- 阿里云与本地技能同步:
# 阿里云服务器导出技能列表
clawhub list > skills.txt
# 本地导入
cat skills.txt | xargs clawhub install
- 避坑点10:同步时版本不一致,使用
clawhub update --all统一版本。
7.3 进阶开发
- 编写Python工具扩展技能:
# 自定义工具脚本(tool.py)
def custom_tool(input):
return f"Processed: {input}"
# 在SKILL.md中引用
tools:
- name: custom_tool
path: /root/.openclaw/workspace/tools/tool.py
- 重启OpenClaw后即可调用该工具。
八、总结
通过阿里云轻量服务器与本地环境部署OpenClaw并集成Skills,可快速扩展AI助手功能,实现文件处理、网页搜索、代码生成等自动化操作。本文从零基础部署到技能开发,覆盖全流程,所有代码可直接复制执行,新手也能轻松上手。需注意技能安全审查,避免恶意代码执行,同时合理配置资源,提升系统稳定性。结合ClawHub市场丰富的公共技能与自定义开发,打造专属智能助手,提升工作效率。