Files

zhi d90083317b fix: channelId extraction, sender identification, and per-channel turn order

- Fix channelId extraction: ctx.channelId is platform name ('discord'), not
  the Discord channel snowflake. Now extracts from conversation_label field
  ('channel id:123456') and sessionKey fallback (':channel:123456').

- Fix extractDiscordChannelId: support 'discord:channel:xxx' format in
  addition to 'channel:xxx' for conversationId/event.to fields.

- Fix sender identification in message_received: event.from returns channel
  target, not sender ID. Now uses event.metadata.senderId for humanList
  matching so human messages correctly reset turn order.

- Fix per-channel turn order: was using all server-wide bot accounts from
  bindings, causing deadlock when turn landed on bots not in the channel.
  Now dynamically tracks which bot accounts are seen per channel via
  message_received and only includes those in turn order.

- Always save sessionChannelId/sessionAccountId mappings in before_model_resolve
  regardless of turn check result, so downstream hooks can use them.

- Add comprehensive debug logging to message_sent hook.

2026-03-01 11:08:41 +00:00

index.ts

fix: channelId extraction, sender identification, and per-channel turn order

2026-03-01 11:08:41 +00:00

moderator-presence.ts

fix: moderator presence reconnect loop

2026-02-28 18:49:17 +00:00

openclaw.plugin.json

fix: add moderatorBotToken to plugin configSchema

2026-02-28 12:11:04 +00:00

package.json

test: add rule-case validator for no-reply and 🔚 injection paths

2026-02-25 12:53:45 +00:00

README.md

feat(debug): add whispergate hook diagnostics with channel-scoped debug logs

2026-02-26 01:58:01 +00:00

rules.ts

feat: moderator bot for turn handoff messages

2026-02-28 12:10:52 +00:00

turn-manager.ts

refactor: auto-managed turn order + dormant state + identity injection

2026-02-28 12:10:52 +00:00

README.md

WhisperGate Plugin

Hook strategy

message:received caches a per-session decision from deterministic rules.
before_model_resolve applies providerOverride + modelOverride when decision says no-reply.
before_prompt_build prepends instruction 你的这次发言必须以🔚作为结尾。 when decision is:
- bypass_sender
- end_symbol:*

Rules (in order)

non-discord -> skip
bypass sender -> skip
end symbol matched -> skip
else -> no-reply override

Config

See docs/CONFIG.example.json.

Required:

noReplyProvider
noReplyModel

Optional:

enabled (default true)
discordOnly (default true)
listMode (human-list | agent-list, default human-list)
humanList (default [])
agentList (default [])
channelPoliciesFile (per-channel overrides in a standalone JSON file)
enableWhispergatePolicyTool (default true)

Unified optional tool:

whispergateway_tools
- Discord actions: channel-private-create, channel-private-update, member-list
- Policy actions: policy-get, policy-set-channel, policy-delete-channel
bypassUserIds (deprecated alias of humanList)
endSymbols (default ["🔚"])
enableDiscordControlTool (default true)
discordControlApiBaseUrl (default http://127.0.0.1:8790)
discordControlApiToken
discordControlCallerId
enableDebugLogs (default false)
debugLogChannelIds (default [], empty = all channels when debug enabled)

Per-channel policy file example: docs/channel-policies.example.json.

Policy file behavior:

loaded once on startup into memory
runtime decisions read memory state only
direct file edits do NOT affect memory state
whispergateway_tools policy actions update memory first, then persist to file (atomic write)

Optional tool: `whispergateway_tools`

This plugin registers one unified optional tool: whispergateway_tools. To use it, add tool allowlist entry for either:

tool name: whispergateway_tools
plugin id: whispergate

Supported actions:

Discord: channel-private-create, channel-private-update, member-list
Policy: policy-get, policy-set-channel, policy-delete-channel

Debug logging:

set enableDebugLogs: true to emit detailed hook diagnostics
optionally set debugLogChannelIds to only log selected channel IDs
logs include key ctx fields + decision status at message_received, before_model_resolve, before_prompt_build

README.md

WhisperGate Plugin

Hook strategy

Rules (in order)

Config

Optional tool: whispergateway_tools

Optional tool: `whispergateway_tools`