fieldy-ai-webhook: 将 Fieldy Webhook 转换接入 Moltbot 钩子

name: fieldy
description: 将 Fieldy 的 webhook 转换功能接入 Moltbot 钩子。

功能概述

此配置将设置 Moltbot Gateway 的 webhook，使得发送到 POST /hooks/fieldy 的请求会先经过一个转换模块 (fieldy-webhook.js) 处理，再触发智能体运行。

行为说明（基于 fieldy-webhook.js 的默认设置）：
- 说出 "Hey, Fieldy"（或仅 "Fieldy"）将唤醒智能体，并处理唤醒词之后的文本。
- 若转录文本不含唤醒词，则不会唤醒智能体；这些文本仅会被 fieldy-webhook.js 记录到 JSONL 文件中（位于 <workspace>/fieldy/transcripts/ 目录下）。
- 可通过编辑 fieldy-webhook.js 来调整唤醒词、解析逻辑和日志记录行为。

1) 将转换脚本放入指定的转换目录

你的 hooks.transformsDir 路径为：

/root/clawd/skills/fieldy/scripts

将本仓库中的脚本移动至该目录：

• 源文件：src/fieldy-webhook.js
• 目标路径：/root/clawd/skills/fieldy/scripts/fieldy-webhook.js

注意：
- 确保目标文件名严格为 fieldy-webhook.js（与后续配置保持一致）。

2) 在 ~/.clawdbot/moltbot.json 中添加 webhook 映射

添加以下配置：

"hooks": {
  "token": "请在此处填入你的令牌",
  "transformsDir": "/root/clawd/skills/fieldy/scripts",
  "mappings": [
    {
      "match": {
        "path": "fieldy"
      },
      "action": "agent",
      "name": "Fieldy",
      "messageTemplate": "{{message}}",
      "deliver": true,
      "transform": {
        "module": "fieldy-webhook.js"
      }
    }
  ]
}

重要提示：
- 启用 webhook 时，hooks.token 为必填项（详见 Webhooks 文档）。
- 请确保配置中存在 hooks.enabled: true（以及可选的 hooks.path，默认为 /hooks）。

3) 重启 Gateway

插件或配置变更通常需要重启 Gateway。重启后，webhook 端点即可生效。

4) 在 Fieldy 应用中配置 webhook URL

• 登录你的 Fieldy 应用。
• 进入 设置 → 开发者设置。
• 将 Webhook 端点 URL 设置为：

https://你的域名.com/hooks/fieldy?token=请在此处填入你的令牌

注：Moltbot 也支持通过请求头传递令牌，但许多 webhook 服务商仅支持查询参数。Moltbot 仍接受 ?token= 形式（详见 Webhooks 文档）。

5) 测试

示例请求（请根据实际情况调整主机、端口和令牌）：

curl -X POST "http://127.0.0.1:18789/hooks/fieldy" \
  -H "Authorization: Bearer 请在此处填入你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"transcript":"Hey Fieldy summarize this: hello world"}'