skills$openclaw/fieldy
mrzilvis8.8k

by mrzilvis

fieldy – OpenClaw Skill

fieldy is an OpenClaw Skills integration for writing workflows. Wire a Fieldy webhook transform into Moltbot hooks.

8.8k stars9.4k forksSecurity L1
Updated Feb 7, 2026Created Feb 7, 2026writing

Skill Snapshot

namefieldy
descriptionWire a Fieldy webhook transform into Moltbot hooks. OpenClaw Skills integration.
ownermrzilvis
repositorymrzilvis/fieldy-ai-webhook
languageMarkdown
licenseMIT
topics
securityL1
installopenclaw add @mrzilvis/fieldy-ai-webhook
last updatedFeb 7, 2026

Maintainer

mrzilvis

mrzilvis

Maintains fieldy in the OpenClaw Skills directory.

View GitHub profile
File Explorer
5 files
.
src
fieldy-webhook.js
3.1 KB
_meta.json
288 B
package.json
358 B
SKILL.md
2.6 KB
SKILL.md

name: fieldy description: Wire a Fieldy webhook transform into Moltbot hooks.

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 SettingsDeveloper 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"}'
README.md

No README available.

Permissions & Security

Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.

Requirements

  • OpenClaw CLI installed and configured.
  • Language: Markdown
  • License: MIT
  • Topics:

FAQ

How do I install fieldy?

Run openclaw add @mrzilvis/fieldy-ai-webhook in your terminal. This installs fieldy into your OpenClaw Skills catalog.

Does this skill run locally or in the cloud?

OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.

Where can I verify the source code?

The source repository is available at https://github.com/openclaw/skills/tree/main/skills/mrzilvis/fieldy-ai-webhook. Review commits and README documentation before installing.