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

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