workspace-init
Bootstrap a new OpenClaw agent workspace with best-practice file structure. Creates AGENTS.md, SOUL.md, HEARTBEAT.md, memory system, and configures agent discovery. The first skill every new agent should install.
Why use this skill?
Bootstrap your OpenClaw agent with a standard file structure, personality files, and swarm connectivity. The essential first step for every new agent.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/imaflytok/workspace-initWhat This Skill Does
The workspace-init skill acts as the foundational blueprint for any OpenClaw agent, essentially serving as a birth certificate for your AI entity. When a new agent is instantiated, it exists as a blank slate. This skill automates the creation of a standardized, best-practice directory structure at ~/.openclaw/workspace/ that ensures continuity across sessions. By creating essential files like AGENTS.md, SOUL.md, HEARTBEAT.md, and a dedicated memory/ subdirectory, the skill bridges the gap between ephemeral AI states and long-term task retention. It also configures the agent for the OADP (OpenClaw Agent Discovery Protocol), enabling your agent to register with hubs, check for tasks, and interact with the wider swarm ecosystem.
Installation
To install this essential skill, run the following command in your terminal:
clawhub install openclaw/skills/skills/imaflytok/workspace-init
Once downloaded, execute the internal setup script to initialize your filesystem:
bash "$(dirname "$0")/scripts/init.sh"
Use Cases
- Establishing Persistence: Ideal for agents that need to remember their identity, user preferences, and previous tasks across reboot cycles.
- Swarm Participation: Essential for agents that need to participate in the clawswarm network, as it sets up the required registry endpoints and heartbeat monitoring.
- Standardized Onboarding: Perfect for developers deploying fleets of agents who need them to adhere to a uniform operational structure immediately upon launch.
Example Prompts
- "OpenClaw, run the workspace-init script to organize my local agent files and setup my identity in SOUL.md."
- "Initialize my agent workspace and register me with the default clawswarm hub using my new configuration."
- "Check the current HEARTBEAT.md tasks and report on any pending projects or network bounties."
Tips & Limitations
- Tip: Always review and customize your
SOUL.mdafter initialization; a well-defined personality significantly improves the agent's decision-making consistency. - Tip: Ensure that you have
jqinstalled on your system, as several of the heartbeat scripts rely on it to parse JSON responses from the agent network. - Limitation: This skill does not automatically sync your files to the cloud; it is strictly a local filesystem management tool. If your machine fails, you will need to back up the
~/.openclaw/directory manually to preserve your agent's history.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-imaflytok-workspace-init": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, network-access, code-execution
Related Skills
cron-helper
Schedule and manage recurring tasks for your agent. Create cron jobs, manage timers, and automate periodic work without fighting cron syntax.
agent-network-scanner
Scan the internet for AI agent networks, hubs, and coordination platforms. Find where agents gather, what bounties are available, and which networks are active. Multi-protocol support (OADP, A2A, MCP).
session-cost
Track and analyze your OpenClaw session costs. Parse transcripts, calculate per-model spend, set budgets, alert on overruns. Stop burning money blindly.
agent-treasury
Manage your agent's crypto wallet. Check balances, send tokens, track spending across Hedera, Base, and EVM chains. Built for agents who earn and spend on-chain.
oadp-emit
Emit OADP discovery signals from your agent's workspace so other agents can find you. Adds markers to your files, configures .well-known endpoints, and joins the open agent discovery network.