openclaw - 💡(How to fix) Fix Feature request: Shared global bootstrap prompt for all agents [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#72698Fetched 2026-04-28 06:33:20
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Author
Participants
RAW_BUFFERClick to expand / collapse

Problem

When managing multiple agents in OpenClaw, there's no way to apply a shared set of rules/instructions to all agents from a single source of truth.

Every time a rule needs to change — say, a new operational policy, a security guideline, or an updated workflow — we have to manually update the AGENTS.md (or equivalent) for every single agent. This doesn't scale.

Proposed solution

Introduce a shared global bootstrap prompt mechanism. Something like a GLOBAL_BOOTSTRAP.md (or similar) that lives in a central location (e.g., ~/.openclaw/global-bootstrap.md) and is automatically injected as an incremental addition to every agent's initial context on session startup.

This would function like a company-wide employee handbook or operating manual:

  • Maintain one file
  • All agents get the updated content on their next session start
  • No per-agent manual updates needed

Use case

  • Security policies that apply to all agents (e.g., "never delete production data without approval")
  • Operational procedures (e.g., "report incidents to the on-call engineer")
  • Shared naming conventions, credential handling rules
  • Any rule that should be universal across the entire agent fleet

Suggested implementation

  1. A central file at ~/.openclaw/global-bootstrap.md
  2. A config option like agents.defaults.globalBootstrapPath to point to it
  3. On every agent session start, this file's content is injected after the agent's own workspace bootstrap files
  4. Only one instance of the file needs to exist and be maintained

Alternatives considered

  • Skills: Skills only inject metadata into the system prompt, not fixed content on every session. Not suitable for this use case.
  • BOOTSTRAP.md: Only runs once on first workspace creation, not on every session.
  • Shared skills directory: Still requires per-agent skill loading; doesn't guarantee injection on every session start.

Prior art

Many multi-agent frameworks (e.g., CrewAI, AutoGen, Microsoft AutoAgent) have some concept of a "shared system prompt" or "global instructions" that all agents inherit. OpenClaw is well-positioned to offer this given its existing multi-agent architecture.


Would love to hear if this aligns with the project's vision, and happy to contribute if someone points me in the right direction on implementation.

extent analysis

TL;DR

Implement a shared global bootstrap prompt mechanism by introducing a GLOBAL_BOOTSTRAP.md file that is automatically injected into every agent's initial context on session startup.

Guidance

  • Consider adding a config option like agents.defaults.globalBootstrapPath to point to the central GLOBAL_BOOTSTRAP.md file.
  • On every agent session start, inject the content of GLOBAL_BOOTSTRAP.md after the agent's own workspace bootstrap files.
  • Evaluate the proposed implementation steps, including the use of a central file at ~/.openclaw/global-bootstrap.md.
  • Review the alternatives considered, such as Skills and BOOTSTRAP.md, to ensure the chosen approach meets the requirements.

Example

No code snippet is provided as the issue does not contain explicit code references.

Notes

The implementation details may vary depending on the specific requirements and constraints of the OpenClaw project. It is essential to discuss and align the proposed solution with the project's vision before proceeding with the implementation.

Recommendation

Apply the proposed workaround by introducing a shared global bootstrap prompt mechanism, as it addresses the scalability issue of updating rules for multiple agents and aligns with the prior art in multi-agent frameworks.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING