A command-line tool for managing isolated Docker development environments on your Tailscale network with pre-installed AI coding agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install perry-workspaces
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 perry-workspaces 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 Perry Workspaces?
Perry Workspaces is a specialized environment manager designed to provision isolated Docker containers within your private tailnet. By integrating with Openclaw Skills, it allows developers to quickly spin up workspaces that are pre-configured with powerful AI agents like Claude Code and OpenCode. This ensures a consistent, secure, and ready-to-code setup regardless of your local machine's configuration.
The tool prioritizes isolation and security, utilizing Tailscale for networking and MagicDNS for easy hostname resolution. It streamlines the lifecycle of remote development by handling container creation, repository cloning, and tool configuration in a single workflow.
Perry Workspaces Use Cases
- Launching remote development sessions with pre-installed Claude Code and OpenCode via Openclaw Skills.
- Isolating different project dependencies within separate Docker containers on a private network.
- Enabling browser-based AI coding using the built-in OpenCode web UI on port 4096.
- Creating reproducible development environments for team members via automated Git repository cloning.
How Perry Workspaces Works
- Provision a new environment by running the start command with a unique workspace name and optional Git repository.
- Automatically join the container to the Tailscale network for secure, peer-to-peer connectivity using MagicDNS.
- Access the workspace through the interactive Perry CLI shell or standard SSH using the dedicated workspace user account.
- Interact with AI coding agents through the terminal (Claude Code) or the web interface (OpenCode).
- Manage the lifecycle of these environments using simple list, stop, and remove commands.
Perry Workspaces Setup
To begin using this skill within your Openclaw Skills toolkit, use the following commands for installation and configuration:
# Start a new workspace and clone a repository
perry start my-workspace --clone [email protected]:user/repo.git
# List all active workspaces and their status
perry ls
# Enter the interactive shell for a specific workspace
perry shell my-workspace
# Connect via SSH from an external terminal
ssh workspace@my-workspace
Perry Workspaces Data Schema & Taxonomy
| Component | Configuration Details |
|---|---|
| Default User | Always workspace (not local user) |
| Project Location | Located at ~/ |
| OpenCode Port | Web UI accessible via port 4096 |
| Networking | Managed via Tailscale (MagicDNS or IP) |
| Pre-installed Tools | Claude Code, OpenCode, and Docker |
Perry Workspaces Advanced Features
- Seamless MagicDNS support allowing connection via hostname instead of manual IP management.
- Direct Claude Code CLI integration available immediately inside every perry shell.
- Multi-agent support with OpenCode web UI for visual development alongside terminal tasks.
- Automated project cloning to standardize Openclaw Skills development across different machines.
- Isolated environment lifecycle management (start, stop, remove) for optimized resource usage.
SKILL.md
Loading
Related Openclaw Skills
Dex Task Tracking
A specialized task tracking utility designed to manage asynchronous work and multi-session agent dispatches through a git-friendly CLI.
Paramus Chemistry
A comprehensive scientific computing toolkit providing over 300 authoritative tools for chemistry, thermodynamics, and molecular analysis.
Cairn
Cairn is an AI-native project management system that uses markdown files as a shared workspace for humans and AI agents.
Typst & LaTeX Compiler
A specialized API-driven skill for transforming Typst and LaTeX source files into production-ready PDF documents without local dependencies.
Workout CLI
A high-performance command-line interface for logging workouts, managing exercise libraries, and tracking multi-user fitness progression.
SAFE Encryption Tool
A modern encryption skill for AI agents providing post-quantum protection, multi-recipient support, and seamless GitHub identity integration.
METADATA
Featured*
