openclaw-workspaces

Summary

This repository provides a structured set of workspace templates for managing AI agents, their memory, tools, and "soul" configurations within the OpenClaw ecosystem. Each agent's workspace includes clear protocols for session workflow, continuity, and collaboration, making it easy to set up and manage intelligent assistants for diverse tasks.

Included Assets

• Global Templates

  • AGENTS.md: Main workspace protocol and memory management instructions
  • SOUL.md: Core identity, boundaries, and principles for agents
  • TOOLS.md: Instructions and templates for local environment/tool notes

• Agent Workspaces

  • Four agent directories under agent-workspaces/:
    • adrian/: Trend intelligence researcher
      • AGENTS.md, MEMORY.md, SOUL.md, TOOLS.md
    • quinn/: Web artifact design/build expert
      • AGENTS.md, MEMORY.md, SOUL.md, TOOLS.md
    • skippy/: Multifunctional workspace and context assistant
      • AGENTS.md, MEMORY.md, SOUL.md, TOOLS.md
    • tessa/: Lead capture & form UX specialist
      • AGENTS.md, MEMORY.md, SOUL.md
  • Each agent workspace follows a consistent folder and file naming convention.

• Memory Guidance

  • Daily memory files (memory/YYYY-MM-DD.md)
  • Long-term memory files (MEMORY.md per agent)

How to Use

1. Choose or create an agent workspace
   Copy the desired agent folder and customize it as needed for your new agent.

2. Session startup protocol

   • Read SOUL.md to understand the agent's identity and guidance.
   • Read agent-specific instructions in AGENTS.md—follow the step-by-step procedure to initialize context for each session.
   • Review the most recent memory/YYYY-MM-DD.md files for daily continuity; in main sessions, also load the long-term MEMORY.md.
   • Review and update TOOLS.md to store and retrieve environment-specific notes (where applicable).

3. Memory management

   • For every session, create or append to that day's memory/YYYY-MM-DD.md for event logging and context.
   • Periodically distill what is important from daily notes into MEMORY.md.

4. Agent collaboration

   • Each agent workspace may reference other agents for specialized delegation.
   • Use the provided delegation notes and task flows to coordinate as a team.

5. Environment and tooling

   • Use TOOLS.md for recording custom setups, device info, project paths, and workflow notes specific to your environment.

Notes

• These workspaces are designed for file-based, persistent, and non-performative agents—"not just a chatbot."
• Safeguard continuity and security: follow the outlined boundaries regarding memory use in shared vs direct-user contexts.
• Update SOUL.md only with user awareness; it is foundational to the agent’s identity.
• Each agent's instructions are specific—follow any prescribed tool or skill protocols.
• Adapt the templates to fit the workflow and technical constraints of your deployment.

For best results, review the README, SOUL.md, AGENTS.md, and TOOLS.md before launching an agent session.