agent-builder-plus

LeoYeAI/openclaw-master-skillsCoding AgentsAudit pendingSnapshot 2f858c3e0aba

Summary

This source did not publish a separate summary. Review SKILL.md before using the skill.

SKILL.md

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

Workflow: build an agent from scratch

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.

# 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

# List all agents and their bindings
openclaw agents list

# Check which channels are already in use
openclaw channels list

# Backup openclaw.json before modification
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

# Add agent to OpenClaw configuration
openclaw agents add <agent-name> --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

# 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"
  }
}

# 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"

# 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": [...]
      }
    }
  }
}

# Edit auth-profiles.json for the agent
# Location: ~/.openclaw/agents/<agent-name>/agent/auth-profiles.json

# Example structure:
{
  "custom-provider": {
    "apiKey": "key_id:secret",
    "baseUrl": "https://api.example.com/v1"
  }
}

⚠️ Agent failed before reply: No API key found for provider "provider-name"

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

Verify workspace files exist:
```
ls -la /path/to/workspace/
```
Check agent configuration:
```
openclaw agents list
```
Test agent loading:
```
openclaw agents test <agent-name>
```
Check OpenClaw logs:
```
openclaw logs --follow
```

Re-read file to get exact content:
```
read /path/to/file.md
```

Use unique markers for large sections:

<!-- SECTION_START -->
[content]
<!-- SECTION_END -->

Match whitespace exactly (copy from file read)
Use smaller oldText for more precise matching

# 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 <agent-name>

# Run OpenClaw's built-in agent tests
openclaw agents test <agent-name> --verbose

# Test workspace file syntax
openclaw validate workspace /path/to/workspace

# Test configuration loading
openclaw config test

#!/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!"

# Create systemd service file
sudo tee /etc/systemd/system/openclaw-agent.service > /dev/null <<EOF
[Unit]
Description=OpenClaw Agent Service
After=network.target

[Service]
Type=simple
User=<your-username>
WorkingDirectory=/home/<your-username>/.openclaw
ExecStart=/usr/bin/node /home/<your-username>/.npm-global/lib/node_modules/openclaw/dist/index.js
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target


[Install]
WantedBy=multi-user.target
EOF

# 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

agent-builder-plus

Summary

SKILL.md

Agent Builder Plus (OpenClaw)

Quick Start

Canonical references

Workflow: build an agent from scratch

Phase 1 - Interview (ask clarifying questions)

Phase 2 - Generate workspace files

Phase 2.5 - Register agent with OpenClaw

Phase 2.6 - Verify configuration

Phase 3 - Guardrails checklist

Phase 4 - Acceptance tests (fast)

Phase 8 - Automated testing (optional)

Optional: systemd service configuration

Workflow: iterate on an existing agent

Related skills