openclaw - 💡(How to fix) Fix [aight-utils] Bootstrap hook re-registered on every hot-reload (duplicate api.on accumulation) [1 participants]

TL;DR

Apply a patch to the registerBootstrap function in aight-utils to add an idempotency guard, preventing duplicate registrations of the before_agent_start hook.

Guidance

• Identify the registerBootstrap function in dist/src/bootstrap.js and add a module-level flag _bootstrapRegistered to track whether the hook has already been registered.
• Modify the registerBootstrap function to check the _bootstrapRegistered flag before registering the hook, and skip registration if the flag is already set to true.
• Verify the fix by triggering a gateway hot-reload and checking the logs for duplicate entries.
• Consider applying this patch to the aight-utils plugin in a production environment to prevent further log accumulation and performance issues.

Example

let _bootstrapRegistered = false;
export function registerBootstrap(api) {
    if (_bootstrapRegistered) {
        api.logger.info("[aight-utils] Bootstrap hook already registered, skipping.");
        return;
    }
    _bootstrapRegistered = true;
    api.on("before_agent_start", (_event, ctx) => { ... });
}

Notes

This fix assumes that the registerBootstrap function is only called once per gateway hot-reload. If this function can be called multiple times in other scenarios, additional modifications may be necessary.

Recommendation

Apply the workaround by patching the registerBootstrap function with the idempotency guard, as this will prevent duplicate registrations and mitigate the performance issues caused by the bug.