BOOT.md Template: Workspace Boot Commands for Agent Gateways

This page describes the BOOT.md workspace template used to execute boot commands when a gateway starts. It is intended for developers configuring agent workspaces with the boot-md hook.

Read this when

  • Adding a BOOT.md checklist

BOOT.md

Place brief, clear boot commands in this section. Whenever the gateway starts, the included boot-md hook executes this file one time per agent workspace, provided the file is present and contains content beyond whitespace. When several agents share a single workspace, the hook runs only once.

The hook comes deactivated by default. Activate it as follows:

openclaw hooks enable boot-md

When a checklist entry transmits a message, employ the message tool and respond with the precise silent token NO_REPLY, ignoring case.

92 words · updated Jul 27, 2026