Install
openclaw skills install @thcjp/gif-whatsapp-tool-proopenclaw skills install @thcjp/gif-whatsapp-tool-pro功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。
WhatsApp 表情专业版是面向企业用户和营销团队的进阶 GIF 管理工具。在免费版基础搜索发送能力之上,新增批量群发、定时任务、GIF 库管理、多账号支持与效果分析等高级功能,助力企业通过 WhatsApp 进行高效的客户沟通与营销推广。与免费版完全兼容,已有工作流可无缝升级.
| 能力 | 免费版 | PRO 版 |
|---|---|---|
| GIF 搜索 | 单次 5 个结果 | 单次 20 个结果 |
| 格式转换 | GIF 转 MP4 | GIF 转 MP4 + 水印 |
| 发送方式 | 单人单发 | 批量群发 |
| 自定义字幕 | 否 | 是 |
| 定时发送 | 否 | Cron 调度 |
| GIF 库管理 | 否 | 标签分类管理 |
| 多账号 | 否 | 支持多账号 |
| 效果分析 | 否 | 发送统计报告 |
| 品牌水印 | 否 | 自定义水印 |
| API 接口 | 否 | REST API |
| 优先支持 | 社区 | 优先响应 |
| 处理: 解析功能对比的输入参数,完成核心逻辑,返回结构化响应. | ||
| 输出: 返回功能对比的响应数据,包含状态码、结果和日志. |
python (请参考skill目录中的脚本文件) \
--gif-library ./gifs/celebration.mp4 \
--contacts contacts.csv \
--message "节日快乐" \
--delay 5
支持从 CSV 导入联系人列表,批量发送相同或不同的 GIF,自动控制发送频率避免限制.
# 定时发送节日祝福
python (请参考skill目录中的脚本文件) \
--gif ./gifs/newyear.mp4 \
--contacts customer_list.csv \
--cron="0 0 1 1 *" \
--message "新年快乐!感谢您一年的支持"
# 添加 GIF 到收藏库
python (请参考skill目录中的脚本文件) add ./gifs/thanks.mp4 \
--tags="感谢,客户关怀" \
--category="客户服务"
# ...
# 搜索库中的 GIF
python (请参考skill目录中的脚本文件) search --tag="感谢" --category="客户服务"
# ...
# 查看库统计
python (请参考skill目录中的脚本文件) stats
# 为 GIF 添加品牌水印
python (请参考skill目录中的脚本文件) \
--input ./gifs/original.mp4 \
--output ./gifs/branded.mp4 \
--logo ./assets/logo.png \
--position bottom-right \
--opacity 0.8
处理: 解析PRO 版独有功能的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回PRO 版独有功能的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作用input_params参数进行配置.
处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:企业级、WhatsApp、管理工具、支持批量发送、多账号与营销分析、适合团队协作与营、销场景、Use、when、需要项目管理、任务规划、进度跟踪、团队协作时使用、不适用于实际人员、绩效评估、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.营销团队需要在节日期间向所有客户发送祝福 GIF.
# 准备客户联系人列表
cat > customers.csv <<EOF
name,phone
张三,+8613800001111
李四,+8613800002222
王五,+8613800003333
EOF
# ...
# 搜索节日 GIF
gifgrep "mid autumn festival" --max 10 --format url
# ...
# 下载并添加品牌水印
python (请参考skill目录中的脚本文件) \
--input /tmp/festival.gif \
--output ./gifs/festival_branded.mp4 \
--logo ./assets/company_logo.png
# ...
# 批量发送
python (请参考skill目录中的脚本文件) \
--contacts customers.csv \
--message "中秋快乐!感谢您选择我们的服务" \
--delay 10 \
--export=send_report.json
系统自动逐个发送,控制频率避免触发 WhatsApp 限制,生成发送报告包含成功/失败统计.
客服团队需要在新客户注册后自动发送欢迎 GIF.
# 配置定时任务
python (请参考skill目录中的脚本文件) \
--gif ./gifs/welcome.mp4 \
--contacts new_customers.csv \
--cron="0 10 * * *" \
--message "欢迎加入!如有问题随时联系我们" \
--condition="new_registration" \
--archive-dir=./welcome_campaign
每日 10 点检查新注册客户,自动发送欢迎 GIF,归档发送记录.
多个客服人员使用不同 WhatsApp 账号同时工作.
# 配置多账号
python (请参考skill目录中的脚本文件) add \
--name="客服小王" \
--phone="+8613800001111"
# ...
python (请参考skill目录中的脚本文件) add \
--name="客服小李" \
--phone="+8613800002222"
# ...
# 分配发送任务
python (请参考skill目录中的脚本文件) \
--gif ./gifs/thanks.mp4 \
--account="客服小王" \
--split 50 # 每个账号发送 50%
# 依赖说明
pip install pandas schedule pillow
# ...
# 初始化 GIF 库
python (请参考skill目录中的脚本文件) init \
--storage=./gif_library \
--categories="客户服务,节日祝福,产品推广,日常沟通"
# ...
# 验证升级
python (请参考skill目录中的脚本文件) --version
# 准备联系人 CSV
echo "name,phone
测试用户,+8613800000000" > test_contacts.csv
# ...
# 执行测试发送
python (请参考skill目录中的脚本文件) \
--gif ./gifs/welcome.mp4 \
--contacts test_contacts.csv \
--message "测试发送" \
--delay 5
响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.
# config.yaml - PRO 版企业配置
whatsapp:
default_account: main
accounts:
main:
name: 主账号
phone: "+8613800000000"
service:
name: 客服账号
phone: "+8613800001111"
# ...
sending:
batch_size: 100
delay_between_sends: 10
max_daily_sends: 500
retry_on_failure: true
retry_count: 3
# ...
gif_library:
storage: ./gif_library
categories:
- 客户服务
- 节日祝福
- 产品推广
- 日常沟通
auto_tag: true
# ...
watermark:
enabled: true
logo: ./assets/logo.png
position: bottom-right
opacity: 0.8
# ...
analytics:
enabled: true
storage: ./analytics
report_frequency: weekly
| 参数 | 类型 | 默认值 | 范围 | 说明 |
|---|---|---|---|---|
--gif | 字符串 | 无 | 路径 | GIF/MP4 文件路径 |
--contacts | 字符串 | 无 | CSV 路径 | 联系人列表 |
--message | 字符串 | 空格 | 文本 | 自定义消息 |
--delay | 整数 | 5 | 1-60 | 发送间隔秒数 |
--cron | 字符串 | 无 | Cron 表达式 | 定时任务 |
--watermark | 布尔 | true | true/false | 启用水印 |
--export | 字符串 | json | json/csv | 报告格式 |
--account | 字符串 | main | 账号名 | 指定发送账号 |
--split | 整数 | 100 | 1-100 | 账号分流百分比 |
# batch_config.py - 批量发送配置
from batch_send import BatchSendConfig
# ...
config = BatchSendConfig(
batch_size=50,
delay_between_sends=10,
max_daily_sends=200,
retry_on_failure=True,
retry_count=3,
watermark_enabled=True,
custom_message=True,
track_delivery=True
)
# ...
# 执行批量发送
results = config.execute(
gif_path="./gifs/promotion.mp4",
contacts="customers.csv"
)
# 按场景分类管理 GIF
python (请参考skill目录中的脚本文件) organize \
--auto-classify \
--tags-from-filename
# ...
# 创建标签体系
python (请参考skill目录中的脚本文件) tags add \
--tag="高优先级" \
--description="重要客户使用"
# ...
# 智能推荐
python (请参考skill目录中的脚本文件) recommend \
--context="客户感谢" \
--limit 5
# 生成发送效果报告
python (请参考skill目录中的脚本文件) \
--period="2026-01" \
--output=monthly_report.md
# ...
# 查看发送统计
python (请参考skill目录中的脚本文件) stats \
--metric=delivery_rate \
--period=weekly
# ...
# 导出详细数据
python (请参考skill目录中的脚本文件) export \
--format=csv \
--output=detailed_stats.csv
# 增加发送间隔
python (请参考skill目录中的脚本文件) --delay 30 contacts.csv
# ...
# 减少每日发送量
python (请参考skill目录中的脚本文件) --max-daily=100 contacts.csv
# ...
# 使用多账号分流
python (请参考skill目录中的脚本文件) --split 50 --account=all contacts.csv
# 检查水印图片格式
file ./assets/logo.png
# ...
# 确保图片为 PNG 透明背景
python (请参考skill目录中的脚本文件) --validate-logo ./assets/logo.png
# ...
# 调整水印参数
python (请参考skill目录中的脚本文件) \
--input input.mp4 \
--output output.mp4 \
--logo logo.png \
--opacity 0.5
# 检查任务列表
python (请参考skill目录中的脚本文件) --list
# ...
# 查看任务日志
cat ./logs/scheduled_send.log
# ...
# 手动触发测试
python (请参考skill目录中的脚本文件) --run-now --task-id=task_001
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| gifgrep | CLI 工具 | 是 | 参考官方文档安装 |
| ffmpeg | 多媒体处理 | 是 | brew install ffmpeg 或 apt install ffmpeg |
| curl | 文件下载 | 是 | 系统自带 |
| pandas | 数据处理 | 否(推荐) | pip install pandas |
| schedule | 定时任务 | 否(推荐) | pip install schedule |
| pillow | 图片处理 | 否(推荐) | pip install pillow |
| WhatsApp message 工具 | 发送服务 | 是 | 平台内置 |
| LLM API | API | 是 | 由 Agent 内置 LLM 提供 |
export DB_HOST=localhost
export DB_PORT=5432
export DB_NAME=whatsapp_analytics
export DB_USER=admin
export DB_PASSWORD=your_password
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
{
"success": true,
"data": {
"result": "WhatsApp表情专业版处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "gif whatsapp pro"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置,禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令,避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议,验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
| 使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。 |
| 操作场景 | 手动耗时 | 自动化耗时 | 效率提升 |
|---|---|---|---|
| 文件解析与提取 | 5-10分钟/个 | <5秒/个 | 60-120x |
| 批量文件处理(100个) | 8-16小时 | <5分钟 | 96-192x |
| API调用与响应解析 | 2-3分钟/次 | <1秒/次 | 120-180x |
| 多接口数据聚合 | 15-30分钟 | <10秒 | 90-180x |
| 命令执行与结果收集 | 3-5分钟/次 | <2秒/次 | 90-150x |
| 重复任务批量执行 | 因任务而异 | 线性缩减 | 5-50x |
| 错误排查与修复 | 10-30分钟 | <30秒 | 20-60x |
| 对比维度 | WhatsApp表情专业版 | 传统手动方式 | 通用脚本工具 |
|---|---|---|---|
| 自动化程度 | 全流程自动 | 完全手动 | 部分自动 |
| 错误处理 | 内置错误恢复 | 依赖人工经验 | 基本try-catch |
| 可复用性 | 参数化配置 | 一次性脚本 | 模板化 |
| 安全合规 | 内置安全检查 | 无安全保障 | 无安全保障 |
| 适用场景 | 企业级 WhatsApp GIF 管理工具,支持批量发送、定时任务、GIF 库管 | 通用场景 | 通用场景 |