OpenClaw is a powerful AI automation platform designed to reason, route, and take action across your tools. But before your agents can think, they need clean, structured, spam-free input. That’s where Basin comes in. Basin acts as the secure web forms and ingestion layer for OpenClaw, handling validation, spam filtering, and reliable delivery so your agents can focus on automation. In this guide, we’ll walk through how to connect Basin to OpenClaw using webhooks and optional polling for a production-ready setup.

Step 1: Create Your Basin Form

Start by creating a form inside your Basin dashboard. This form will act as the entry point for your website submissions.

1. Create a New Form: Inside Basin, create a new form for your project.
2. Enable Spam Filtering: Basin automatically filters spam using IP, content, and heuristic analysis.
3. Generate a Form API Key: Use a form-specific API key for least-privilege access.

Form API keys ensure OpenClaw only has access to submissions for that specific form.

Step 2: Add Basin to Your Website

Connect your website form to Basin by updating the action attribute to your unique Basin endpoint:

<form action="https://usebasin.com/f/your-unique-endpoint" method="POST">
  <label for="name">Name:</label>
  <input type="text" id="name" name="name" required>

  <label for="email">Email:</label>
  <input type="email" id="email" name="email" required>

  <label for="message">Message:</label>
  <textarea id="message" name="message" required></textarea>

  <button type="submit">Submit</button>
</form>

Once deployed, submissions will be securely stored inside Basin, indexed, and available via API.

Step 3: Configure Webhooks to OpenClaw

To enable real-time automation, configure a webhook in Basin that sends submission events directly to your OpenClaw Gateway.

1. Go to Webhooks in your Basin form settings.
2. Add a New Endpoint pointing to your OpenClaw instance:

https://your-openclaw-instance.com/hooks/basin

• Enable submission.created events.
• Optionally enable spam events if you want AI triage.
• Use HTTPS and configure webhook signing for security.

Now, whenever a user submits your form, Basin will notify OpenClaw instantly.

Step 4: Configure OpenClaw to Process Submissions

Inside OpenClaw, create a webhook handler that listens for Basin events and triggers an agent workflow.

Conceptually, your handler might look like this:

{
  "name": "Basin Submission Handler",
  "path": "/hooks/basin",
  "method": "POST",
  "description": "Processes new Basin submissions and routes them intelligently."
}

When a submission arrives, your OpenClaw agent can:

• Summarize the message
• Score the lead
• Create a CRM record
• Notify Slack
• Send a personalized email reply

You can already do most of these things directly within Basin. But your claw might have access to additonal systems and context that Basin does not have making this integration super powerful.

Step 5: Choose Your Spam Strategy

You have two powerful integration patterns:

• Ham-Only Processing (Recommended): Only send non-spam submissions to OpenClaw.
• Spam + Ham Processing: Let OpenClaw analyze spam trends, detect false positives, and update internal rules.

For most production systems, ham-only processing keeps your agents focused and efficient.

Step 6: Add Polling as a Fallback (Optional)

While webhooks provide real-time delivery, adding a polling fallback increases resilience.

Using Basin’s indexed API and pagination, OpenClaw can periodically check for unread submissions:

GET /api/v1/submissions?read=false&created_after=last_check

After processing a submission, mark it as read:

PATCH /api/v1/submissions/{id}
{
  "read_at": "2026-02-18T12:00:00Z"
}

This prevents duplicate processing and makes Basin behave like a durable event queue for OpenClaw.

Step 7: Secure Your Integration

For production environments, follow these best practices:

• Use Form API Keys instead of account-wide keys.
• Rotate keys periodically.
• Validate webhook signatures.
• Enable rate limiting.
• Use read/unread state to ensure idempotent processing.

Example Use Cases

• AI Lead Routing: Automatically assign enterprise leads to sales reps.
• Support Automation: Convert support submissions into tickets with summaries.
• Fraud Detection: Let OpenClaw analyze suspicious patterns across submissions.
• Automated Responses: Send intelligent follow-ups instantly after submission.

Conclusion

Basin is the production-grade web forms layer for OpenClaw. It handles secure ingestion, spam filtering, structured storage, indexed querying, and webhook delivery. OpenClaw handles reasoning, automation, and intelligent routing. Together, they create a powerful AI-native workflow that begins the moment a user clicks “Submit.”

If you're building AI-driven automation, start at the edge with Basin — and let OpenClaw handle the intelligence behind it.