openclaw - 💡(How to fix) Fix Gateway crashes with 'Agent listener invoked outside active run' unhandled promise rejection [1 participants]

2026-04-07T16:15:16.611+09:00 [openclaw] Unhandled promise rejection: Error: Agent listener invoked outside active run systemd[1738]: openclaw-gateway.service: Main process exited, code=exited, status=1/FAILURE

2026-04-07T16:21:51.997+09:00 [openclaw] Unhandled promise rejection: Error: Agent listener invoked outside active run systemd[1738]: openclaw-gateway.service: Main process exited, code=exited, status=1/FAILURE

2026-04-07T16:25:29.599+09:00 [openclaw] Unhandled promise rejection: Error: Agent listener invoked outside active run systemd[1738]: openclaw-gateway.service: Main process exited, code=exited, status=1/FAILURE

2026-04-07T16:30:08.344+09:00 [openclaw] Unhandled promise rejection: Error: Agent listener invoked outside active run systemd[1738]: openclaw-gateway.service: Main process exited, code=exited, status=1/FAILURE

TL;DR

The gateway crashes can be mitigated by handling promise rejections properly, potentially by catching and handling the Error: Agent listener invoked outside active run exception.

Guidance

• Investigate the agent execution code to identify where the Error: Agent listener invoked outside active run exception is being thrown and ensure it is properly caught and handled.
• Review the code for any potential race conditions that may be causing the agent listener to be invoked outside of an active run.
• Consider implementing a retry mechanism for agent executions that fail due to this error, to prevent cascading failures.
• Verify that the openclaw version 2026.4.5 is the latest available, as this issue may be resolved in a newer version.

Example

// Example of catching and handling the promise rejection
agent.execute(command)
 .catch((error) => {
    if (error.message === 'Agent listener invoked outside active run') {
      // Handle the error, e.g., retry the execution or log the error
      console.error('Agent listener invoked outside active run:', error);
    } else {
      throw error;
    }
  });

Notes

The provided information suggests that the issue is related to the agent execution code, but without more context or code snippets, it's difficult to provide a more specific solution. Additionally, the openclaw version and Node.js version may be relevant to the issue, but without more information, it's unclear if upgrading or downgrading would resolve the issue.

Recommendation

Apply workaround: Implement proper error handling for the Error: Agent listener invoked outside active run exception to prevent the gateway from crashing. This will allow the system to continue functioning, even if the underlying issue is not fully resolved.