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>

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

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

cache-utils.ts

fix: persist topic session files

2026-01-07 22:56:50 +00:00

channel-capabilities.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

channel-capabilities.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

commands.test.ts

feat: expand skill command registration

2026-01-16 20:17:32 +00:00

commands.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

config-paths.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

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

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

config.backup-rotation.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

config.broadcast.test.ts

refactor(src): split oversized modules

2026-01-14 01:17:56 +00:00

config.compaction-settings.test.ts

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

config.discord.test.ts

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

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

feat(macos): add direct gateway transport

2026-01-24 21:02:13 +00:00

config.identity-avatar.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

config.identity-defaults.test.ts

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

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

chore: migrate to oxlint and oxfmt

2026-01-14 15:02:19 +00:00

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

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

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

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

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

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

config.pruning-defaults.test.ts

fix(agents): update cacheControlTtl to cacheRetention for pi-ai 0.50.9

2026-02-01 09:50:52 +01:00

config.sandbox-docker.test.ts

style: oxfmt fixes (#925) (thanks @grp06)

2026-01-15 03:22:54 +00:00

config.skills-entries-config.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

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

refactor(src): split oversized modules

2026-01-14 01:17:56 +00:00

config.talk-voicealiases.test.ts

refactor(src): split oversized modules

2026-01-14 01:17:56 +00:00

config.telegram-custom-commands.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

config.tools-alsoAllow.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

config.ts

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

config.web-search-provider.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

defaults.ts

test(config): cover maxTokens clamping

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

env-substitution.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

env-substitution.ts

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

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

env-vars.ts

chore: Enable "curly" rule to avoid single-statement if confusion/errors.

2026-01-31 16:19:20 +09:00

group-policy.ts

feat: IRC — add first-class channel support

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

includes.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

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

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

legacy.migrations.part-1.ts

chore: Enable "curly" rule to avoid single-statement if confusion/errors.

2026-01-31 16:19:20 +09:00

legacy.migrations.part-2.ts

chore: Enable "curly" rule to avoid single-statement if confusion/errors.

2026-01-31 16:19:20 +09:00

legacy.migrations.part-3.ts

Config: clarify memorySearch migration precedence

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

legacy.migrations.ts

refactor(config): split legacy handling

2026-01-14 05:39:51 +00:00

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

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

logging.ts

refactor: rename clawdbot to moltbot with legacy compat

2026-01-27 12:21:02 +00:00

markdown-tables.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

merge-config.ts

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

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

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

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

chore: Enable "curly" rule to avoid single-statement if confusion/errors.

2026-01-31 16:19:20 +09:00

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

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

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

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

schema.ts

feat: IRC — add first-class channel support

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

sessions.cache.test.ts

chore: Enable more lint rules, disable some that trigger a lot. Will clean up later.

2026-01-31 16:04:04 +09:00

sessions.test.ts

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

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

sessions.ts

feat(session): add daily reset policy

2026-01-18 06:37:37 +00:00

slack-http-config.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

slack-token-validation.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

talk.ts

chore: Enable "curly" rule to avoid single-statement if confusion/errors.

2026-01-31 16:19:20 +09:00

telegram-custom-commands.ts

chore: Enable "curly" rule to avoid single-statement if confusion/errors.

2026-01-31 16:19:20 +09:00

telegram-webhook-secret.test.ts

fix(ci): repair lint/build checks

2026-02-01 10:20:27 +00:00

test-helpers.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

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

feat(discord): add exec approval forwarding to DMs (#1621)

2026-01-24 20:56:40 +00:00

types.auth.ts

refactor(src): split oversized modules

2026-01-14 01:17:56 +00:00

types.base.ts

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

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

types.browser.ts

refactor: rename to openclaw

2026-01-30 03:16:21 +01:00

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

fix: refine bedrock discovery defaults (#1543) (thanks @fal3)

2026-01-24 01:18:33 +00:00

types.msteams.ts

feat: per-channel responsePrefix override (#9001)

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

types.node-host.ts

feat: add node browser proxy routing

2026-01-24 04:21:47 +00:00

types.openclaw.ts

chore: apply formatter

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

types.plugins.ts

feat(plugins): add memory slot plugin

2026-01-18 02:12:10 +00:00

types.queue.ts

feat: IRC — add first-class channel support

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

types.sandbox.ts

refactor: route browser control via gateway/node

2026-01-27 03:24:54 +00:00

types.signal.ts

feat: per-channel responsePrefix override (#9001)

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

types.skills.ts

fix: allow custom skill config bag

2026-01-20 15:57:08 +00:00

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

TTS: gate auto audio on inbound voice notes (#1667)

2026-01-25 04:35:20 +00:00

types.whatsapp.ts

feat: per-channel responsePrefix override (#9001)

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

ui-seam-color.test.ts

chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts.

2026-02-01 10:03:47 +09:00

validation.ts

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

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

version.ts

chore: Enable "curly" rule to avoid single-statement if confusion/errors.

2026-01-31 16:19:20 +09:00

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

feat(discord): add exec approval forwarding to DMs (#1621)

2026-01-24 20:56:40 +00:00

zod-schema.channels.ts

feat(heartbeat): add configurable visibility for heartbeat responses

2026-01-24 09:07:03 +00:00

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