Openclaw Workspace banner
win4r win4r

Openclaw Workspace

Development community

Description

Claude Code skill for maintaining and optimizing OpenClaw workspace files (AGENTS.md, SOUL.md, TOOLS.md, MEMORY.md, checklists)

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

openclaw-workspace

A [Claude Code](https://claude.ai/claude-code) skill for maintaining and optimizing [OpenClaw](https://openclaw.ai) workspace files — the markdown files that form an AI agent's soul, memory, and operating procedures.

[中文文档 →](README_CN.md)


What is this?

OpenClaw is a self-hosted, multi-channel AI agent gateway (WhatsApp, Telegram, Discord, Slack, and more). Every OpenClaw agent has a **workspace** — a directory of markdown files that are injected into the system prompt on each turn, giving the agent its identity, behavioral rules, environmental knowledge, and long-term memory.

These workspace files are powerful but require careful management:

  • Too much content wastes tokens on every single turn
  • Redundancy between files creates confusion and contradictions
  • Stale content (old SSH hosts, deprecated rules, finished tasks) silently degrades agent quality
  • Missing security gates can leak private memory into group chats

This skill gives Claude Code the knowledge to audit, optimize, and build OpenClaw workspace files correctly.


Workspace Files Overview

File Purpose Loaded When Visible to Sub-agents?
AGENTS.md Boot sequence, checklists, behavioral rules Every turn (all agents) Yes
SOUL.md Persona, tone, values, continuity philosophy Every turn (all agents) Yes
TOOLS.md Env-specific notes (SSH, TTS, cameras, devices) Every turn (main + sub-agents) Yes
USER.md Human profile, preferences, relationship context Every turn (main sessions only) No
IDENTITY.md Name, emoji, avatar, self-description Every turn Yes
HEARTBEAT.md Periodic check tasks and health routines Every heartbeat turn Depends
BOOT.md Startup actions (hooks.internal.enabled required) On gateway startup No
BOOTSTRAP.md First-time onboarding script — delete after use New workspaces only No