openclaw - 💡(How to fix) Fix Control UI crashes with 'missing scope: operator.read' after WebSocket reconnect [1 comments, 2 participants]

Fix Plan

To resolve the issue, we need to modify the frontend to either include the operator.read scope in the dashboard token or handle permission errors gracefully. Here are the steps:

• Modify token generation: Include operator.read scope in the token generation process.
• Handle permission errors: Implement a retry mechanism with exponential backoff and a maximum retry limit to prevent the page from freezing.

Example Code

// Modify token generation to include operator.read scope
const token = generateToken({
  scopes: ['operator.read', 'other.scope'],
});

// Handle permission errors with exponential backoff
const maxRetries = 5;
const retryDelay = 500; // initial delay in ms

function getConfig() {
  return fetch('config.get')
    .catch((error) => {
      if (error.errorMessage === 'missing scope: operator.read') {
        // Handle permission error
        if (maxRetries > 0) {
          setTimeout(() => {
            maxRetries--;
            retryDelay *= 2; // exponential backoff
            getConfig();
          }, retryDelay);
        } else {
          // Maximum retries reached, handle error
          console.error('Failed to retrieve config');
        }
      } else {
        throw error;
      }
    });
}

Verification

To verify the fix, follow these steps:

• Open the Control UI dashboard and simulate a WebSocket reconnect.
• Verify that the page remains responsive and does not freeze.
• Check the gateway logs for any missing scope: operator.read errors.
• Test the retry mechanism by intentionally causing a permission error and verifying that the page recovers after the maximum retry limit is reached.

Extra Tips

• Consider implementing a more robust error handling mechanism to handle other types of errors.
• Review the token generation process to ensure that the operator.read scope is included only when necessary.
• Monitor the gateway logs for any issues related to the operator.read scope and adjust the retry mechanism as needed.