八爪鱼 RPA Webhook 调用工具 - 通过 Webhook 触发 RPA 任务运行,支持自定义参数传递
通过 Webhook 触发八爪鱼 RPA 任务运行,支持自定义参数传递。
本技能需要配置以下环境变量才能运行:
| 变量名 | 说明 | 是否必需 |
|---|---|---|
BAZHUAYU_WEBHOOK_URL | 八爪鱼 RPA Webhook 地址 | 必需 |
BAZHUAYU_WEBHOOK_KEY | 签名密钥 | 必需 |
配置方式(二选一):
~/.bashrc 或 ~/.zshrc)export 命令详见下方「🔧 快速配置」章节。
secure-check 命令帮助发现潜在风险setup-secure.sh 快速安全配置migrate-to-env.sh 从旧配置迁移clawhub install bazhuayu-webhook
# 复制 skill 目录
cp -r ~/.openclaw/workspace/skills/bazhuayu-webhook /你的路径/
# 进入目录
cd /你的路径/bazhuayu-webhook
./setup-secure.sh
按提示输入 Webhook URL 和签名密钥,脚本会:
config.json(密钥留空,从环境变量读取)配置完成后,请手动将 export 命令添加到 ~/.bashrc 或 ~/.zshrc
编辑 ~/.bashrc 或 ~/.zshrc,添加:
export BAZHUAYU_WEBHOOK_URL="你的 Webhook URL"
export BAZHUAYU_WEBHOOK_KEY="你的签名密钥"
然后执行:
source ~/.bashrc # 或 source ~/.zshrc
export BAZHUAYU_WEBHOOK_URL="你的 Webhook URL"
export BAZHUAYU_WEBHOOK_KEY="你的签名密钥"
python3 bazhuayu-webhook.py secure-check
python3 bazhuayu-webhook.py run
python3 bazhuayu-webhook.py run --A=新值 --B=新值
python3 bazhuayu-webhook.py test
python3 bazhuayu-webhook.py config
python3 bazhuayu-webhook.py secure-check
config.json - 存储 Webhook URL、参数配置(v2.0 起密钥建议使用环境变量)
{
"url": "Webhook 地址",
"key": "",
"paramNames": ["A", "B"],
"defaultParams": {"A": "默认值 A", "B": "默认值 B"},
"security": {
"keyFromEnv": true,
"version": "2.0"
}
}
| 变量名 | 说明 | 是否必需 | 优先级 |
|---|---|---|---|
BAZHUAYU_WEBHOOK_URL | Webhook URL | 必需 | 高于配置文件 |
BAZHUAYU_WEBHOOK_KEY | 签名密钥 | 必需 | 高于配置文件 |
BAZHUAYU_PARAM_* | 参数默认值 | 可选 | 高于配置文件 |
如何设置环境变量:
永久生效(推荐):添加到 ~/.bashrc 或 ~/.zshrc
export BAZHUAYU_WEBHOOK_URL="你的 URL"
export BAZHUAYU_WEBHOOK_KEY="你的密钥"
临时生效(仅当前终端):
export BAZHUAYU_WEBHOOK_URL="你的 URL"
export BAZHUAYU_WEBHOOK_KEY="你的密钥"
string_to_sign = timestamp + "\n" + key
sign = Base64(HmacSHA256(string_to_sign, message=""))
本工具已自动处理签名计算,无需手动操作。
{
"enterpriseId": "企业 ID",
"flowId": "应用 ID",
"flowProcessNo": "运行批次号"
}
{
"code": "错误码",
"description": "错误描述"
}
常见错误:
SignatureVerificationFailureOrTimestampExpired - 签名错误或时间戳过期bazhuayu-webhook/
├── README.md # 使用说明
├── QUICKSTART.md # 5 分钟快速配置指南 ⭐
├── SECURITY.md # 安全指南
├── MANUAL.md # 详细使用手册
├── SKILL.md # 本文件
├── bazhuayu-webhook.py # 主程序 (安全增强版 v2.0)
├── setup-secure.sh # 一键安全配置脚本 ⭐
├── migrate-to-env.sh # 迁移到环境变量脚本
├── config.json # 配置文件 (敏感,已加入.gitignore)
├── config.example.json # 配置模板
└── .gitignore # Git 忽略规则
QUICKSTART.md - 5 分钟完成配置MANUAL.md - 完整使用指南SECURITY.md - 安全最佳实践A:
~/.bashrc 或 ~/.zshrcexport BAZHUAYU_WEBHOOK_URL="..." 和 export BAZHUAYU_WEBHOOK_KEY="..."source ~/.bashrc 或 source ~/.zshrc 使配置生效python3 bazhuayu-webhook.py secure-check 验证A:
secure-check 检查配置A: 运行 ./migrate-to-env.sh 迁移到环境变量模式,然后手动将生成的 export 命令添加到 shell 配置
A: 检查 config.json 中的参数名是否与 RPA 应用中的变量名完全一致
A:
source ~/.bashrc 或 source ~/.zshrcecho $BAZHUAYU_WEBHOOK_KEY 检查是否已设置| 版本 | 日期 | 更新内容 |
|---|---|---|
| 2.0.4 | 2026-03-08 | 📸 新增图文教程 - Webhook 设置步骤详解,包含截图示例 |
| 2.0.3 | 2026-03-08 | 🏷️ 名称优化 - 添加 RPA 关键词便于搜索和发现 |
| 2.0.2 | 2026-03-08 | 🔐 日志安全修复 - 新增日志权限自动修复、完善 SKILL.md 元数据环境变量声明 |
| 2.0.1 | 2026-03-08 | 🔧 安全优化 - 修复环境变量元数据、移除脚本自动修改 shell 配置、新增手动配置指南 |
| 2.0.0 | 2026-03-07 | 🔐 安全增强版 - 新增环境变量支持、安全检查、配置脚本 |
| 1.0.1 | 2026-03-07 | 🎉 初始公开发布 |
| 1.0.0 | - | 初始版本(内部迭代) |
MIT License