Does AGENTS.md need a top-level title?

[abstract flume]

Mine is missing one and I'm wondering it it matters and what the top-level title should be?

[brisk bloom]

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

[gray nymph]

Nope, the top-level # ... title is not special.

OpenClaw cares about the file existing as AGENTS.md, and for compaction it cares more about section headings like:

• ## Session Startup
• ## Red Lines

Those are the default sections re-injected after compaction, with legacy fallback to ## Every Session / ## Safety.

If you want an H1, the template uses:

# AGENTS.md - Your Workspace

So I'd use that, but it's mostly for readability, not behavior.

Docs:

• Template: https://docs.openclaw.ai/reference/templates/AGENTS
• Workspace files: https://docs.openclaw.ai/concepts/agent-workspace
• Compaction section names: https://docs.openclaw.ai/gateway/configuration-reference

Glad you caught it, this is one of those things that looks more important than it is 😄