You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gpt-pilot/docs
Bill Chirico ca629296c6
feat(hooks): add agentId support to webhook mappings (#13672)
* feat(hooks): add agentId support to webhook mappings

Allow webhook mappings to route hook runs to a specific agent via
the new `agentId` field. This enables lightweight agents with minimal
bootstrap files to handle webhooks, reducing token cost per hook run.

The agentId is threaded through:
- HookMappingConfig (config type + zod schema)
- HookMappingResolved + HookAction (mapping types)
- normalizeHookMapping + buildActionFromMapping (mapping logic)
- mergeAction (transform override support)
- HookAgentPayload + normalizeAgentPayload (direct /hooks/agent endpoint)
- dispatchAgentHook → CronJob.agentId (server dispatch)

The existing runCronIsolatedAgentTurn already supports agentId on
CronJob — this change simply wires it through from webhook mappings.

Usage in config:
  hooks.mappings[].agentId = "my-agent"

Usage via POST /hooks/agent:
  { "message": "...", "agentId": "my-agent" }

Includes tests for mapping passthrough and payload normalization.
Includes doc updates for webhook.md.

* fix(hooks): enforce webhook agent routing policy + docs/changelog updates (#13672) (thanks @BillChirico)

* fix(hooks): harden explicit agent allowlist semantics (#13672) (thanks @BillChirico)

---------

Co-authored-by: Pip <pip@openclaw.ai>
Co-authored-by: Gustavo Madeira Santana <gumadeiras@gmail.com>
9 months ago
..
.i18n Docs: seed ja-JP translations 10 months ago
assets docs(onboarding): add bootstrapping page (#9767) 10 months ago
automation feat(hooks): add agentId support to webhook mappings (#13672) 9 months ago
channels feat: IRC — add first-class channel support 9 months ago
cli Onboard: rename Custom API Endpoint to Custom Provider 10 months ago
concepts docs: clarify which workspace files are injected into context window (#12937) 9 months ago
debug Docs: enable markdownlint autofixables except list numbering (#10476) 10 months ago
diagnostics Docs: add nav titles across docs (#5689) 10 months ago
experiments fix: prevent act:evaluate hangs from getting browser tool stuck/killed (#13498) 9 months ago
gateway feat(hooks): add agentId support to webhook mappings (#13672) 9 months ago
help refactor: unify peer kind to ChatType, rename dm to direct (#11881) 10 months ago
hooks docs: canonicalize docs paths and align zh navigation (#11428) 10 months ago
images Channels: finish Feishu/Lark integration 10 months ago
install feat: `ClawDock` - shell docker helpers for OpenClaw development (#12817) 9 months ago
ja-JP docs: fix ja-JP dashboard URL link 10 months ago
nodes docs: add symptom-first troubleshooting hub and deep runbooks (#11196) 10 months ago
platforms chore(release): 2026.2.9 10 months ago
plugins docs: canonicalize docs paths and align zh navigation (#11428) 10 months ago
providers Update Together default model to together/moonshotai/Kimi-K2.5 (#13324) 9 months ago
refactor refactor: unify peer kind to ChatType, rename dm to direct (#11881) 10 months ago
reference Docs: restore maintainers in contributing 9 months ago
security Centralize date/time formatting utilities (#11831) 10 months ago
start Onboard: rename Custom API Endpoint to Custom Provider 10 months ago
tools Commands: add commands.allowFrom config 10 months ago
web docs: canonicalize docs paths and align zh navigation (#11428) 10 months ago
zh-CN docs: fix broken links checker and add CI docs (#13041) 10 months ago
CNAME refactor: rename to openclaw 10 months ago
brave-search.md Docs: enable markdownlint autofixables except list numbering (#10476) 10 months ago
ci.md docs: fix broken links checker and add CI docs (#13041) 10 months ago
date-time.md Docs: add nav titles across docs (#5689) 10 months ago
docs.json feat: IRC — add first-class channel support 9 months ago
index.md Docs: enable markdownlint autofixables except list numbering (#10476) 10 months ago
logging.md Docs: add nav titles across docs (#5689) 10 months ago
network.md docs: canonicalize docs paths and align zh navigation (#11428) 10 months ago
perplexity.md Docs: enable markdownlint autofixables except list numbering (#10476) 10 months ago
pi-dev.md Docs: enable markdownlint autofixables except list numbering (#10476) 10 months ago
pi.md fix: align pi-coding-agent typings and docs 10 months ago
prose.md docs: canonicalize docs paths and align zh navigation (#11428) 10 months ago
style.css Docs: streamline start and install docs (#9648) 10 months ago
tts.md Docs: add nav titles across docs (#5689) 10 months ago
vps.md Docs: enable markdownlint autofixables except list numbering (#10476) 10 months ago
whatsapp-openclaw-ai-zh.jpg Docs: add zh-CN landing notice + AI image 10 months ago
whatsapp-openclaw.jpg refactor: rename to openclaw 10 months ago