openclaw/docs/concepts
mudrii 5d82c82313
feat: per-channel responsePrefix override (#9001)
* feat: per-channel responsePrefix override

Add responsePrefix field to all channel config types and Zod schemas,
enabling per-channel and per-account outbound response prefix overrides.

Resolution cascade (most specific wins):
  L1: channels.<ch>.accounts.<id>.responsePrefix
  L2: channels.<ch>.responsePrefix
  L3: (reserved for channels.defaults)
  L4: messages.responsePrefix (existing global)

Semantics:
  - undefined -> inherit from parent level
  - empty string -> explicitly no prefix (stops cascade)
  - "auto" -> derive [identity.name] from routed agent

Changes:
  - Core logic: resolveResponsePrefix() in identity.ts accepts
    optional channel/accountId and walks the cascade
  - resolveEffectiveMessagesConfig() passes channel context through
  - Types: responsePrefix added to WhatsApp, Telegram, Discord, Slack,
    Signal, iMessage, Google Chat, MS Teams, Feishu, BlueBubbles configs
  - Zod schemas: responsePrefix added for config validation
  - All channel handlers wired: telegram, discord, slack, signal,
    imessage, line, heartbeat runner, route-reply, native commands
  - 23 new tests covering backward compat, channel/account levels,
    full cascade, auto keyword, empty string stops, unknown fallthrough

Fully backward compatible - no existing config is affected.
Fixes #8857

* fix: address CI lint + review feedback

- Replace Record<string, any> with proper typed helpers (no-explicit-any)
- Add curly braces to single-line if returns (eslint curly)
- Fix JSDoc: 'Per-channel' → 'channel/account' on shared config types
- Extract getChannelConfig() helper for type-safe dynamic key access

* fix: finish responsePrefix overrides (#9001) (thanks @mudrii)

* fix: normalize prefix wiring and types (#9001) (thanks @mudrii)

---------

Co-authored-by: Gustavo Madeira Santana <gumadeiras@gmail.com>
2026-02-04 16:16:34 -05:00
..
agent-loop.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
agent-workspace.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
agent.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
architecture.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
channel-routing.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
compaction.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
context.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
features.md Docs: landing page revamp (#8885) 2026-02-04 10:37:14 -05:00
group-messages.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
groups.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
markdown-formatting.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
memory.md chore: prep 2026.2.2 docs/release checks 2026-02-03 16:38:42 -08:00
messages.md feat: per-channel responsePrefix override (#9001) 2026-02-04 16:16:34 -05:00
model-failover.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
model-providers.md Docs: fix Moonshot sync markers (#6789) 2026-02-02 03:38:14 +01:00
models.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
multi-agent.md chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
oauth.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
presence.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
queue.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
retry.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
session-pruning.md fix: satisfy lint curly rule (#6310) 2026-02-01 20:04:53 +05:30
session-tool.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
session.md docs: document secure DM mode preset (#7872) 2026-02-04 06:55:13 +00:00
sessions.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
streaming.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
system-prompt.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
timezone.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
typebox.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
typing-indicators.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
usage-tracking.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00