openclaw agents add: The Complete Command Guide

$ openclaw agents add seo-analyst --workspace ./agents/seo-analyst

# Behind the scenes:
# 1. Validates workspace path exists
# 2. Checks for SOUL.md in the workspace
# 3. Writes to ~/.openclaw/registry.json:
#    { "name": "seo-analyst", "workspace": "/abs/path/agents/seo-analyst", ... }
# 4. Confirms: "Agent 'seo-analyst' registered successfully"

# You still need to restart the gateway:
$ openclaw gateway restart

openclaw agents add <agent-name> [options]

Arguments:
  agent-name            Required. Unique name for the agent.
                        Use lowercase letters and hyphens only.
                        Examples: seo-analyst, content-writer, data-reporter

Options:
  --workspace <path>    Path to the agent's workspace directory.
                        Must contain a valid SOUL.md file.
                        Can be relative or absolute.
                        Default: ./agents/<agent-name>

  --model <provider>    Model provider for this agent.
                        Accepted values: anthropic, openai, google, ollama
                        Default: inherits workspace-level default

  --non-interactive     Skip all confirmation prompts.
                        Required when adding agents in scripts.

  --channel <channel>   Bind agent to a specific communication channel
                        (e.g., a Telegram chat ID or Slack channel name).

  --help                Show help for this command.

# Minimal usage — workspace defaults to ./agents/seo-analyst
openclaw agents add seo-analyst

# Explicit workspace path
openclaw agents add seo-analyst --workspace ./agents/seo-analyst

# Specify model provider
openclaw agents add researcher --workspace ./agents/researcher --model ollama

# Skip confirmation prompts (for scripts)
openclaw agents add pm --workspace ./agents/pm --non-interactive

# Bind to a Telegram channel
openclaw agents add support-bot --workspace ./agents/support --channel 8267922725

# Full example with all common flags
openclaw agents add content-writer   --workspace ./agents/content-writer   --model anthropic   --non-interactive

# SEOAnalyst

## Role
You are an SEO analyst. You research keywords, audit content,
and provide actionable recommendations to improve organic rankings
for SaaS products and developer tools.

## Personality
- Analytical, precise, data-driven
- Back every recommendation with a reason
- Never guess — if you do not know, say so

## Rules
- ALWAYS respond in English
- ALWAYS provide search volume context for keyword recommendations
- NEVER suggest tactics that violate Google Webmaster Guidelines
- Keep responses scannable: use bullet points and headers
- Limit to 3 priority recommendations per audit

## Expertise
- Technical SEO: Core Web Vitals, structured data, crawlability
- Content SEO: keyword mapping, topical authority, content gaps
- Competitive analysis: SERP feature opportunities, competitor weaknesses

## Tools — USE THEM
- Use Browser to check current SERPs before making recommendations
- Use Slack to share audit reports with the team

## Handoffs
- Pass keyword research to @ContentWriter when brief is ready
- Escalate technical issues to @DevOps

#!/bin/bash
set -e

AGENTS=(
  "pm"
  "content-writer"
  "seo-analyst"
  "researcher"
  "social-media"
)

echo "Creating workspace directories..."
for agent in "${AGENTS[@]}"; do
  mkdir -p "agents/$agent"
  echo "Created agents/$agent/"
done

echo ""
echo "Registering agents..."
for agent in "${AGENTS[@]}"; do
  openclaw agents add "$agent" \
    --workspace "./agents/$agent" \
    --non-interactive
  echo "Registered: $agent"
done

echo ""
echo "All agents registered. Restarting gateway..."
openclaw gateway restart

echo ""
echo "Done. Verify with: openclaw agents list"

chmod +x setup-agents.sh
./setup-agents.sh

# Then check the result
openclaw agents list

# Remove an agent from the registry (does NOT delete files)
openclaw agents remove seo-analyst

# Confirm it is gone
openclaw agents list

# Re-register with a new name or path
openclaw agents add seo-expert   --workspace ./agents/seo-analyst   --non-interactive

# Restart to apply changes
openclaw gateway restart

# Step 1: Remove from registry
openclaw agents remove old-agent

# Step 2: Delete workspace files
rm -rf agents/old-agent

# Step 3: Restart gateway
openclaw gateway restart

# Content writer on Claude (best for nuanced writing)
openclaw agents add content-writer   --workspace ./agents/content-writer   --model anthropic   --non-interactive

# Data analyst on GPT-4o (strong at code and structured output)
openclaw agents add data-analyst   --workspace ./agents/data-analyst   --model openai   --non-interactive

# Research agent on local Ollama (free, no API cost)
openclaw agents add researcher   --workspace ./agents/researcher   --model ollama   --non-interactive

# Restart to activate all three
openclaw gateway restart

# List all registered agents with paths and status
openclaw agents list

# Check the gateway knows about all agents
openclaw gateway status

# Remove a specific agent
openclaw agents remove old-agent-name

# Re-register an agent whose workspace path changed
openclaw agents remove seo-analyst
openclaw agents add seo-analyst   --workspace /new/absolute/path/agents/seo-analyst   --non-interactive

# Restart after any registry changes
openclaw gateway restart

# Clear stale sessions for all agents
rm ~/.openclaw/agents/*/sessions/sessions.json