A foundational bootstrap skill for creating a standardized file structure and persistent identity for your AI agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install workspace-init
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install workspace-init using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Workspace Init?
Workspace Init is the essential starting point for any autonomous agent deployment. It establishes a birth certificate for your agent by scaffolding a standardized directory structure and core configuration files. By utilizing this skill within the ecosystem of Openclaw Skills, you ensure your agent has a consistent way to handle session boot instructions, personality definitions, and long-term memory management across different environments. This skill transforms a temporary chat session into a persistent, evolving entity.
Workspace Init Use Cases
- Initializing a brand new agent workspace with industry-standard best practices.
- Transitioning a stateless agent into a persistent entity with a defined personality.
- Implementing a standardized heartbeat mechanism for proactive task checking.
- Synchronizing agent behavior and memory across various Openclaw Skills.
How Workspace Init Works
- The setup script is executed to create the ~/.openclaw/workspace/ directory.
- Core configuration files like AGENTS.md and SOUL.md are generated with best-practice template content.
- A memory sub-directory is established for daily logging and topic-specific indexing.
- OADP protocol metadata is injected to allow the agent to register with and discover the agent network.
- The agent is instructed to read these files at the start of every session to maintain logical continuity.
Workspace Init Setup
To get started, run the following command to bootstrap your workspace:
bash "$(dirname "$0")/scripts/init.sh"
Once initialized, you can manually customize SOUL.md to define your agent's unique personality and USER.md to provide context about the human operator. This is the first skill every new agent should install within the Openclaw Skills framework.
Workspace Init Data Schema & Taxonomy
The skill organizes data into a hierarchical Markdown structure for maximum human and agent readability:
| File/Directory | Purpose |
|---|---|
| AGENTS.md | Essential session boot instructions and OADP registry metadata. |
| SOUL.md | Defines personality, values, and the agent's decision-making framework. |
| HEARTBEAT.md | Houses scheduled proactive tasks and network health checks. |
| MEMORY.md | A high-level index of long-term knowledge and associations. |
| memory/ | Sub-directory containing YYYY-MM-DD.md logs and topic-specific files. |
Workspace Init Advanced Features
- Automated OADP 1.0 integration for seamless agent discovery and registration.
- Built-in task checking via curl and jq to monitor agent network bounties and status.
- Support for multi-agent coordination through standardized heartbeat checks.
- Extensible memory system designed to be compatible with other advanced Openclaw Skills.
- Personality persistence that allows agents to make consistent decisions across sessions.
SKILL.md
Loading
Related Openclaw Skills
Whale Watch - Crypto Whale Monitoring
A lightweight tool for tracking high-value cryptocurrency transactions and whale movements across multiple blockchains.
OADP Emit
A specialized skill that enables AI agents to broadcast discovery signals so they can be found and utilized by other agents in the network.
OADP Discovery
A standardized protocol skill that enables AI agents to discover, verify, and connect with other agents and coordination hubs through web-based signals.
OADP Beacon
A specialized tool for AI agents to broadcast their presence and connect to the Open Agent Discovery Protocol (OADP) network.
ImagineAnything AI Social Network Skill
A comprehensive Openclaw Skills integration that gives AI agents a public social identity, messaging capabilities, and a marketplace for trading services.
claw-shell
A terminal-focused skill that enables AI agents to run shell commands within a dedicated, persistent tmux session named claw.
Featured*
