bazhuayu-rpa-webhook

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

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

## ⚠️ 使用前必读

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

| 变量名 | 说明 | 是否必需 |
|--------|------|----------|
| `BAZHUAYU_WEBHOOK_URL` | 八爪鱼 RPA Webhook 地址 | **必需** |
| `BAZHUAYU_WEBHOOK_KEY` | 签名密钥 | **必需** |

**配置方式（二选一）：**
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 目录
cp -r ~/.openclaw/workspace/skills/bazhuayu-webhook /你的路径/

# 进入目录
cd /你的路径/bazhuayu-webhook
```

## 🚀 快速配置

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

```bash
./setup-secure.sh
```

按提示输入 Webhook URL 和签名密钥，脚本会：
- 生成环境变量配置示例
- 更新 `config.json`（密钥留空，从环境变量读取）
- **不会**自动修改你的 shell 配置文件

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

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

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

```bash
export BAZHUAYU_WEBHOOK_URL="你的 Webhook URL"
export BAZHUAYU_WEBHOOK_KEY="你的签名密钥"
```

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

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

```bash
export BAZHUAYU_WEBHOOK_URL="你的 Webhook URL"
export BAZHUAYU_WEBHOOK_KEY="你的签名密钥"
```

### 验证配置

```bash
python3 bazhuayu-webhook.py secure-check
```

## 🔧 使用方法

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

```bash
python3 bazhuayu-webhook.py run
```

### 运行任务（指定参数值）...

# 八爪鱼 RPA Webhook 调用工具 (安全增强版)

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

## 🔐 安全特性

- ✅ **环境变量支持** - 敏感信息可使用环境变量存储 (优先级高于配置文件)
- ✅ **文件权限保护** - 配置文件自动设置为 600 (仅所有者可读写)
- ✅ **日志脱敏** - 输出自动隐藏敏感信息
- ✅ **安全检查** - `secure-check` 命令帮助发现潜在风险

### 推荐配置方式

| 信息类型 | 推荐存储方式 | 说明 |
|----------|--------------|------|
| 签名密钥 | 环境变量 | `BAZHUAYU_WEBHOOK_KEY` |
| Webhook URL | 环境变量或配置文件 | `BAZHUAYU_WEBHOOK_URL` |
| 参数默认值 | 配置文件或环境变量 | 非敏感值可用配置文件 |

---

## 📦 安装

### 方式一：直接复制

```bash
# 复制整个 skill 目录
cp -r /path/to/bazhuayu-webhook ~/your/path/

# 进入目录
cd ~/your/path/bazhuayu-webhook
```

### 方式二：从 ClawHub 安装（待发布）

```bash
clawhub install bazhuayu-webhook
```

---

## 📖 第一步：获取 Webhook URL 和签名

在配置技能之前，首先需要在八爪鱼 RPA 中创建 Webhook 触发器。

### 步骤 1：创建 Webhook 触发器

1. 登录 [八爪鱼 RPA 控制台](https://rpa.bazhuayu.com/)
2. 进入【触发器】栏目
3. 点击 **"Webhook 触发器"**

### 步骤 2：填写触发器信息

按顺序填写：

1. **触发器名称** → 输入易于识别的名称（如：订单处理、数据采集等）
2. **指定运行的机器人** → 选择要执行任务的机器人
3. **选择要运行的应用** → 选择对应的 RPA 应用
4. 点击 **"确定"**

### 步骤 3：获取 Webhook 信息

创建成功后，会显示 Webhook 的详细信息：

- **Webhook URL** → 复制保存（格式：`https://api-rpa.bazhuayu.com/api/v1/bots/webhooks/xxx/invoke`）
- **签名密钥 (Key)** → 复制保存（用于签名验证）

### 步骤 4：启动触发器

⚠️ **重要**：勾选 **"启动触发器"**，否则 Webhook 不会生效！

---

## ⚙️ 第二步：配置技能

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

```bash
cd ~/.openclaw/workspace/skills/bazhuayu-webhook
./setup-secure.sh
```

按提示输入 Webhook URL 和签名密钥，脚本会：
- ✅ 生成环境变量配置示例
- ✅ 创建安全的配置文件（权限 600）
- ⚠️ **不会**自动修改 Shell 配置文件（需手动添加）

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