github/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-04-19 07:37:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix: prioritize explicit hook mappings

Browse Source
This commit is contained in:
Peter Steinberger
2026-01-03 02:32:37 +01:00
parent 25cc12e590
commit 7dcedca323
4 changed files with 4 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
CHANGELOG.md
View File

@@ -7,6 +7,7 @@
- Agent runtime: update pi-mono dependencies to 0.31.1 (agent-core split). - Agent runtime: update pi-mono dependencies to 0.31.1 (agent-core split).
- Dependencies: bump to latest compatible versions (TypeBox, grammY, Zod, Rolldown, oxlint-tsgolint). - Dependencies: bump to latest compatible versions (TypeBox, grammY, Zod, Rolldown, oxlint-tsgolint).
- Tests: cover read tool image metadata + text output. - Tests: cover read tool image metadata + text output.
- Hooks: treat null transforms as handled skips (204) and let explicit mappings override presets (#117) — thanks @jverdi.
### Breaking ### Breaking
- Skills config schema moved under `skills.*`: - Skills config schema moved under `skills.*`:

1
docs/configuration.md
View File

@@ -701,6 +701,7 @@ Endpoints:
Mapping notes: Mapping notes:
- `match.path` matches the sub-path after `/hooks` (e.g. `/hooks/gmail` → `gmail`). - `match.path` matches the sub-path after `/hooks` (e.g. `/hooks/gmail` → `gmail`).
- `match.source` matches a payload field (e.g. `{ source: "gmail" }`) so you can use a generic `/hooks/ingest` path. - `match.source` matches a payload field (e.g. `{ source: "gmail" }`) so you can use a generic `/hooks/ingest` path.
- `hooks.mappings` are evaluated before presets; first match wins.
- Templates like `{{messages[0].subject}}` read from the payload. - Templates like `{{messages[0].subject}}` read from the payload.
- `transform` can point to a JS/TS module that returns a hook action. - `transform` can point to a JS/TS module that returns a hook action.

1
docs/webhook.md
View File

@@ -89,6 +89,7 @@ code transforms.
Mapping options (summary): Mapping options (summary):
- `hooks.presets: ["gmail"]` enables the built-in Gmail mapping. - `hooks.presets: ["gmail"]` enables the built-in Gmail mapping.
- `hooks.mappings` lets you define `match`, `action`, and templates in config. - `hooks.mappings` lets you define `match`, `action`, and templates in config.
- `hooks.mappings` are evaluated before presets; first match wins.
- `hooks.transformsDir` + `transform.module` loads a JS/TS module for custom logic. - `hooks.transformsDir` + `transform.module` loads a JS/TS module for custom logic.
- Use `match.source` to keep a generic ingest endpoint (payload-driven routing). - Use `match.source` to keep a generic ingest endpoint (payload-driven routing).
- TS transforms require a TS loader (e.g. `tsx`) or precompiled `.js` at runtime. - TS transforms require a TS loader (e.g. `tsx`) or precompiled `.js` at runtime.

2
src/gateway/hooks-mapping.ts
View File

@@ -114,11 +114,11 @@ export function resolveHookMappings(
): HookMappingResolved[] { ): HookMappingResolved[] {
const presets = hooks?.presets ?? []; const presets = hooks?.presets ?? [];
const mappings: HookMappingConfig[] = []; const mappings: HookMappingConfig[] = [];
if (hooks?.mappings) mappings.push(...hooks.mappings);
for (const preset of presets) { for (const preset of presets) {
const presetMappings = hookPresetMappings[preset]; const presetMappings = hookPresetMappings[preset];
if (presetMappings) mappings.push(...presetMappings); if (presetMappings) mappings.push(...presetMappings);
} }
if (hooks?.mappings) mappings.push(...hooks.mappings);
if (mappings.length === 0) return []; if (mappings.length === 0) return [];
const configDir = path.dirname(CONFIG_PATH_CLAWDIS); const configDir = path.dirname(CONFIG_PATH_CLAWDIS);