Files

zhi 86fdc63802 fix: moderator presence reconnect loop

Root causes:
1. Multiple plugin subsystems each called startModeratorPresence,
   creating competing WebSocket connections to the same bot token.
   Discord only allows one connection per bot → 4008 rate limit →
   infinite reconnect loop (1000+ connects → token reset by Discord)

2. Invalid session (op 9) handler called scheduleReconnect, but the
   new connection would also get kicked → cascading reconnects

Fixes:
- Singleton guard: startModeratorPresence is a no-op if already started
- cleanup() nullifies old ws handlers before creating new connection
- Stale ws check: all callbacks verify they belong to current ws
- Exponential backoff with cap (max 60s) instead of fixed 2-5s delay
- heartbeat ACK tracking: detect zombie connections
- Non-recoverable codes (4004) properly stop all reconnection

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

index.ts

fix: turn check runs independently of evaluateDecision

2026-02-28 12:41:46 +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`