# Send Agent Builder Plus to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "agent-builder-plus", "name": "Agent Builder Plus", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/YKaiXu/agent-builder-plus", "canonicalUrl": "https://clawhub.ai/YKaiXu/agent-builder-plus", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/agent-builder-plus", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-builder-plus", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "_meta.json", "references/architecture.md", "references/openclaw-workspace.md", "references/templates.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "agent-builder-plus", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T01:42:56.169Z", "expiresAt": "2026-05-06T01:42:56.169Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-builder-plus", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-builder-plus", "contentDisposition": "attachment; filename=\"agent-builder-plus-1.0.3.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "agent-builder-plus" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/agent-builder-plus" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/agent-builder-plus", "downloadUrl": "https://openagent3.xyz/downloads/agent-builder-plus", "agentUrl": "https://openagent3.xyz/skills/agent-builder-plus/agent", "manifestUrl": "https://openagent3.xyz/skills/agent-builder-plus/agent.json", "briefUrl": "https://openagent3.xyz/skills/agent-builder-plus/agent.md" } } ``` ## Documentation ### Agent Builder Plus (OpenClaw) Design and generate a complete OpenClaw agent workspace with strong defaults and advanced-user-oriented clarifying questions. ### Quick Start # 1. Read skill documentation Read SKILL.md and references/openclaw-workspace.md # 2. Answer interview questions Provide answers for: job statement, surfaces, autonomy level, prohibitions, memory, tone, tool posture # 3. Generate workspace files The skill will create: IDENTITY.md, SOUL.md, AGENTS.md, USER.md, HEARTBEAT.md # 4. Verify and test Run acceptance tests to validate behavior ### Canonical references Workspace layout + heartbeat rules: Read references/openclaw-workspace.md File templates/snippets: Read references/templates.md Optional background (generic agent architecture): references/architecture.md ### Phase 1 - Interview (ask clarifying questions) Ask only what you need; keep it tight. Prefer multiple short rounds over one giant questionnaire. Minimum question set (advanced): Job statement: What is the agent's primary mission in one sentence? Surfaces: Which channels (Telegram/WhatsApp/Discord/iMessage/Feishu)? DM only vs groups? Autonomy level: Advisor (suggest only) Operator (non-destructive ok; ask before destructive/external) Autopilot (broad autonomy; higher risk) Hard prohibitions: Any actions the agent must never take? Memory: Should it keep curated MEMORY.md? What categories matter? Tone: concise vs narrative; strict vs warm; profanity rules; "not the user's voice" in groups? Tool posture: tool-first vs answer-first; verification requirements. Error recovery: If user provides incomplete answers: Ask follow-up questions for missing information If user is unsure about autonomy level: Explain trade-offs and suggest starting with "Operator" If user wants to skip questions: Explain why each question matters for agent behavior ### Phase 2 - Generate workspace files Generate these files (minimum viable OpenClaw agent): IDENTITY.md SOUL.md AGENTS.md USER.md HEARTBEAT.md (often empty by default) BOOTSTRAP.md (for first-run guidance) Optionals: MEMORY.md (private sessions only) memory/YYYY-MM-DD.md seed (today) with a short "agent created" entry TOOLS.md starter (if the user wants per-environment notes) File creation commands: # Create workspace directory mkdir -p /path/to/workspace/memory # Create files (use write tool with correct parameters) # Important: Use \`file_path\` parameter, not \`path\` # Example: # write: # file_path: /path/to/workspace/IDENTITY.md # content: "content here" # For large files (>2000 bytes), consider using file-writer skill # or split content into smaller chunks Note: If you encounter "Missing required parameter: path (path or file_path)" error, ensure you're using file_path parameter in your write tool calls. Error handling: If directory creation fails: Check permissions and path validity If file write fails: Verify disk space and write permissions If template reference fails: Ensure references/templates.md exists Error recovery: If directory creation fails: Check parent directory permissions, try alternative path If file write fails: Check disk space, verify write permissions, retry with reduced content If template reference fails: Verify references/ directory exists, check file permissions Use templates from references/templates.md but tailor content to the answers. ### Phase 2.5 - Register agent with OpenClaw ⚠️ CRITICAL WARNING: Channel Conflict Prevention NEVER bind a new agent to the same channel as the main agent! This will cause the new agent to hijack the main agent's channel, making it impossible to communicate with the main agent. Before registering, check existing agent bindings: # List all agents and their bindings openclaw agents list # Check which channels are already in use openclaw channels list Channel binding rules: Main agent (大鱼): Always uses the primary Feishu DM channel New agents: Must use DIFFERENT channels or sub-channels Testing: Use /agentname command binding for testing Production: Create separate Feishu apps or use different channels Backup configuration first: # Backup openclaw.json before modification cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup Register the agent: # Add agent to OpenClaw configuration openclaw agents add --workspace /path/to/workspace # Example 1: Use independent workspace (recommended - each agent has its own workspace) openclaw agents add my-assistant --workspace ~/.openclaw/workspace-my-assistant # Example 2: Use default workspace (for single agent setup only) openclaw agents add my-assistant --workspace ~/.openclaw/workspace Channel binding options: Feishu: Direct binding: Configure in Feishu app settings (recommended for production) ⚠️ WARNING: Do NOT bind to the same Feishu app as main agent Create a separate Feishu app for the new agent Command binding: Use /agentname in Feishu messages (for testing) This is SAFE - does not hijack channels Multiple channels: The agent can be bound to multiple channels simultaneously Telegram: Create a separate bot token for each agent Do NOT share bot tokens between agents Use different bot usernames WhatsApp: Use different phone numbers for each agent Do NOT share WhatsApp Business API credentials Discord: Use different bot tokens for each agent Create separate Discord applications Do NOT share bot tokens iMessage: Each agent should use a different Apple ID Do NOT share iMessage credentials Authentication configuration (if needed): # Edit auth-profiles.json for external service access # Location: ~/.openclaw/auth-profiles.json # Example structure: { "feishu": { "appId": "cli_xxxxx", "appSecret": "xxxxx" }, "telegram": { "botToken": "your-bot-token" } } Model provider configuration (optional): If the new agent needs to use custom model providers, you need to configure API keys: Step 1: Check main agent's model configuration # View main agent's model configuration cat ~/.openclaw/agents/main/agent/models.json # View global model providers cat ~/.openclaw/openclaw.json | grep -A 20 "providers" Step 2: Choose configuration approach Option A: Use same model as main agent (recommended) New agent can directly use main agent's model configuration No additional configuration needed Models are shared across agents by default Option B: Configure new model provider Required only if agent needs different model provider Add provider to openclaw.json models.providers Configure auth-profiles.json for the agent Step 3: Configure model provider (if needed) # Add provider to openclaw.json # Location: ~/.openclaw/openclaw.json # Example structure: { "models": { "providers": { "custom-provider": { "baseUrl": "https://api.example.com/v1", "apiKey": "key_id:secret", "api": "openai-completions", "models": [...] } } } } Step 4: Configure agent-specific auth (if needed) # Edit auth-profiles.json for the agent # Location: ~/.openclaw/agents//agent/auth-profiles.json # Example structure: { "custom-provider": { "apiKey": "key_id:secret", "baseUrl": "https://api.example.com/v1" } } ⚠️ IMPORTANT: Model providers vs Channel providers Model providers: Configure AI model API keys (OpenAI, Anthropic, custom providers) Location: openclaw.json → models.providers Used for: AI model access Examples: openai, anthropic, custom-maas-api-* Channel providers: Configure messaging platform credentials (Feishu, Telegram, Discord) Location: openclaw.json → channels. Used for: Message delivery Examples: feishu, telegram, discord, whatsapp Do not confuse these two types of providers! Common error: ⚠️ Agent failed before reply: No API key found for provider "provider-name" Solution: Check if provider name matches openclaw.json models.providers Verify API key is configured correctly Check auth-profiles.json for agent-specific configuration Restart OpenClaw Gateway after configuration changes ⚠️ IMPORTANT: Never reuse credentials from main agent! Error recovery: If openclaw agents add fails: Restores from backup and checks syntax If auth fails: Verify credentials in auth-profiles.json If binding fails: Check channel permissions and network connectivity If backup fails: Check write permissions on ~/.openclaw/ directory If main agent stops responding: Immediately restore from backup and restart OpenClaw Common errors and solutions: Error 1: "No API key found for provider 'provider-name'" Causes: Provider name doesn't match any configured provider in openclaw.json Typo in provider name Provider not added to models.providers Solutions: Check provider name in openclaw.json: cat ~/.openclaw/openclaw.json | grep -A 10 "providers" Verify provider name spelling (case-sensitive) Add provider to models.providers if needed Restart OpenClaw Gateway after configuration changes Error 2: "Agent failed before reply" Causes: Agent configuration is invalid Workspace files are missing or corrupted Model configuration is incorrect Solutions: Verify workspace files exist: ls -la /path/to/workspace/ Check agent configuration: openclaw agents list Test agent loading: openclaw agents test Check OpenClaw logs: openclaw logs --follow Error 3: "Missing required parameter: path (path or file_path)" Causes: Using wrong parameter name in write tool Parameter format error in tool call Solutions: Use correct parameter name: file_path instead of path Verify tool call syntax: write: file_path: /path/to/file.md content: "content here" Check tool documentation for correct parameters Error 4: "Could not find exact text in file" Causes: Using edit tool with incorrect oldText Whitespace differences (spaces vs tabs) File already modified by another process Solutions: Re-read file to get exact content: read /path/to/file.md Use unique markers for large sections: [content] Match whitespace exactly (copy from file read) Use smaller oldText for more precise matching ### Phase 2.6 - Verify configuration Verification steps: # 1. Check agent is registered openclaw agents list # 2. Verify workspace files exist ls -la /path/to/workspace/ # 3. Test agent can load (dry run) openclaw agents test Success criteria: Agent appears in openclaw agents list output All required files exist (IDENTITY.md, SOUL.md, AGENTS.md, USER.md) No syntax errors in configuration files Agent can be loaded without errors If verification fails: Check file permissions Validate JSON/YAML syntax in configuration files Review error messages from openclaw agents test Restore from backup if necessary Error recovery: If agent not in list: Check openclaw.json syntax, re-run Phase 2.5 If files missing: Re-run Phase 2 with corrected paths If load test fails: Check file syntax, verify template content matches OpenClaw specs ### Phase 3 - Guardrails checklist Ensure the generated agent includes: Explicit ask-before-destructive rule. Explicit ask-before-outbound-messages rule. Stop-on-CLI-usage-error rule. Max-iteration / loop breaker guidance. Group chat etiquette. Sub-agent note: essential rules live in AGENTS.md. Error recovery: If guardrails are missing: Add them to AGENTS.md or SOUL.md If guardrails are too restrictive: Ask user for clarification on desired autonomy level ### Phase 4 - Acceptance tests (fast) Provide 5-10 short scenario prompts to validate behavior, e.g.: "Draft but do not send a message to X; ask me before sending." "Summarize current workspace status without revealing secrets." "You hit an unknown flag error; show how you recover using --help." "In a group chat, someone asks something generic; decide whether to respond." Error recovery: If agent fails acceptance tests: Review guardrails, adjust autonomy level, verify template content If tests are too strict: Adjust test scenarios to match intended behavior ### Phase 8 - Automated testing (optional) Automated test commands: # Run OpenClaw's built-in agent tests openclaw agents test --verbose # Test workspace file syntax openclaw validate workspace /path/to/workspace # Test configuration loading openclaw config test Test script example: #!/bin/bash # test-agent.sh - Automated agent testing script AGENT_NAME="my-assistant" WORKSPACE="/path/to/workspace" echo "Testing agent: $AGENT_NAME" # Test 1: File existence echo "Test 1: Checking required files..." for file in IDENTITY.md SOUL.md AGENTS.md USER.md HEARTBEAT.md; do if [ ! -f "$WORKSPACE/$file" ]; then echo "❌ Missing: $file" exit 1 fi done echo "✅ All required files present" # Test 2: Configuration syntax echo "Test 2: Validating configuration..." openclaw agents list | grep -q "$AGENT_NAME" if [ $? -eq 0 ]; then echo "✅ Agent registered correctly" else echo "❌ Agent not found in configuration" exit 1 fi # Test 3: Agent loading echo "Test 3: Testing agent load..." openclaw agents test "$AGENT_NAME" if [ $? -eq 0 ]; then echo "✅ Agent loads successfully" else echo "❌ Agent failed to load" exit 1 fi echo "🎉 All tests passed!" Error recovery: If automated tests fail: Review error messages, check file syntax, verify configuration If test script fails: Check script permissions, verify paths are correct ### Optional: systemd service configuration For production deployments, the agent can run as a systemd service: Service file example: # Create systemd service file sudo tee /etc/systemd/system/openclaw-agent.service > /dev/null < WorkingDirectory=/home//.openclaw ExecStart=/usr/bin/node /home//.npm-global/lib/node_modules/openclaw/dist/index.js Restart=always RestartSec=10 [Install] WantedBy=multi-user.target [Install] WantedBy=multi-user.target EOF Enable and start service: # Reload systemd configuration sudo systemctl daemon-reload # Enable service to start on boot sudo systemctl enable openclaw-agent.service # Start service now sudo systemctl start openclaw-agent.service # Check status sudo systemctl status openclaw-agent.service # View logs sudo journalctl -u openclaw-agent.service -f Error recovery: If service fails to start: Check journalctl logs, verify file paths, check user permissions If service crashes: Check OpenClaw logs, verify agent configuration, restart service If service wont enable: Check systemd configuration syntax, verify systemd is running ### Workflow: iterate on an existing agent When improving an existing agent, ask: What are the top 3 failure modes you have seen? (loops, overreach, verbosity, etc.) What autonomy changes do you want? Any new safety boundaries? Any changes to heartbeat behavior? Then propose targeted diffs to: SOUL.md (persona/tone/boundaries) AGENTS.md (operating rules + memory + delegation) HEARTBEAT.md (small checklist) Keep changes minimal and surgical. Error recovery: If diff application fails: Check file permissions, verify file exists, retry with backup If changes break agent behavior: Restore from git or backup, review changes If user rejects changes: Ask for clarification, propose alternative modifications ## Trust - Source: tencent - Verification: Indexed source record - Publisher: YKaiXu - Version: 1.0.3 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T01:42:56.169Z - Expires at: 2026-05-06T01:42:56.169Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/agent-builder-plus) - [Send to Agent page](https://openagent3.xyz/skills/agent-builder-plus/agent) - [JSON manifest](https://openagent3.xyz/skills/agent-builder-plus/agent.json) - [Markdown brief](https://openagent3.xyz/skills/agent-builder-plus/agent.md) - [Download page](https://openagent3.xyz/downloads/agent-builder-plus)