openclaw/docs
Steven Gonsalvez 42c647f2c9
feat(hooks): add config-driven message handlers for immediate agent triggering
Add `hooks.internal.messageHandlers` config array for triggering agent
execution when inbound messages match specified conditions. This solves
the problem of important messages (like bug reports) being queued and
potentially missed when cron jobs wake the agent.

Features:
- Match conditions: channelId, conversationId, from, contentPattern (regex),
  contentContains (keywords)
- Priority modes: "immediate" (bypass queue) or "queue" (normal flow)
- Execution modes: "exclusive" (handler only) or "parallel" (handler + normal)
- Message transformation: prefix, suffix, or full template with placeholders
- Configurable model and thinking level per handler

Implementation:
- src/config/types.hooks.ts: MessageHandlerConfig and MessageHandlerMatch types
- src/config/zod-schema.hooks.ts: Zod validation schemas
- src/hooks/message-handler-match.ts: Condition matching logic
- src/hooks/message-handler-run.ts: Handler executor using runCronIsolatedAgentTurn
- src/auto-reply/reply/dispatch-from-config.ts: Integration point
- docs/hooks.md: Full documentation with examples
- 28 unit tests for matcher logic
2026-01-28 20:51:06 +00:00
..
_layouts refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
assets refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
automation refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
channels refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
cli fix: wire per-account dm scope guidance (#3095) (thanks @jarvis-sam) 2026-01-28 11:42:33 +05:30
concepts fix: wire per-account dm scope guidance (#3095) (thanks @jarvis-sam) 2026-01-28 11:42:33 +05:30
debug update refs 2026-01-27 13:50:46 -08:00
diagnostics refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
experiments refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
gateway fix: wire per-account dm scope guidance (#3095) (thanks @jarvis-sam) 2026-01-28 11:42:33 +05:30
help docs: switch skill metadata key to moltbot 2026-01-28 01:32:53 +01:00
hooks refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
images docs: add group flow diagram 2026-01-10 20:05:22 +01:00
install update refs 2026-01-27 13:50:46 -08:00
nodes refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
platforms fix: update exe.dev install docs (#https://github.com/moltbot/moltbot/pull/3047) (thanks @zackerthescar) 2026-01-27 18:54:46 -06:00
plugins refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
providers Update Moonshot Kimi model references from kimi-k2-0905-preview to the latest kimi-k2.5 2026-01-27 21:10:59 -06:00
refactor refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
reference chore: bump beta version to 2026.1.27-beta.1 2026-01-28 01:28:16 +01:00
security docs: clarify v1++ claims (not just target lists) 2026-01-27 15:35:24 -08:00
start update refs 2026-01-27 13:50:46 -08:00
tools docs: switch skill metadata key to moltbot 2026-01-28 01:32:53 +01:00
web refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
_config.yml refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
bedrock.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
brave-search.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
broadcast-groups.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
CNAME chore: update molt.bot domains 2026-01-27 12:21:01 +00:00
date-time.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
debugging.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
docs.json refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
environment.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
hooks.md feat(hooks): add config-driven message handlers for immediate agent triggering 2026-01-28 20:51:06 +00:00
index.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
logging.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
multi-agent-sandbox-tools.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
network.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
northflank.mdx refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
perplexity.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
plugin.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
prose.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
railway.mdx refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
render.mdx refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
scripts.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
testing.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
token-use.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
tts.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
tui.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
vps.md refactor: rename clawdbot to moltbot with legacy compat 2026-01-27 12:21:02 +00:00
whatsapp-clawd.jpg Add WhatsApp screenshot to claude-config.md 2025-11-27 18:43:24 +01:00