3 people 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 <[email protected]>
Co-authored-by: Gustavo Madeira Santana <[email protected]>

2026-02-10 19:23:58 -05:00

..

sessions

fix: unify session maintenance and cron run pruning (#13083)

2026-02-09 20:42:35 -08:00

agent-dirs.test.ts

fix(paths): respect OPENCLAW_HOME for all internal path resolution (#12091)

2026-02-08 16:20:13 -05:00

agent-dirs.ts

fix(paths): respect OPENCLAW_HOME for all internal path resolution (#12091)

2026-02-08 16:20:13 -05:00

agent-limits.ts

…

cache-utils.ts

…

channel-capabilities.test.ts

…

channel-capabilities.ts

…

commands.test.ts

…

commands.ts

…

config-paths.test.ts

…

config-paths.ts

refactor: centralize isPlainObject, isRecord, isErrno, isLoopbackHost utilities (#12926)

2026-02-09 17:02:55 -08:00

config.agent-concurrency-defaults.test.ts

…

config.backup-rotation.test.ts

…

config.broadcast.test.ts

…

config.compaction-settings.test.ts

…

config.discord.test.ts

…

config.env-vars.test.ts

(fix): .env vars not available during runtime config reloads (healthchecks fail with MissingEnvVarError) (#12748)

2026-02-09 16:31:41 -06:00

config.gateway-remote-transport.test.ts

…

config.identity-avatar.test.ts

…

config.identity-defaults.test.ts

…

config.irc.test.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

config.legacy-config-detection.accepts-imessage-dmpolicy.test.ts

Config: migrate legacy top-level memorySearch

2026-02-10 00:21:27 -08:00

config.legacy-config-detection.rejects-routing-allowfrom.test.ts

Config: clarify memorySearch migration precedence

2026-02-10 00:21:27 -08:00

config.msteams.test.ts

…

config.multi-agent-agentdir-validation.test.ts

…

config.nix-integration-u3-u5-u9.test.ts

test: normalize paths in OPENCLAW_HOME tests for cross-platform support (#12212)

2026-02-08 17:21:31 -08:00

config.plugin-validation.test.ts

…

config.preservation-on-validation-failure.test.ts

…

config.pruning-defaults.test.ts

…

config.sandbox-docker.test.ts

…

config.skills-entries-config.test.ts

…

config.talk-api-key-fallback.test.ts

…

config.talk-voicealiases.test.ts

…

config.telegram-custom-commands.test.ts

…

config.tools-alsoAllow.test.ts

…

config.ts

…

config.web-search-provider.test.ts

…

defaults.ts

test(config): cover maxTokens clamping

2026-02-08 14:24:57 -08:00

env-substitution.test.ts

…

env-substitution.ts

refactor: centralize isPlainObject, isRecord, isErrno, isLoopbackHost utilities (#12926)

2026-02-09 17:02:55 -08:00

env-vars.ts

…

group-policy.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

includes.test.ts

…

includes.ts

refactor: centralize isPlainObject, isRecord, isErrno, isLoopbackHost utilities (#12926)

2026-02-09 17:02:55 -08:00

io.compat.test.ts

fix(paths): respect OPENCLAW_HOME for all internal path resolution (#12091)

2026-02-08 16:20:13 -05:00

io.ts

(fix): .env vars not available during runtime config reloads (healthchecks fail with MissingEnvVarError) (#12748)

2026-02-09 16:31:41 -06:00

legacy-migrate.ts

…

legacy.migrations.part-1.ts

…

legacy.migrations.part-2.ts

…

legacy.migrations.part-3.ts

Config: clarify memorySearch migration precedence

2026-02-10 00:21:27 -08:00

legacy.migrations.ts

…

legacy.rules.ts

Config: migrate legacy top-level memorySearch

2026-02-10 00:21:27 -08:00

legacy.shared.ts

refactor: centralize isPlainObject, isRecord, isErrno, isLoopbackHost utilities (#12926)

2026-02-09 17:02:55 -08:00

legacy.ts

…

logging.ts

…

markdown-tables.ts

…

merge-config.ts

…

merge-patch.ts

refactor: centralize isPlainObject, isRecord, isErrno, isLoopbackHost utilities (#12926)

2026-02-09 17:02:55 -08:00

model-alias-defaults.test.ts

test(config): cover maxTokens clamping

2026-02-08 14:24:57 -08:00

normalize-paths.test.ts

…

normalize-paths.ts

refactor: centralize isPlainObject, isRecord, isErrno, isLoopbackHost utilities (#12926)

2026-02-09 17:02:55 -08:00

paths.test.ts

fix(paths): structurally resolve home dir to prevent Windows path bugs (#12125)

2026-02-08 20:06:29 -05:00

paths.ts

fix(paths): respect OPENCLAW_HOME for all internal path resolution (#12091)

2026-02-08 16:20:13 -05:00

plugin-auto-enable.test.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

plugin-auto-enable.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

port-defaults.ts

…

redact-snapshot.test.ts

security: redact credentials from config.get gateway responses (#9858)

2026-02-05 16:34:48 -08:00

redact-snapshot.ts

security: redact credentials from config.get gateway responses (#9858)

2026-02-05 16:34:48 -08:00

runtime-overrides.test.ts

…

runtime-overrides.ts

refactor: centralize isPlainObject, isRecord, isErrno, isLoopbackHost utilities (#12926)

2026-02-09 17:02:55 -08:00

schema.field-metadata.ts

refactor(security,config): split oversized files (#13182)

2026-02-09 22:22:29 -08:00

schema.hints.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

schema.irc.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

schema.test.ts

…

schema.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

sessions.cache.test.ts

…

sessions.test.ts

fix: unify session maintenance and cron run pruning (#13083)

2026-02-09 20:42:35 -08:00

sessions.ts

…

slack-http-config.test.ts

…

slack-token-validation.test.ts

…

talk.ts

…

telegram-custom-commands.ts

…

telegram-webhook-secret.test.ts

…

test-helpers.ts

…

types.agent-defaults.ts

fix(ollama): add streaming config and fix OLLAMA_API_KEY env var support (#9870)

2026-02-05 16:35:38 -08:00

types.agents.ts

refactor: unify peer kind to ChatType, rename dm to direct (#11881)

2026-02-09 09:20:52 +09:00

types.approvals.ts

…

types.auth.ts

…

types.base.ts

fix: unify session maintenance and cron run pruning (#13083)

2026-02-09 20:42:35 -08:00

types.browser.ts

…

types.channels.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

types.cron.ts

fix: unify session maintenance and cron run pruning (#13083)

2026-02-09 20:42:35 -08:00

types.discord.ts

Discord: add exec approval cleanup option (#13205)

2026-02-10 00:39:42 -06:00

types.gateway.ts

fix: harden control ui framing + ws origin

2026-02-03 16:00:57 -08:00

types.googlechat.ts

feat: per-channel responsePrefix override (#9001)

2026-02-04 16:16:34 -05:00

types.hooks.ts

feat(hooks): add agentId support to webhook mappings (#13672)

2026-02-10 19:23:58 -05:00

types.imessage.ts

feat: per-channel responsePrefix override (#9001)

2026-02-04 16:16:34 -05:00

types.irc.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

types.memory.ts

Memory: harden QMD startup, timeouts, and fallback recovery

2026-02-07 17:55:34 -08:00

types.messages.ts

Commands: add commands.allowFrom config

2026-02-09 23:58:52 -06:00

types.models.ts

…

types.msteams.ts

feat: per-channel responsePrefix override (#9001)

2026-02-04 16:16:34 -05:00

types.node-host.ts

…

types.openclaw.ts

…

types.plugins.ts

…

types.queue.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

types.sandbox.ts

…

types.signal.ts

feat: per-channel responsePrefix override (#9001)

2026-02-04 16:16:34 -05:00

types.skills.ts

…

types.slack.ts

feat: per-channel responsePrefix override (#9001)

2026-02-04 16:16:34 -05:00

types.telegram.ts

fix(telegram): accept messages from group members in allowlisted groups (#9775)

2026-02-05 14:45:45 -08:00

types.tools.ts

feat(tools): add Grok (xAI) as web_search provider

2026-02-09 07:11:33 +00:00

types.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

types.tts.ts

…

types.whatsapp.ts

feat: per-channel responsePrefix override (#9001)

2026-02-04 16:16:34 -05:00

ui-seam-color.test.ts

…

validation.ts

refactor: centralize isPlainObject, isRecord, isErrno, isLoopbackHost utilities (#12926)

2026-02-09 17:02:55 -08:00

version.ts

…

zod-schema.agent-defaults.ts

fix(ollama): add streaming config and fix OLLAMA_API_KEY env var support (#9870)

2026-02-05 16:35:38 -08:00

zod-schema.agent-runtime.ts

feat(tools): add Grok (xAI) as web_search provider

2026-02-09 07:11:33 +00:00

zod-schema.agents.ts

refactor: unify peer kind to ChatType, rename dm to direct (#11881)

2026-02-09 09:20:52 +09:00

zod-schema.approvals.ts

…

zod-schema.channels.ts

…

zod-schema.core.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

zod-schema.hooks.ts

feat(hooks): add agentId support to webhook mappings (#13672)

2026-02-10 19:23:58 -05:00

zod-schema.providers-core.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

zod-schema.providers-whatsapp.ts

feat: per-channel responsePrefix override (#9001)

2026-02-04 16:16:34 -05:00

zod-schema.providers.ts

feat: IRC — add first-class channel support

2026-02-10 17:33:57 -06:00

zod-schema.session.ts

Commands: add commands.allowFrom config

2026-02-09 23:58:52 -06:00

zod-schema.ts

feat(hooks): add agentId support to webhook mappings (#13672)

2026-02-10 19:23:58 -05:00