openclaw - 💡(How to fix) Fix [Feature Request] Add agent:turn:complete hook event for notification/sound playback [1 participants]

Problem

Currently, there is no hook event that fires when an agent completes a response (turn). This makes it impossible to implement task completion notifications (like playing a sound) that trigger after all streaming content has been delivered to the user.

Current Hook Events

Looking at the hooks documentation, the available events are:

• Command events: command:new, command:reset, command:stop
• Session events: session:compact:before, session:compact:after, session:patch
• Agent events: agent:bootstrap
• Gateway events: gateway:startup
• Message events: message:received, message:sent

Gap

• message:sent fires for every message chunk during streaming, not when the entire response is complete
• No event exists for "agent finished responding" or "turn complete"

Proposed Solution

Add a new hook event:

agent:turn:complete

This event would fire when:

• The agent has finished generating its response
• All streaming content has been delivered
• The turn is truly complete

Event Context

{
  type: 'agent',
  action: 'turn:complete',
  sessionKey: string,
  sessionId: string,
  timestamp: Date,
  context: {
    messageCount: number,      // Number of message chunks sent
    toolCalls: string[],       // List of tools called during the turn
    duration: number,          // Time taken for the turn (ms)
  }
}

Use Cases

1. Task Completion Notification: Play a sound when the agent finishes a task
2. Usage Tracking: Log turn completion for analytics
3. Automation: Trigger follow-up actions when the agent is done
4. Accessibility: Notify users who may not be watching the screen

Alternative Considered

I considered using message:sent, but this fires for every streaming chunk, not when the response is complete. This doesn't solve the use case.

Environment

• OpenClaw version: 2026.4.1-beta.1
• Platform: Windows

Thanks for considering this feature request!