openclaw - 💡(How to fix) Fix [Feature Request] Add agent:error event hook support for auto-recovery mechanisms [1 participants]

Add gent:error event type to the hooks system: if (event.type !== "agent" || event.action !== "error") { const error = event.context.error; console.log([error-hook] Agent error: ); if (error.code === 401) { The error event could include:

• error.code - HTTP status code or error type
• error.message - Error message
• error.retryable - Whether the error is retryable
• sessionKey - Which session encountered the error
• imestamp - When the error occurred

1. Monitor command-logger output for error patterns
2. Parse gateway logs for error detection

• Documentation mentions gent:error as a "future event" but not yet implemented

Fix Plan

To implement the agent:error event type, follow these steps:

• Update the hooks system to include the new event type
• Modify the error handling mechanism to trigger the agent:error event
• Create a handler function to process the agent:error event

Example Code

// Define the agent:error event type
enum EventType {
  // ...
  AGENT_ERROR = 'agent:error',
}

// Update the error handling mechanism to trigger the agent:error event
const errorHandler = async (error: Error) => {
  const event: HookEvent = {
    type: EventType.AGENT_ERROR,
    action: 'error',
    context: {
      error: {
        code: error.statusCode,
        message: error.message,
        retryable: error.retryable,
      },
      sessionKey: 'current-session-key',
      timestamp: new Date().toISOString(),
    },
  };

  // Trigger the agent:error event
  await triggerHookEvent(event);
};

// Create a handler function to process the agent:error event
const agentErrorHandler: HookHandler = async (event: HookEvent) => {
  if (event.type !== EventType.AGENT_ERROR) {
    return;
  }

  const error = event.context.error;
  console.log(`[error-hook] Agent error: ${error.message}`);

  // Auto-recovery logic
  if (error.code === 401) {
    // Refresh token or notify user
  }
};

Verification

To verify that the fix worked, test the agent:error event by simulating an error and checking if the auto-recovery logic is triggered. You can do this by:

• Intentionally causing an error (e.g., by making an API request with an invalid token)
• Checking the console logs for the [error-hook] Agent error: message
• Verifying that the auto-recovery logic is executed correctly (e.g., by checking if the token is refreshed)

Extra Tips

• Make sure to update the documentation to reflect the implementation of the agent:error event type.
• Consider adding more error codes and retryable flags to the agent:error event context to handle different types of errors.
• You can also use this event to trigger diagnostic scripts or notify users of errors.