Fieldy AI Webhook

What this sets up

You’ll configure Moltbot Gateway webhooks so an incoming request to POST /hooks/fieldy runs through a transform module (fieldy-webhook.js) before triggering an agent run.

Behavior notes (defaults in fieldy-webhook.js):

• Saying "Hey, Fieldy" (or just "Fieldy") will trigger the agent with the text after the wake word.
• Transcripts without the wake word will not wake the agent; they’ll only be logged to JSONL files by fieldy-webhook.js (under \x3Cworkspace>/fieldy/transcripts/).
• You can adjust wake words, parsing, and logging behavior by editing fieldy-webhook.js.

1) Put the transform script in the configured transforms dir

Your hooks.transformsDir is:

/root/clawd/skills/fieldy/scripts

Move the script from this repo:

• From: src/fieldy-webhook.js
• To: /root/clawd/skills/fieldy/scripts/fieldy-webhook.js

Notes:

• Make sure the destination filename is exactly fieldy-webhook.js (matches the config below).

2) Add the webhook mapping to ~/.clawdbot/moltbot.json

Add this config:

"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"
      }
    }
  ]
}

Important:

• hooks.token is required when hooks are enabled (see Webhooks docs).
• Ensure hooks.enabled: true exists somewhere in your config (and optionally hooks.path, default is /hooks).

3) Restart the Gateway

Plugins/config changes generally require a gateway restart. After restarting, the webhook endpoint should be live.

4) Configure the webhook URL in the Fieldy app

• Log in to your Fieldy app
• Go to Settings → Developer Settings
• Set Webhook Endpoint URL to:

https://your-url.com/hooks/fieldy?token=insert-your-token

Note: Moltbot supports sending the token via header too, but many webhook providers only support query params. Moltbot still accepts ?token= (see Webhooks docs).

5) Test

Example request (adjust host/port and token):

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"}'