Hookaido Webhook Integration
Webhook infrastructure for receiving, queuing, and delivering webhooks. Operate Hookaido webhook ingress, durable webhook queue (SQLite/Postgres), webhook de...
Rank
62
Safety
84
Downloads
2.0k
Updated
Oct 9, 2026
Version
2.6.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2K downloadsadoption · observed Oct 9, 2026
- Latest release
- 2.6.0release · observed Apr 20, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s172ytmvxmznx2s25dx1dnqs4583fcr3:hookaido- Install using `clawhub skill install s172ytmvxmznx2s25dx1dnqs4583fcr3:hookaido` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/7schmiede/hookaido before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-7schmiede-hookaido/snapshot"
Documentation
CLAWHUB
148,409 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: hookaido
version: "2.6.0"
description: >-
Webhook infrastructure for receiving, queuing, and delivering webhooks.
Operate Hookaido webhook ingress, durable webhook queue (SQLite/Postgres),
webhook delivery (HTTP push, subprocess exec, pull API, SSE streaming),
webhook signature verification (HMAC, GitHub, Gitea, Stripe, Cituro),
dead-letter queue, and webhook retry policies. Use when tasks involve webhook
endpoint configuration (Hookaidofile), webhook queue backends (sqlite, memory,
postgres), hookaido CLI (run, config fmt, config validate, mcp serve),
webhook consumption (dequeue/ack/nack/extend) over HTTP, SSE, or gRPC,
subprocess webhook handlers (deliver exec), webhook provider HMAC
(GitHub/Gitea/Stripe/Cituro), Admin API webhook backlog/DLQ triage, or
production webhook hardening.
metadata:
openclaw:
homepage: https://github.com/7schmiede/claw-skill-hookaido
emoji: "\U0001FA9D"
primaryEnv: HOOKAIDO_PULL_TOKEN
requires:
bins:
- hookaido
env:
- HOOKAIDO_PULL_TOKEN
- HOOKAIDO_INGRESS_SECRET
install:
- id: go-install
kind: go
package: github.com/nuetzliches/hookaido/cmd/[email protected]
bins:
- hookaido
- id: download-darwin-amd64
kind: download
os:
- darwin
url: https://github.com/nuetzliches/hookaido/releases/download/v2.6.0/hookaido_v2.6.0_darwin_amd64.tar.gz
archive: tar.gz
extract: true
stripComponents: 1
targetDir: ~/.local/bin
bins:
- hookaido
label: Download hookaido v2.6.0 (macOS amd64)
- id: download-darwin-arm64
kind: download
os:
- darwin
url: https://github.com/nuetzliches/hookaido/releases/download/v2.6.0/hookaido_v2.6.0_darwin_arm64.tar.gz
archive: tar.gz
extract: true
stripComponents: 1
targetDir: ~/.local/bin
bins:
- hookaido
label: Download hookaido v2.6.0 (macOS arm64)
- id: download-linux-amd64
kind: download
os:
- linux
url: https://github.com/nuetzliches/hookaido/releases/download/v2.6.0/hookaido_v2.6.0_linux_amd64.tar.gz
archive: tar.gz
extract: true
stripComponents: 1
targetDir: ~/.local/bin
bins:
- hookaido
label: Download hookaido v2.6.0 (Linux amd64)
- id: download-linux-arm64
kind: download
os:
- linux
url: https://github.com/nuetzliches/hookaido/releases/download/v2.6.0/hookaido_v2.6.0_linux_arm64.tar.gz
archive: tar.gz
extract: true
stripComponents: 1
targetDir: ~/.local/bin
bins:
- hookaido
label: Download hookaido v2.6.0 (Linux arm64)
- id: download-windows-amd64
kind: download
os:
- win32
url: https://github.com/nuetzliches/hookaido/releases/download/v2.6.0/hookaREADME.md
# hookaido
Public OpenClaw skill for [Hookaido](https://github.com/nuetzliches/hookaido) — webhook infrastructure that just works.
Repository link for skill distribution:
- `https://github.com/7schmiede/claw-skill-hookaido`
Upstream Hookaido project:
- `https://github.com/nuetzliches/hookaido`
This skill is pinned to Hookaido `v2.6.0` and keeps existing inbound/outbound/pull workflows as the default path.
New capabilities such as `deliver exec` (subprocess delivery), provider-compatible HMAC (GitHub/Gitea/Stripe/Cituro), SSE streaming (`{pull.path}/stream`), `queue postgres`, gRPC pull workers, batch `ack`/`nack`, and release verification are documented as additive modules so existing usage does not receive breaking changes by default.
Main files:
- `SKILL.md` for skill metadata and operating guidance
- `references/operations.md` for install, runtime, and API command examples
- `scripts/install_hookaido.sh` for pinned release-binary installation with SHA256 verification
- `RELEASE_NOTES.md` for the current public skill release summary_meta.json
{
"ownerId": "kn70n9zjjpmw2dg19a8n5w8bm1813vkf",
"slug": "hookaido",
"version": "2.6.0",
"publishedAt": 1776723618274
}references/operations.md
# Hookaido Operations Reference Use this file for concrete command syntax and request payloads. ## Install Hookaido OpenClaw supports two runtime variants. Public repositories: - Upstream project: `https://github.com/nuetzliches/hookaido` - Public skill repo: `https://github.com/7schmiede/claw-skill-hookaido` ### Variant A: Host Binary (Gateway/Host) - Use one of the skill installer actions from `metadata.openclaw.install` (platform + architecture specific download). - Choose the artifact that matches your host architecture (`amd64` or `arm64`). - The OpenClaw download URLs are pinned to Hookaido `v2.6.0`. - macOS/Linux installers extract to `~/.local/bin` (with `stripComponents: 1`). - Windows installers extract to `~/.openclaw/tools/hookaido`. Direct CLI fallback: ```bash go install github.com/nuetzliches/hookaido/cmd/[email protected] ``` Release-binary fallback from this skill folder: ```bash bash {baseDir}/scripts/install_hookaido.sh ``` The fallback installer is hardened: - Defaults to pinned `v2.6.0` (no dynamic `latest` lookup). - Verifies SHA256 of the downloaded release artifact before extraction/install. Optional pins/overrides for the installer script: ```bash # Default pinned install, custom location HOOKAIDO_INSTALL_DIR="$HOME/bin" bash {baseDir}/scripts/install_hookaido.sh # Non-default release requires explicit checksum HOOKAIDO_VERSION=v2.0.1 \ HOOKAIDO_SHA256="<artifact-sha256>" \ bash {baseDir}/scripts/install_hookaido.sh ``` ### Variant B: Docker Sandbox - OpenClaw supports Docker sandbox mode via `sandboxing.enabled: true` and `sandboxing.type: docker`. - Preferred: provide a custom sandbox image with `hookaido` preinstalled, and pin the image by immutable digest. - Optional: use `agents.defaults.sandbox.docker.setupCommand` to install `hookaido` inside the container at startup. - Keep `metadata.openclaw.install` as fallback and for `metadata.openclaw.requires.bins` checks on the host. ## Core CLI Commands ```bash # Validate and format config hookaido config fmt --config ./Hookaidofile hookaido config validate --config ./Hookaidofile hookaido config validate --config ./Hookaidofile --strict-secrets # Start runtime hookaido run --config ./Hookaidofile --db ./.data/hookaido.db # Start runtime with Postgres queue backend hookaido run --config ./Hookaidofile --postgres-dsn "$HOOKAIDO_POSTGRES_DSN" # Start runtime with live config watch hookaido run --config ./Hookaidofile --db ./.data/hookaido.db --watch # Start MCP server (read-only) hookaido mcp serve --config ./Hookaidofile --db ./.data/hookaido.db --role read # Verify a public release bundle before rollout hookaido verify-release \ --checksums ./hookaido_v2.6.0_checksums.txt \ --public-key ./hookaido_v2.6.0_checksums.txt.pub.pem \ --require-provenance ``` ## Minimal Pull-Mode Config ```hcl ingress { listen :8080 } pull_api { listen :9443 auth token env:HOOKAIDO_PULL_TOKEN } /webhooks/github { auth hmac env:HOOKAIDO_INGRESS_SECRET pul
RELEASE_NOTES.md
# Release Notes
## GitHub Release Summary
Recommended tag: `v2.6.0`
Feature update pinning to upstream Hookaido `v2.6.0`.
New: Stripe and Cituro HMAC providers, SSE streaming endpoint, Claude Code MCP plugin guidance.
## v2.6.0 - 2026-04-21
Feature update pinning to upstream Hookaido `v2.6.0`.
### Highlights
- Pinned all binary installer actions and checksums to Hookaido `v2.6.0`.
- Added `provider stripe` and `provider cituro` to provider-compatible HMAC config (v2.6.0 upstream).
- Added SSE streaming playbook: `GET {pull.path}/stream` for real-time webhook delivery without polling (v2.5.3 upstream).
- Added Claude Code MCP plugin configuration examples (`.claude/settings.json`) for read and operate roles.
### Compatibility
Additive coverage. All existing skill workflows remain unchanged.
## v2.2.2 - 2026-04-15
Performance update pinning to upstream Hookaido `v2.2.2`.
### Highlights
- Pinned all binary installer actions and checksums to Hookaido `v2.2.2`.
- Upstream fix: queue dequeue loop now uses event-driven channel notification instead of 25ms polling. Enqueue signals waiting Dequeue goroutines immediately; fallback polling raised to 1s for delayed/retry items only. Idle CPU drops from ~26% to <1% (SQLite and PostgreSQL backends).
### Compatibility
No new features. All existing skill workflows remain unchanged.
## v2.2.1 - 2026-03-30
Bugfix-only update pinning to upstream Hookaido `v2.2.1`.
### Highlights
- Pinned all binary installer actions and checksums to Hookaido `v2.2.1`.
- Upstream fixes: dispatcher delivery logging (previously silent), zero-target route warning, hot-reload for delivery config changes via `--watch`/SIGHUP.
### Compatibility
No new features. All existing skill workflows remain unchanged.
## v2.2.0 - 2026-03-28
This release updates the public Hookaido skill to upstream Hookaido `v2.2.0`.
### Highlights
- Pinned all binary installer actions and checksums to Hookaido `v2.2.0`.
- Added `deliver exec` playbook for subprocess delivery (payload on stdin, exit-code retry semantics).
- Added provider-compatible HMAC playbook for GitHub (`X-Hub-Signature-256`) and Gitea/Forgejo (`X-Gitea-Signature`).
- Updated operations reference with exec delivery and provider-HMAC config examples.
### Compatibility
Additive v2.2.0 coverage includes:
- `deliver exec` for local script/binary execution with env-var metadata and exit-code retry semantics
- `auth hmac { provider github }` / `auth hmac { provider gitea }` for native webhook signature verification
- Custom outbound headers in deliver blocks with placeholder interpolation
All existing skill workflows remain unchanged.
## v2.0.0 - 2026-03-09
This release updates the public Hookaido skill to upstream Hookaido `v2.0.0` and prepares the repository for distribution via its public GitHub URL.
### Highlights
- Pinned all binary installer actions to Hookaido `v2.0.0`.
- Updated the fallback installer script with the official `v2.0.0` SHA256 checksums for macOAionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/7schmiede/skills/hookaido",
"sourceUrl": "https://clawhub.ai/7schmiede/skills/hookaido",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T20:12:46.942Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-7schmiede-hookaido/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-7schmiede-hookaido/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T20:12:46.942Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2K downloads",
"href": "https://clawhub.ai/7schmiede/hookaido",
"sourceUrl": "https://clawhub.ai/7schmiede/hookaido",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T20:12:46.942Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "2.6.0",
"href": "https://clawhub.ai/7schmiede/hookaido",
"sourceUrl": "https://clawhub.ai/7schmiede/hookaido",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-20T22:20:18.274Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-7schmiede-hookaido/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-7schmiede-hookaido/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 2.6.0",
"description": "- Version bump to 2.6.0 with updated binaries and install sources. - Added a LICENSE file. - Support for new webhook providers and delivery types reflected in documentation. - Expanded install matrix for more platforms with version 2.6.0 artifacts. - Documentation updates to reference v2.6.0 features and instructions.",
"href": "https://clawhub.ai/7schmiede/hookaido",
"sourceUrl": "https://clawhub.ai/7schmiede/hookaido",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-20T22:20:18.274Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
