A sophisticated project management framework for orchestrating multi-agent workflows, isolated memory, and seamless context switching across various codebases.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install workplace
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 workplace 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 Workplace Skill?
The Workplace skill is a foundational component for developers using Openclaw Skills to manage complex, multi-repo environments. It enables the creation of isolated project environments, each equipped with its own set of dedicated AI agents, specialized memory logs, and deployment configurations. By treating every directory containing a .git folder as a potential workplace, the system allows for granular control over agent orchestration and state management.
This skill bridges the gap between high-level project management and low-level agent execution. It ensures that when you switch from one codebase to another, your AI agents instantly gain access to the relevant project structure, historical chat sessions, and specific toolsets required for that environment, significantly reducing context-switching overhead.
Workplace Skill Use Cases
- Managing multiple distinct coding projects with unique agent roles and skills.
- Orchestrating complex multi-agent handoffs using Swarm-style protocols within a specific directory.
- Synchronizing project-specific context and rules to IDEs like Cursor and Claude Code.
- Maintaining isolated, project-specific memory and chat histories to prevent cross-project context contamination.
- Automating project initialization by scanning for existing git repositories and submodules.
How Workplace Skill Works
- Discovery: The skill scans directories for .git folders or submodules to identify potential workplaces.
- Initialization: Running the init command creates a hidden .workplace directory containing project-specific configurations, agent definitions, and memory stores.
- Registration: The workplace is added to a global registry, allowing for quick switching and status tracking across the entire system.
- Orchestration: When a workplace is activated, the system loads specific agent roles (e.g., Kernel Agent) and initiates the Rust-based file-watcher for inter-agent communication.
- Synchronization: Contextual data is pushed to external IDEs, ensuring that your local coding environment is always in sync with the agent's project awareness.
Workplace Skill Setup
To begin managing your projects with Openclaw Skills, initialize your first workplace using the provided scripts:
# Initialize a workplace in a specific directory
./scripts/init_workplace.sh /path/to/your/project --name "project-name"
# Scan a parent directory to automatically discover git-based workplaces
./scripts/scan_workplaces.sh /path/to/parent/folder
# Switch to a specific workplace
/workplace switch project-name
Workplace Skill Data Schema & Taxonomy
The Workplace skill maintains a structured data hierarchy to ensure persistence and isolation:
| Path | Description |
|---|---|
~/.openclaw/workspace/.workplaces/registry.json |
Global list of all registered workplaces, paths, and UUIDs. |
.workplace/config.json |
Local workplace metadata including parent/child relationships and linked repos. |
.workplace/agents/ |
Markdown files defining specific agent roles, triggers, and handoff rules. |
.workplace/memory/ |
Daily logs in markdown format providing isolated project history. |
.workplace/chat.md |
The communication hub for inter-agent messaging and status updates. |
.workplace/deploy/ |
Environment-specific deployment documentation and instructions. |
Workplace Skill Advanced Features
- Multi-Agent Swarm Handoffs: Define complex workflows where agents can hand off tasks to specialized sub-agents based on YAML frontmatter triggers.
- Rust File-Watcher Integration: Real-time monitoring of inter-agent communication via a high-performance binary for instant message parsing.
- IDE Context Syncing: Automatically generates and updates .cursor/rules and CLAUDE.md files to keep external tools informed of project state.
- Interactive UI Components: Utilizes Telegram and Discord inline buttons for hierarchical navigation, agent management, and deployment triggers.
- Supermemory Containerization: Uses unique workplace UUIDs as container tags to isolate project facts and summaries within the long-term memory store.
SKILL.md
Loading
Related Openclaw Skills
Workplace Manager
A sophisticated workspace management system for orchestrating multi-agent workflows, isolated project memory, and seamless context switching.
Waze Navigation Skill
Automatically generates deep-linked Waze navigation URLs for addresses, businesses, and calendar events with intelligent location context.
Weather Query Skill
A precision tool for AI agents to query and report real-time global weather conditions, including temperature, humidity, and wind speed.
Printer (CUPS)
A comprehensive automation toolkit for managing macOS printers and CUPS queues directly through command-line interfaces.
PVPC Spain Electricity Optimizer
A specialized tool for tracking and optimizing Spanish PVPC electricity prices to minimize domestic energy costs.
Hello Agent World
A fundamental greeting skill that allows AI agents to provide personalized, context-aware introductions in the user's native language.
Featured*
