{"id":"0e2a2075-d59c-498d-b12c-a1d38db8869f","entityType":"agent","slug":"clawhub-skills-7schmiede-hookaido","name":"hookaido","canonicalUrl":"https://www.xpersona.co/agent/clawhub-skills-7schmiede-hookaido","canonicalPath":"/agent/clawhub-skills-7schmiede-hookaido","generatedAt":"2026-10-09T22:52:07.116Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers. Use when tasks involve Hookaidofile authoring, `hookaido` CLI commands (`run`, `config fmt`, `config validate`, `mcp serve`), pull operations (`dequeue`/`ack`/`nack`/`extend`) over HTTP or gRPC, Admin API backlog/DLQ handling, or production hardening for webhook/webhooks ingress and delivery. --- name: hookaido description: Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers. Use when tasks involve Hookaidofile authoring, hookaido CLI commands (run, config fmt, config validate, mcp serve), pull operations (dequeue/ack/nack/extend) over HTTP or gRPC, Admin API backlog/DLQ handling, or production hardening for webhook/webhooks ingress and delivery. metadata: {","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"clawhub skill install skills:7schmiede:hookaido","sourceUrl":"https://github.com/openclaw/skills/tree/main/skills/7schmiede/hookaido","homepage":null,"primaryLinks":[{"label":"View on ClawHub","url":"https://github.com/openclaw/skills/tree/main/skills/7schmiede/hookaido","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":50,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers. Use when tasks involve Hookaidofile authoring, `hookaido` C"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"MCP","label":"MCP","status":"self-declared","notes":"Declared in the public agent profile."},{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":2,"capabilityMatrix":{"rows":[{"key":"MCP","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:MCP|unknown|profile protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No source adoption metrics were available."},"stars":null,"forks":null,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-25T05:53:42.727Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-25T05:53:42.727Z","lastIndexedAt":null,"nextCrawlAt":"2026-02-26T05:53:42.727Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install skills:7schmiede:hookaido","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["MCP","OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T22:52:07.116Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-skills-7schmiede-hookaido/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"---\nname: hookaido\ndescription: Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers. Use when tasks involve Hookaidofile authoring, `hookaido` CLI commands (`run`, `config fmt`, `config validate`, `mcp serve`), pull operations (`dequeue`/`ack`/`nack`/`extend`) over HTTP or gRPC, Admin API backlog/DLQ handling, or production hardening for webhook/webhooks ingress and delivery.\nmetadata: {\"openclaw\":{\"homepage\":\"https://github.com/nuetzliches/hookaido\",\"requires\":{\"bins\":[\"hookaido\"]},\"install\":[{\"id\":\"download-darwin-amd64\",\"kind\":\"download\",\"os\":[\"darwin\"],\"url\":\"https://github.com/nuetzliches/hookaido/releases/download/v1.5.0/hookaido_v1.5.0_darwin_amd64.tar.gz\",\"archive\":\"tar.gz\",\"extract\":true,\"stripComponents\":1,\"targetDir\":\"~/.local/bin\",\"bins\":[\"hookaido\"],\"label\":\"Download hookaido v1.5.0 (macOS amd64)\"},{\"id\":\"download-darwin-arm64\",\"kind\":\"download\",\"os\":[\"darwin\"],\"url\":\"https://github.com/nuetzliches/hookaido/releases/download/v1.5.0/hookaido_v1.5.0_darwin_arm64.tar.gz\",\"archive\":\"tar.gz\",\"extract\":true,\"stripComponents\":1,\"targetDir\":\"~/.local/bin\",\"bins\":[\"hookaido\"],\"label\":\"Download hookaido v1.5.0 (macOS arm64)\"},{\"id\":\"download-linux-amd64\",\"kind\":\"download\",\"os\":[\"linux\"],\"url\":\"https://github.com/nuetzliches/hookaido/releases/download/v1.5.0/hookaido_v1.5.0_linux_amd64.tar.gz\",\"archive\":\"tar.gz\",\"extract\":true,\"stripComponents\":1,\"targetDir\":\"~/.local/bin\",\"bins\":[\"hookaido\"],\"label\":\"Download hookaido v1.5.0 (Linux amd64)\"},{\"id\":\"download-linux-arm64\",\"kind\":\"download\",\"os\":[\"linux\"],\"url\":\"https://github.com/nuetzliches/hookaido/releases/download/v1.5.0/hookaido_v1.5.0_linux_arm64.tar.gz\",\"archive\":\"tar.gz\",\"extract\":true,\"stripComponents\":1,\"targetDir\":\"~/.local/bin\",\"bins\":[\"hookaido\"],\"label\":\"Download hookaido v1.5.0 (Linux arm64)\"},{\"id\":\"download-windows-amd64\",\"kind\":\"download\",\"os\":[\"win32\"],\"url\":\"https://github.com/nuetzliches/hookaido/releases/download/v1.5.0/hookaido_v1.5.0_windows_amd64.zip\",\"archive\":\"zip\",\"extract\":true,\"targetDir\":\"~/.openclaw/tools/hookaido\",\"bins\":[\"hookaido\"],\"label\":\"Download hookaido v1.5.0 (Windows amd64)\"},{\"id\":\"download-windows-arm64\",\"kind\":\"download\",\"os\":[\"win32\"],\"url\":\"https://github.com/nuetzliches/hookaido/releases/download/v1.5.0/hookaido_v1.5.0_windows_arm64.zip\",\"archive\":\"zip\",\"extract\":true,\"targetDir\":\"~/.openclaw/tools/hookaido\",\"bins\":[\"hookaido\"],\"label\":\"Download hookaido v1.5.0 (Windows arm64)\"}]}}\n---\n\n# Hookaido\n\n## Overview\n\nImplement and troubleshoot Hookaido with a config-first workflow: edit `Hookaidofile`, validate, run, exercise ingress/pull flows, then diagnose queue health and DLQ behavior.\nUse conservative, reversible changes and validate before runtime operations.\n\n## Workflow\n\n1. Confirm target topology: inbound+pull (HTTP or gRPC), push outbound, or internal queue.\n2. Choose runtime mode and ensure `hookaido` exists where tools execute.\n   - Host-binary mode: use the install action from `metadata.openclaw.install`.\n   - Host fallback: run `bash {baseDir}/scripts/install_hookaido.sh` (pinned `v1.5.0`, SHA256-verified).\n   - Docker-sandbox mode: use a sandbox image that already includes `hookaido` (preferred), or install inside sandbox via `agents.defaults.sandbox.docker.setupCommand`.\n   - Keep host install actions available as fallback and to satisfy `metadata.openclaw.requires.bins`.\n3. Inspect and update `Hookaidofile` minimally.\n4. Run format and validation before starting or reloading:\n   - `hookaido config fmt --config ./Hookaidofile`\n   - `hookaido config validate --config ./Hookaidofile`\n5. Start runtime and verify health:\n   - `hookaido run --config ./Hookaidofile --db ./.data/hookaido.db`\n   - `curl http://127.0.0.1:2019/healthz?details=1`\n6. Validate end-to-end behavior:\n   - ingress request accepted and queued\n   - consumer `dequeue`/`ack`/`nack`/`extend` path works (HTTP pull, plus gRPC pull when enabled)\n7. For incidents, inspect backlog and DLQ first, then mutate.\n\n## Task Playbooks\n\n### Configure Ingress and Pull Consumption\n\n1. Define a route with explicit auth and pull path (HTTP pull, optional gRPC pull worker listener).\n2. Keep secrets in env/file refs, never inline.\n3. Verify route and global pull auth are consistent.\n4. Test with a real webhook payload and a dequeue/ack cycle.\n\nPrefer this baseline:\n\n```hcl\ningress {\n  listen :8080\n}\n\npull_api {\n  listen :9443\n  grpc_listen :9943 # optional gRPC pull-worker listener\n  auth token env:HOOKAIDO_PULL_TOKEN\n}\n\n/webhooks/github {\n  auth hmac env:HOOKAIDO_INGRESS_SECRET\n  pull { path /pull/github }\n}\n```\n\n### Configure Push Delivery\n\n1. Use push delivery only when inbound connectivity to the service is acceptable.\n2. Set timeout and retry policy explicitly.\n3. Validate downstream idempotency since delivery is at-least-once.\n\n```hcl\n/webhooks/stripe {\n  auth hmac env:STRIPE_SIGNING_SECRET\n  deliver \"https://billing.internal/stripe\" {\n    retry exponential max 8 base 2s cap 2m jitter 0.2\n    timeout 10s\n  }\n}\n```\n\n### Operate Queue and DLQ\n\n1. Start with health details and backlog endpoints.\n2. Inspect DLQ before requeue or delete.\n3. If requeueing many items, explain expected impact and rollback path.\n4. Require clear operator reason strings for mutating admin calls.\n\nUse:\n\n- `GET /healthz?details=1`\n- `GET /backlog/trends`\n- `GET /dlq`\n- `POST /dlq/requeue`\n- `POST /dlq/delete`\n\n### Use MCP Mode for AI Operations\n\n1. Default to `--role read` for diagnostics.\n2. Enable mutations only with explicit operator intent:\n   - `--enable-mutations --role operate --principal <identity>`\n3. Enable runtime control only for admin workflows:\n   - `--enable-runtime-control --role admin --pid-file <path>`\n4. Include `reason` for mutation calls and keep it specific.\n\n## Validation Checklist\n\n- `hookaido config validate` returns success before runtime start/reload.\n- Health endpoint is reachable and reports expected queue/backend state.\n- Pull consumer can `dequeue`, `ack`, `nack`, and `extend` with valid token (HTTP and optional gRPC transport).\n- For push mode, retry/timeout behavior is explicitly configured.\n- Any DLQ mutation is scoped, justified, and logged.\n\n## Safety Rules\n\n- Do not disable auth to \"make tests pass.\"\n- Do not suggest direct mutations before read-only diagnostics.\n- Treat queue operations as at-least-once; require idempotent handlers.\n- Keep secrets in `env:` or `file:` refs.\n\n## References\n\n- Read `references/operations.md` for command snippets and API payload templates.\n","readmeExcerpt":"--- name: hookaido description: Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers. Use when tasks involve Hookaidofile authoring, hookaido CLI commands (run, config fmt, config validate, mcp serve), pull operations (dequeue/ack/nack/extend) over HTTP or gRPC, Admin API backlog/DLQ handling, or production hardening for webhook/webhooks ingress and delivery. metadata: {","codeSnippets":[],"executableExamples":[{"language":"hcl","snippet":"ingress {\n  listen :8080\n}\n\npull_api {\n  listen :9443\n  grpc_listen :9943 # optional gRPC pull-worker listener\n  auth token env:HOOKAIDO_PULL_TOKEN\n}\n\n/webhooks/github {\n  auth hmac env:HOOKAIDO_INGRESS_SECRET\n  pull { path /pull/github }\n}"},{"language":"hcl","snippet":"/webhooks/stripe {\n  auth hmac env:STRIPE_SIGNING_SECRET\n  deliver \"https://billing.internal/stripe\" {\n    retry exponential max 8 base 2s cap 2m jitter 0.2\n    timeout 10s\n  }\n}"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"CLAWHUB","editorialOverview":"Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers. Use when tasks involve Hookaidofile authoring, `hookaido` CLI commands (`run`, `config fmt`, `config validate`, `mcp serve`), pull operations (`dequeue`/`ack`/`nack`/`extend`) over HTTP or gRPC, Admin API backlog/DLQ handling, or production hardening for webhook/webhooks ingress and delivery. --- name: hookaido description: Operate Hookaido inbound/outbound webhook flows, queue triage, MCP workflows, and gRPC-pull workers. Use when tasks involve Hookaidofile authoring, hookaido CLI commands (run, config fmt, config validate, mcp serve), pull operations (dequeue/ack/nack/extend) over HTTP or gRPC, Admin API backlog/DLQ handling, or production hardening for webhook/webhooks ingress and delivery. metadata: {","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":407,"uniquenessScore":63,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T22:52:07.116Z","emptyReason":null},"items":[{"id":"91842505-d59e-48ad-ae35-d504a6e8eadb","entityType":"agent","canonicalPath":"/agent/ard-urn-air-com-brainiall-mcp-nlp","slug":"ard-urn-air-com-brainiall-mcp-nlp","name":"Brainiall NLP","description":"Sentiment, toxicity, entity extraction, PII, translation, summary, QA, fraud scoring, safety audit.","url":"https://api.brainiall.com/mcp/nlp/mcp","homepage":"https://api.brainiall.com/mcp/nlp/mcp","source":"ARD_REGISTRY","protocols":["MCP"],"capabilities":["mcp","mcp-registry"],"safetyScore":95,"overallRank":93.5,"updatedAt":"2026-10-09T19:59:36.369Z","createdAt":"2026-10-09T02:32:12.319Z","downloads":null},{"id":"c07bfd45-37e3-4ca4-bce7-0f2c138264a2","entityType":"agent","canonicalPath":"/agent/ard-urn-air-ai-revuo-mcp-revuo","slug":"ard-urn-air-ai-revuo-mcp-revuo","name":"Revuo","description":"Agent-callable B2B SaaS directory: capability-structured, continuously verified listings.","url":"https://www.revuo.ai/api/mcp","homepage":"https://www.revuo.ai/api/mcp","source":"ARD_REGISTRY","protocols":["MCP"],"capabilities":["mcp","mcp-registry"],"safetyScore":95,"overallRank":93.5,"updatedAt":"2026-10-09T19:04:52.902Z","createdAt":"2026-10-09T02:32:15.408Z","downloads":null},{"id":"b72e3032-816c-4f68-bcc9-1a847aef4d79","entityType":"agent","canonicalPath":"/agent/ard-urn-air-ai-bankee-mcp-inferventis-mcp","slug":"ard-urn-air-ai-bankee-mcp-inferventis-mcp","name":"Inferventis MCP Server","description":"Loan & mortgage calculator, compound interest, ROI, crypto prices, FX conversion for AI agents.","url":"https://mcp-server-295985738387.europe-west1.run.app/mcp","homepage":"https://mcp-server-295985738387.europe-west1.run.app/mcp","source":"ARD_REGISTRY","protocols":["MCP"],"capabilities":["mcp","mcp-registry"],"safetyScore":95,"overallRank":93.5,"updatedAt":"2026-10-09T18:09:37.547Z","createdAt":"2026-10-09T02:32:16.798Z","downloads":null},{"id":"a785e560-2661-4edd-a374-5e8de7c54e7a","entityType":"agent","canonicalPath":"/agent/ard-urn-air-io-github-cleandev-fix-mcp-shortlistlens","slug":"ard-urn-air-io-github-cleandev-fix-mcp-shortlistlens","name":"ShortlistLens","description":"Structured website and review evidence for AI-assisted local-business shortlisting.","url":"https://shortlistlens-mcp.streaming22box.workers.dev/mcp","homepage":"https://shortlistlens-mcp.streaming22box.workers.dev/mcp","source":"ARD_REGISTRY","protocols":["MCP"],"capabilities":["mcp","mcp-registry"],"safetyScore":95,"overallRank":93.5,"updatedAt":"2026-10-09T18:04:03.143Z","createdAt":"2026-10-09T02:32:13.915Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"MCP","href":"/agent/protocol/mcp"},{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}