openclaw-agent-builder

What This Skill Does

The openclaw-agent-builder is the foundational orchestration engine for the OpenClaw ecosystem. It allows users to define, configure, and isolate AI agent personalities and their underlying operational workspaces. By managing the filesystem structure of agents—including SOUL.md for personality, TOOLS.md for skill sets, and AGENTS.md for routing logic—this builder ensures that your AI agents remain contextually relevant to their specific domains. It handles critical architecture components like session persistence, cross-channel identity linking, and complex message routing, making it the primary tool for deploying multi-agent systems that need to maintain state, privacy, and functional boundaries.

Installation

To integrate this builder into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/a12591771/openclaw-agent-builder

Use Cases

• Multi-Agent Environments: Deploy a 'Work' agent for office communication and a 'Home' agent for personal tasks, ensuring professional and personal data never overlap.
• Privacy & Isolation: Use dmScope: per-channel-peer to allow multiple people to interact with a single shared chat gateway while keeping their message history and context strictly siloed.
• Team Collaboration: Create a dedicated team agent bound to a specific Feishu or Slack group, requiring direct mentions to filter out noise and improve response accuracy.
• Unified Identity: Link identities across different platforms (e.g., Telegram and Feishu) so your agent recognizes you as the same user regardless of the platform used.

Example Prompts

1. "Initialize a new workspace for a 'Research Assistant' agent, configure its persona in SOUL.md, and restrict its file access tools for security."
2. "Set up a routing rule so that all messages from the 'Project-X' Feishu group are automatically processed by the 'Manager' agent."
3. "Enable session isolation for my group chat gateway using 'per-channel-peer' mode to ensure each member has a private thread with the bot."

Tips & Limitations

• Organization is Key: Keep your ~/.openclaw/workspace/ organized. Treat the configuration files as code (IaC) to maintain consistency.
• Security First: Always use the tools allow/deny lists for agents handling sensitive operations or interacting with untrusted external inputs.
• Cleanup: Utilize session.maintenance for high-frequency channels to prevent your sessions/ directory from becoming bloated with stale data.
• Limitations: Note that agent configuration updates require a reload of the agent process to take effect. Ensure your JSON configuration syntax is strictly validated before deployment to prevent runtime errors.