openclaw/docs
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
..
.i18n 🤖 docs: mirror landing revamp for zh-CN 2026-02-04 10:42:12 -08:00
assets Docs: landing page revamp (#8885) 2026-02-04 10:37:14 -05:00
automation fix: cron announce delivery path (#8540) (thanks @tyler6204) 2026-02-04 01:03:59 -08:00
channels docs: update Feishu plugin docs 2026-02-03 23:24:41 -08:00
cli feat(cron): enhance delivery modes and job configuration 2026-02-04 01:03:59 -08:00
concepts feat: per-channel responsePrefix override (#9001) 2026-02-04 16:16:34 -05:00
debug Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
diagnostics Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
experiments Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
gateway feat: per-channel responsePrefix override (#9001) 2026-02-04 16:16:34 -05:00
help iMessage: promote BlueBubbles and refresh docs/skills (#8415) 2026-02-03 18:06:54 -08:00
hooks Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
images Channels: finish Feishu/Lark integration 2026-02-03 14:27:39 -08:00
install feat: remove slop. 2026-02-03 22:04:17 +09:00
nodes fix: format issues and lint error in oauth.ts 2026-02-02 01:59:42 +01:00
platforms fix: harden voice-call webhook verification 2026-02-03 23:47:27 -08:00
plugins fix: harden voice-call webhook verification 2026-02-03 23:47:27 -08:00
providers feat: add cloudflare ai gateway provider 2026-02-04 04:10:13 -08:00
refactor Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
reference Docs: landing page revamp (#8885) 2026-02-04 10:37:14 -05:00
security chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
start 🤖 docs: mirror landing revamp for zh-CN 2026-02-04 10:42:12 -08:00
tools feat: add configurable web_fetch maxChars cap 2026-02-03 18:03:53 -08:00
web feat(cron): enhance delivery modes and job configuration 2026-02-04 01:03:59 -08:00
zh-CN 🤖 docs: mirror landing revamp for zh-CN 2026-02-04 10:42:12 -08:00
CNAME refactor: rename to openclaw 2026-01-30 03:16:21 +01:00
bedrock.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
brave-search.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
broadcast-groups.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
custom.css Docs: landing page revamp (#8885) 2026-02-04 10:37:14 -05:00
date-time.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
debugging.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
docs.json Docs: landing page revamp (#8885) 2026-02-04 10:37:14 -05:00
environment.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
hooks.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
index.md Docs: landing page revamp (#8885) 2026-02-04 10:37:14 -05:00
logging.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
multi-agent-sandbox-tools.md chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
network.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
northflank.mdx chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
perplexity.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
pi-dev.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
pi.md fix: align pi-coding-agent typings and docs 2026-02-01 16:08:01 -08:00
plugin.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
prose.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
railway.mdx chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
render.mdx chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
scripts.md chore: clean up git hooks and actually install them again. 2026-02-03 22:08:24 +09:00
testing.md chore: Add `pnpm check` for fast repo checks. 2026-02-02 11:16:13 +09:00
token-use.md docs: document cacheRetention parameter (#6270) 2026-02-01 09:16:37 -05:00
tts.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
tui.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
vps.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
whatsapp-openclaw-ai-zh.jpg Docs: add zh-CN landing notice + AI image 2026-02-02 18:35:01 +01:00
whatsapp-openclaw.jpg refactor: rename to openclaw 2026-01-30 03:16:21 +01:00