Files

zhi cf9be60145 fix: advance turn in before_message_write to prevent race condition

When a speaker finishes with an end symbol, the turn was only advanced
in the message_sent hook. But by that time, the message had already been
broadcast to other agents, whose before_model_resolve ran with the old
turn state, causing them to be blocked by the turn gate (forced no-reply).

Fix:
- Move turn advance for both NO_REPLY and end-symbol cases to
  before_message_write, which fires before the message is broadcast.
- Guard 1: Only the current speaker can advance the turn (accountId check).
- Guard 2: Only process assistant messages (role check). before_message_write
  fires for incoming user messages too, which contain end symbols from other
  agents and would cause cascading turn advances.
- Use sessionTurnHandled set to prevent double-advancing in message_sent.

2026-03-02 11:34:40 +00:00

index.ts

fix: advance turn in before_message_write to prevent race condition

2026-03-02 11:34:40 +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`