介绍
## What this sets up
你将配置 Moltbot Gateway webhook，以便发送到 `POST /hooks/fieldy` 的传入请求在触发 **agent** 运行之前先通过 **transform module**（`fieldy-webhook.js`）进行处理。
行为说明（`fieldy-webhook.js` 中的默认值）： - 说 **“Hey, Fieldy”**（或者只说 **“Fieldy”**）将使用唤醒词 **之后** 的文本 **触发** agent。 - **不包含**唤醒词的转录将 **不会** 唤醒 agent；它们只会被 `fieldy-webhook.js` **记录为 JSONL 文件**（位于 `<workspace>/fieldy/transcripts/` 下）。 - 你可以通过编辑 `fieldy-webhook.js` 来调整唤醒词、解析和记录行为。
## 1) 将转换脚本放入已配置的 transforms 目录
你的 `hooks.transformsDir` 是：
`/root/clawd/skills/fieldy/scripts`
将脚本从该仓库移动：
- 从：`src/fieldy-webhook.js` - 到：`/root/clawd/skills/fieldy/scripts/fieldy-webhook.js`
注意： - 确保目标文件名准确为 `fieldy-webhook.js`（与下面的配置匹配）。
## 2) 将 webhook 映射添加到 `~/.clawdbot/moltbot.json`
添加此配置：
```json "hooks": { "token": "insert-your-token", "transformsDir": "/root/clawd/skills/fieldy/scripts", "mappings": [ { "match": { "path": "fieldy" }, "action": "agent", "name": "Fieldy", "messageTemplate": "{{message}}", "deliver": true, "transform": { "module": "fieldy-webhook.js" } } ] } ```
重要事项： - 当启用 hooks 时，`hooks.token` 是必需的（请参阅 [Webhooks 文档](https://docs.molt.bot/automation/webhook.md)）。 - 确保你的配置中某处存在 `hooks.enabled: true`（以及可选的 `hooks.path`，默认为 `/hooks`）。
## 3) 重启 Gateway
插件/配置的更改通常需要重启网关。重启后，webhook 端点应该就处于活动状态了。
## 4) 在 Fieldy 应用中配置 webhook URL
- 登录到你的 Fieldy 应用 - 转到 **Settings**（设置）→ **Developer Settings**（开发者设置） - 将 **Webhook Endpoint URL**（Webhook 端点 URL）设置为：
`https://your-url.com/hooks/fieldy?token=insert-your-token`
注意：Moltbot 支持通过 header 发送 token，但许多 webhook 提供商仅支持查询参数。Moltbot 仍然接受 `?token=`（请参阅 [Webhooks 文档](https://docs.molt.bot/automation/webhook.md)）。
## 5) 测试
示例请求（调整主机/端口和 token）：
```bash curl -X POST "http://127.0.0.1:18789/hooks/fieldy" \ -H "Authorization: Bearer insert-your-token" \ -H "Content-Type: application/json" \ -d '{"transcript":"Hey Fieldy summarize this: hello world"}' ```