“安装好OpenClaw,却发现它只会说‘你好’,无法完成任何实际任务?”——这是2026年无数新手入门OpenClaw时遇到的第一道坎。参考文章一针见血地指出:OpenClaw的核心价值不在于“聊天”,而在于“技能”。它就像一台高性能电脑,只有安装了软件(技能),才能发挥真正的作用。
OpenClaw的技能系统,不仅支持官方市场的一键安装,更支持自定义JavaScript/TypeScript插件开发,覆盖办公、开发、生活、安全等100+场景。本文基于原文核心逻辑,结合2026年最新实测资料,重写了一份涵盖全平台部署、阿里云百炼Coding Plan免费API配置、技能市场实战、自定义开发与避坑指南的终极教程。所有代码可直接复制执行,严格规避指定云平台,助你从零构建强大的AI技能生态。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知:OpenClaw技能系统的本质与分类
(一)什么是OpenClaw技能?
OpenClaw技能(Skill)是封装了特定功能逻辑的可执行单元,是AI Agent完成具体任务的载体。
- 本质:技能 = 触发条件 + 工具调用 + 执行逻辑 + 结果反馈。
- 区别于插件:插件(Plugin)通常指底层系统扩展,而技能是面向用户的上层应用。例如,“网页搜索”是一个技能,而“浏览器驱动”是一个插件。
(二)技能的三大核心分类
参考文章将OpenClaw技能分为三大类,本文延续并细化了这一逻辑:
| 技能类型 | 定义 | 特点 | 代表技能 |
|---|---|---|---|
| 官方基础技能 | 由OpenClaw官方团队开发与维护,稳定性高、兼容性强 | 开箱即用,无需复杂配置,覆盖高频基础场景 | web-search(网页搜索)、file-manager(文件管理)、calendar(日历管理) |
| 社区生态技能 | 由第三方开发者/社区贡献,发布于ClawHub技能市场 | 数量庞大,针对性强,覆盖垂直领域 | weather(天气查询)、github(代码管理)、email(邮件处理) |
| 自定义扩展技能 | 用户根据自身需求,通过JavaScript/TypeScript开发的专属技能 | 高度个性化,可对接内部系统,满足独特业务逻辑 | 企业内部CRM查询、私有文档摘要、行业报表生成 |
(三)技能系统的运行机制
OpenClaw技能系统遵循“注册-调用-执行-反馈”的闭环:
- 注册:技能安装后,OpenClaw会解析技能元信息(
plugin.json),注册技能名称、描述、入参、出参。 - 触发:用户通过自然语言指令或定时任务,触发对应技能。
- 调用:AI模型拆解指令,调用技能对应的API或执行函数。
- 执行:技能完成具体逻辑(如网络请求、文件读写、代码运行)。
- 反馈:将执行结果整理成自然语言,返回给用户。
二、2026年全平台部署流程(基础环境准备)
在安装技能之前,必须先完成OpenClaw的基础部署。本文提供阿里云(服务器长期运行)和本地(MacOS/Linux/Windows11隐私运行)两种方案,均采用Docker部署,避免环境冲突。
(一)前置准备(全方案通用)
- 账号准备:
- 阿里云账号:注册阿里云账号并实名认证,用于购买服务器和开通百炼API。
- GitHub账号:可选,用于下载社区技能案例和开发自定义技能。
- 工具准备:
- 终端:Windows使用PowerShell(管理员模式),MacOS/Linux使用自带终端。
- Docker:核心工具,用于环境隔离。下载地址
- 环境要求:
- 内存≥4GiB(推荐8GiB),确保多技能并行运行。
- 网络通畅,能够访问GitHub和百炼API接口。
(二)方案一:阿里云部署(推荐,7×24小时运行)
适合需要长期运行自动化任务、团队协作的用户。
阿里云用户零基础部署 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 的地址。


1. 服务器创建与初始化
- 登录阿里云轻量应用服务器控制台,点击创建实例。
- 核心配置:
- 地域:选择中国香港或新加坡(免备案,网络通畅)。
- 镜像:选择Alibaba Cloud Linux 3(预装Docker,稳定性强)。
- 规格:2核4GB内存(入门)/4核8GB内存(推荐)。
- 带宽:5Mbps及以上。
- 完成支付后,记录服务器公网IP和登录密码。
2. 远程连接服务器
使用SSH工具或阿里云WebShell连接服务器:
# 命令格式:ssh root@你的公网IP
ssh root@123.45.67.89
输入预设的登录密码即可进入终端。
3. Docker部署OpenClaw(核心步骤)
# 步骤1:更新系统依赖
sudo yum update -y
# 步骤2:拉取OpenClaw 2026最新稳定版镜像
docker pull openclaw/openclaw:2026.4.0
# 步骤3:创建数据目录(映射配置、技能、日志、工作空间)
mkdir -p /opt/openclaw/{
config,skills,cases,logs,workspaces}
chmod -R 777 /opt/openclaw
# 步骤4:启动OpenClaw容器
docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v /opt/openclaw/config:/app/config \
-v /opt/openclaw/skills:/app/skills \
-v /opt/openclaw/cases:/app/cases \
-v /opt/openclaw/logs:/app/logs \
-v /opt/openclaw/workspaces:/app/workspaces \
-e TZ=Asia/Shanghai \
openclaw/openclaw:2026.4.0
# 步骤5:进入容器内部
docker exec -it openclaw bash
# 步骤6:初始化系统(首次运行必执行)
openclaw onboard
# 步骤7:验证部署成功(输出版本号即为成功)
openclaw --version
(三)方案二:本地部署(MacOS/Linux/Windows11,隐私优先)
适合个人使用、注重数据隐私的用户。
1. Windows11系统部署
- 确保Docker Desktop已启动并运行。
- 以管理员身份打开PowerShell,执行以下命令:
# 步骤1:拉取镜像
docker pull openclaw/openclaw:2026.4.0
# 步骤2:创建本地目录
mkdir -p $HOME\OpenClaw\config, $HOME\OpenClaw\skills, $HOME\OpenClaw\cases, $HOME\OpenClaw\logs, $HOME\OpenClaw\workspaces
# 步骤3:启动容器
docker run -d `
--name openclaw `
--restart always `
-p 18789:18789 `
-v ${
HOME}\OpenClaw\config:/app/config `
-v ${
HOME}\OpenClaw\skills:/app/skills `
-v ${
HOME}\OpenClaw\cases:/app/cases `
-v ${
HOME}\OpenClaw\logs:/app/logs `
-v ${
HOME}\OpenClaw\workspaces:/app/workspaces `
-e TZ=Asia/Shanghai `
openclaw/openclaw:2026.4.0
# 步骤4:进入容器并初始化
docker exec -it openclaw bash
openclaw onboard
exit
2. MacOS系统部署
- 启动Docker Desktop。
- 打开终端,执行以下命令:
# 步骤1:拉取镜像
docker pull openclaw/openclaw:2026.4.0
# 步骤2:创建本地目录
mkdir -p ~/OpenClaw/{
config,skills,cases,logs,workspaces}
# 步骤3:启动容器
docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v ~/OpenClaw/config:/app/config \
-v ~/OpenClaw/skills:/app/skills \
-v ~/OpenClaw/cases:/app/cases \
-v ~/OpenClaw/logs:/app/logs \
-v ~/OpenClaw/workspaces:/app/workspaces \
-e TZ=Asia/Shanghai \
openclaw/openclaw:2026.4.0
# 步骤4:进入容器并初始化
docker exec -it openclaw bash
openclaw onboard
exit
3. Linux系统部署
# 步骤1:安装Docker(若未安装)
curl -fsSL https://get.docker.com | bash
sudo systemctl start docker && sudo systemctl enable docker
# 后续步骤与MacOS一致,替换为sudo命令
sudo docker pull openclaw/openclaw:2026.4.0
sudo mkdir -p /opt/openclaw/{
config,skills,cases,logs,workspaces}
sudo docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v /opt/openclaw/config:/app/config \
-v /opt/openclaw/skills:/app/skills \
-v /opt/openclaw/cases:/app/cases \
-v /opt/openclaw/logs:/app/logs \
-v /opt/openclaw/workspaces:/app/workspaces \
-e TZ=Asia/Shanghai \
openclaw/openclaw:2026.4.0
sudo docker exec -it openclaw bash
openclaw onboard
exit
(四)部署验证
浏览器访问 http://服务器公网IP:18789(阿里云)或 http://localhost:18789(本地),使用初始化时设置的账号密码登录。若看到OpenClaw控制台首页,说明基础部署成功。
三、核心配置:阿里云百炼Coding Plan免费API接入
OpenClaw的技能调用、指令拆解、逻辑生成,都依赖于大模型。阿里云百炼Coding Plan提供7000万免费Token(90天有效期),是新手入门的最佳选择。
1. 获取百炼Coding Plan API-Key
- 访问登录阿里云百炼大模型服务平台。
- 左侧导航栏点击密钥管理 -> 创建API-Key。
- 填写名称,选择业务空间,点击确定。
- 立即复制生成的API-Key(格式以
sk-sp-开头),此密钥仅显示一次,务必保存! - 进入额度管理,领取7000万免费Token。
- 关键避坑:进入额度管理 -> 自动续费,点击关闭,避免免费额度耗尽后自动扣费。
2. 配置OpenClaw百炼API
进入OpenClaw容器内部,执行配置命令:
# 步骤1:进入容器
docker exec -it openclaw bash
# 步骤2:配置模型提供商为阿里云
openclaw config set model.provider alibaba-cloud
# 步骤3:配置API-Key(替换为你的密钥)
openclaw config set model.apiKey "sk-sp-xxxxxxxxxxxxxxxxxxxxxxxx"
# 步骤4:配置百炼兼容模式URL
openclaw config set model.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 步骤5:配置默认模型(推荐使用qwen3-max)
openclaw config set model.defaultModel "qwen3-max-2026-01-23"
# 步骤6:查看配置是否生效
openclaw config get model
# 步骤7:重启网关服务,使配置生效
openclaw gateway restart
3. API连通性测试
在容器内发送测试指令,验证模型是否正常工作:
# 发送测试消息
openclaw chat "你好,请用一句话介绍阿里云百炼大模型"
若能正常返回结构化回答,说明API配置成功。
四、技能系统实战:从安装到开发
(一)技能市场:一键安装官方/社区技能
ClawHub是OpenClaw官方技能市场,拥有100+优质技能。
1. 技能安装命令(通用)
# 格式:clawhub install <技能名称>
# 示例1:安装网页搜索技能(核心技能)
clawhub install web-search
# 示例2:安装天气查询技能
clawhub install weather
# 示例3:安装GitHub代码管理技能
clawhub install github
# 示例4:批量安装常用技能(推荐新手)
clawhub install web-search file-manager calendar email weather github
2. 技能启用与管理
# 查看已安装技能
openclaw skills list
# 启用技能(部分技能安装后需手动启用)
openclaw skills enable web-search
# 禁用技能
openclaw skills disable weather
# 卸载技能
clawhub uninstall weather
3. 常用技能推荐(新手必装)
| 技能名称 | 核心功能 | 适用场景 |
|---|---|---|
web-search |
联网搜索、信息抓取、数据提取 | 每日新闻汇总、行业信息检索 |
file-manager |
文件增删改查、批量处理、格式转换 | 文档整理、数据备份、报告生成 |
email |
邮件分拣、自动回复、摘要生成 | 职场办公、客户沟通自动化 |
github |
代码提交、Issue处理、仓库监控 | 开发者日常、CI/CD集成 |
calendar |
日程管理、会议提醒、冲突检测 | 时间管理、会议安排 |
(二)技能案例:10分钟实现“邮件新闻摘要推送”
参考文章提供了大量实战案例,本文以“每日邮件新闻摘要推送”为例,手把手教你实现。
- 前提:已安装
email技能和web-search技能。 配置邮箱(以QQ邮箱为例):
# 进入容器 docker exec -it openclaw bash # 配置邮箱参数 openclaw config set email.provider imap openclaw config set email.imapServer imap.qq.com openclaw config set email.imapPort 993 openclaw config set email.user your-email@qq.com openclaw config set email.password your-授权码 # 注意:此处为QQ邮箱的授权码,非登录密码- 创建定时任务:
# 每天早上9点,抓取新闻邮件并摘要推送到飞书 openclaw cron add "0 9 * * *" "openclaw skills run email --fetch --summary && openclaw notify feishu --content '今日新闻摘要已生成'" - 验证:等待次日9点,或手动执行命令测试。
(三)自定义技能开发:从零开发你的专属技能
当官方技能无法满足需求时,可以开发自定义技能。OpenClaw推荐使用TypeScript开发,类型安全且易于维护。
1. 开发环境准备
# 进入容器
docker exec -it openclaw bash
# 安装开发依赖
npm install -g @clawdev/cli typescript
2. 初始化技能项目
# 创建技能目录
mkdir -p /app/skills/my-custom-skill
cd /app/skills/my-custom-skill
# 初始化项目
clawdev init
# 按提示填写技能名称、描述、作者等信息
3. 编写技能代码(示例:随机名言生成器)
创建src/index.ts文件:
import {
Skill, Context } from '@clawdev/core';
// 定义技能元信息
const meta = {
name: 'random-quote',
version: '1.0.0',
description: '生成一句随机名人名言',
author: 'Your Name',
parameters: []
};
// 实现技能逻辑
class RandomQuoteSkill extends Skill {
constructor() {
super(meta);
}
async run(context: Context): Promise<string> {
// 模拟名言库
const quotes = [
"人生就像骑自行车,想要保持平衡就得不断前进。- 爱因斯坦",
"代码的可读性至关重要。