Files

zhi 435a7712b8 fix: add sessionChannelId mapping for message_sent

- Add sessionChannelId Map to track sessionKey -> channelId
- Save channelId in before_model_resolve when we have derived.channelId
- Fix message_sent to use sessionChannelId fallback when ctx.channelId is undefined
- Add debug logging to message_sent

2026-03-01 09:13:03 +00:00

index.ts

fix: add sessionChannelId mapping for message_sent

2026-03-01 09:13:03 +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`