八爪鱼 RPA Webhook 调用技能 (Bug 修复版 v2.0.6)

通过 Webhook 触发八爪鱼 RPA 任务运行，支持自定义参数传递。

⚠️ 使用前必读

本技能需要配置以下环境变量才能运行：

配置方式（二选一）：

1. 1. 推荐：手动添加到 shell 配置文件 (~/.bashrc 或 ~/.zshrc)
2. 临时：在当前终端会话中使用 export 命令

详见下方「🔧 快速配置」章节。

🔐 安全特性 (v2.0 新增)

• - ✅ 环境变量支持 - 敏感信息使用环境变量存储 (优先级高于配置文件)
• ✅ 文件权限保护 - 配置文件自动设置为 600 (仅所有者可读写)
• ✅ 日志脱敏 - 输出自动隐藏敏感信息
• ✅ 安全检查 - secure-check 命令帮助发现潜在风险
• ✅ 一键配置 - setup-secure.sh 快速安全配置
• ✅ 迁移工具 - migrate-to-env.sh 从旧配置迁移

📦 安装

方式一：从 ClawHub 安装

bash
clawhub install bazhuayu-webhook

方式二：手动复制

bash

复制 skill 目录

进入目录

🚀 快速配置

方式一：运行配置向导（推荐）

bash
./setup-secure.sh

按提示输入 Webhook URL 和签名密钥，脚本会：

• - 生成环境变量配置示例
• 更新 config.json（密钥留空，从环境变量读取）
• 不会自动修改你的 shell 配置文件

配置完成后，请手动将 export 命令添加到 ~/.bashrc 或 ~/.zshrc

方式二：手动配置环境变量

编辑 ~/.bashrc 或 ~/.zshrc，添加：

bash
export BAZHUAYUWEBHOOKURL=你的 Webhook URL
export BAZHUAYUWEBHOOKKEY=你的签名密钥

然后执行：
bash
source ~/.bashrc # 或 source ~/.zshrc

方式三：临时配置（仅当前终端会话）

bash
export BAZHUAYUWEBHOOKURL=你的 Webhook URL
export BAZHUAYUWEBHOOKKEY=你的签名密钥

验证配置

bash
python3 bazhuayu-webhook.py secure-check

🔧 使用方法

运行任务（使用默认参数）

bash
python3 bazhuayu-webhook.py run

运行任务（指定参数值）

bash
python3 bazhuayu-webhook.py run --A=新值 --B=新值

测试模式（不实际发送）

bash
python3 bazhuayu-webhook.py test

查看配置

bash
python3 bazhuayu-webhook.py config

安全检查 ⭐

bash
python3 bazhuayu-webhook.py secure-check

📝 配置文件

config.json - 存储 Webhook URL、参数配置（v2.0 起密钥建议使用环境变量）

json
{
url: Webhook 地址,
key: ,
paramNames: [A, B],
defaultParams: {A: 默认值 A, B: 默认值 B},
security: {
keyFromEnv: true,
version: 2.0
}
}

环境变量

如何设置环境变量：

1. 1. 永久生效（推荐）：添加到 ~/.bashrc 或 ~/.zshrc

1. 2. 临时生效（仅当前终端）：

🔐 签名算法

stringtosign = timestamp + \n + key
sign = Base64(HmacSHA256(stringtosign, message=))

本工具已自动处理签名计算，无需手动操作。

📤 返回结果

成功响应（HTTP 200）

json
{
enterpriseId: 企业 ID,
flowId: 应用 ID,
flowProcessNo: 运行批次号
}

失败响应（HTTP 400）

json
{
code: 错误码,
description: 错误描述
}

常见错误：

• - SignatureVerificationFailureOrTimestampExpired - 签名错误或时间戳过期
• 检查系统时间是否准确
• 检查 Key 是否正确

📁 文件结构

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 - 安全最佳实践

🆘 常见问题

Q: 如何配置环境变量？

1. 1. 编辑 ~/.bashrc 或 ~/.zshrc
2. 添加 export BAZHUAYUWEBHOOKURL=... 和 export BAZHUAYUWEBHOOKKEY=...
3. 运行 source ~/.bashrc 或 source ~/.zshrc 使配置生效
4. 运行 python3 bazhuayu-webhook.py secure-check 验证

Q: 签名验证失败？

1. 1. 检查系统时间是否准确
2. 检查 Key 是否正确（使用环境变量推荐）
3. 运行 secure-check 检查配置

Q: 如何迁移旧配置？

Q: 参数未设置值？

Q: 环境变量不生效？

1. 1. 确认已执行 source ~/.bashrc 或 source ~/.zshrc
2. 运行 echo $BAZHUAYUWEBHOOKKEY 检查是否已设置
3. 如使用新终端，需重新执行 source 命令

📞 技术支持

• - 八爪鱼 RPA 帮助中心
• Webhook 触发任务文档
• API 接口文档

📋 版本历史