Error Log

2026-04-29 08:26:44,359 ERROR gateway.platforms.base: [Weixin] Weixin bot token already in use (PID 30033). Stop the other gateway first. 2026-04-29 08:26:44,360 ERROR gateway.run: Gateway hit a non-retryable startup conflict: weixin: Weixin bot token already in use (PID 30033). Stop the other gateway first. 2026-04-29 08:26:44,361 ERROR gateway.run: Gateway exiting cleanly

TL;DR

Implement a wait or waitpid step in the hermes gateway restart command to ensure the old process fully exits before starting a new one.

Guidance

• Modify the hermes gateway restart command to send SIGTERM to the old process and then wait for it to exit using waitpid() with a suitable timeout.
• Verify the fix by checking the gateway logs for successful restarts without Weixin token conflicts.
• Consider adding a retry mechanism to handle cases where the old process takes longer than expected to exit.
• Review the waitpid() timeout value to balance between waiting long enough for the old process to exit and not introducing unnecessary delays.

Example

# Pseudocode example of the modified restart command
hermes_gateway_restart() {
  # Send SIGTERM to old process
  kill -SIGTERM $OLD_PID
  
  # Wait for old process to exit
  waitpid $OLD_PID $TIMEOUT
  
  # Start new gateway process
  hermes gateway start
}

Notes

The suggested fix assumes that the waitpid() system call is available and suitable for this use case. Additionally, the choice of timeout value for waitpid() may require experimentation to find a balance between reliability and performance.

Recommendation

Apply the suggested fix by modifying the hermes gateway restart command to include a wait or waitpid step, as this directly addresses the root cause of the issue and eliminates the race condition.