# Clone the repository
git clone https://github.com/mergisi/awesome-openclaw-agents.git
cd awesome-openclaw-agents

# Install quickstart dependencies
cd quickstart
npm install

# Copy a template SOUL.md
cp ../agents/productivity/orion/SOUL.md ./SOUL.md

# Start the agent
node bot.js

awesome-openclaw-agents/
├── agents/                    # 205+ agent templates organized by category
│   ├── productivity/          # Task management, email, habits
│   ├── development/           # Code review, docs, bug hunting
│   ├── marketing/             # Content, SEO, social media
│   ├── business/              # Sales, finance, HR
│   ├── devops/                # CI/CD, monitoring, infrastructure
│   └── ...                    # 19 more categories
├── quickstart/                # Minimal Node.js bot runner
├── skills/                    # On-device skills for Gemma & Claude Code
├── use-cases/                 # 132 real-world examples
├── agents.json                # Machine-readable catalog
└── TROUBLESHOOTING.md         # Known issues & recovery

# Agent Name

**Role**: {one-line role description}

**Goals**:
- Primary objective
- Secondary objectives
- Success metrics

**Backstory**: {agent's personality and expertise}

**Tools**: {comma-separated list of capabilities}
- tool_name: description

**Guardrails**:
- What the agent should NOT do
- Security boundaries
- Escalation triggers

**Memory**:
- Conversation history depth
- Key facts to remember
- User preferences

**Triggers**:
- Event patterns that activate this agent
- Scheduling (if applicable)

**Output Format**:
- Preferred response structure
- Notification channels

# List all productivity agents
ls agents/productivity/

# View a specific template
cat agents/productivity/orion/SOUL.md

# Search by topic (e.g., "code review")
grep -r "code review" agents/development/

# Copy to your project
cp agents/development/code-reviewer/SOUL.md ./my-agents/SOUL.md

# Or use multiple agents
mkdir -p ./my-agents
cp agents/productivity/orion/SOUL.md ./my-agents/orion.md
cp agents/development/bug-hunter/SOUL.md ./my-agents/debug.md

# Edit SOUL.md to match your needs

**Role**: Senior Code Reviewer specializing in TypeScript and React

**Goals**:
- Review PRs within 2 hours
- Flag security vulnerabilities
- Suggest performance improvements
- Maintain 95% approval rating

**Tools**: github, eslint, typescript-analyzer, security-scanner

**Guardrails**:
- Never auto-merge without human approval on main branch
- Escalate if >500 lines changed
- Require tests for new features

// quickstart/bot.js example
const { OpenClaw } = require('openclaw-sdk');

const agent = new OpenClaw({
  soulPath: './SOUL.md',
  provider: 'anthropic', // or 'openai', 'ollama', etc.
  apiKey: process.env.ANTHROPIC_API_KEY,
  model: 'claude-3-5-sonnet-20241022'
});

// Start listening
agent.on('message', async (msg) => {
  const response = await agent.process(msg);
  console.log(response);
});

agent.start();

# Standup

**Role**: Daily standup coordinator

**Goals**:
- Collect standup updates from team by 10am
- Generate summary for async teams
- Track blockers and escalate

**Tools**: slack, jira, calendar

**Triggers**:
- Schedule: "weekdays at 9:00 AM"
- Manual: "/standup start"

**Output Format**:

undefined

# Lens (Code Reviewer)

**Role**: Senior code reviewer with security focus

**Goals**:
- Review all PRs within 30 minutes
- Catch security vulnerabilities before merge
- Maintain code quality standards
- Provide constructive feedback

**Tools**: github, eslint, sonarqube, snyk

**Guardrails**:
- Never approve PRs that introduce CVEs
- Escalate if test coverage drops below 80%
- Require two human approvals for auth changes

**Triggers**:
- GitHub webhook: pull_request.opened
- GitHub webhook: pull_request.synchronize

**Output Format**:
✅ **APPROVED** | ⚠️ **CHANGES REQUESTED** | ❌ **BLOCKED**

**Summary**: {one-line verdict}

**Security**: {findings}
**Performance**: {findings}
**Style**: {suggestions}

# Echo (Content Writer)

**Role**: SEO-focused content writer

**Goals**:
- Generate blog posts from topics
- Optimize for target keywords
- Include internal links
- Match brand voice

**Tools**: openai, serp-api, wordpress, grammarly

**Backstory**: I'm a content strategist who's written 500+ articles...

**Output Format**:
# {SEO Title}

{Hook paragraph}

## {H2 Section}
{Content with keyword density 1-2%}

**Meta Description**: {155 chars}
**Keywords**: {comma-separated}
**Internal Links**: {3-5 suggestions}

// Use multiple agents together
const crew = new OpenClaw.Crew({
  agents: [
    { soul: './agents/orion.md', role: 'manager' },
    { soul: './agents/lens.md', role: 'reviewer' },
    { soul: './agents/scribe.md', role: 'writer' }
  ],
  process: 'sequential' // or 'hierarchical', 'consensus'
});

// Manager delegates to reviewers and writers
const result = await crew.execute({
  task: 'Review PR #123 and update documentation'
});

# .env file
OPENCLAW_PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-...

# Optional: CrewClaw for no-code deploys
CREWCLAW_API_KEY=cc_...

# Tool integrations
GITHUB_TOKEN=ghp_...
SLACK_BOT_TOKEN=xoxb-...
JIRA_API_TOKEN=...

# Model routing (optional)
OLLAMA_HOST=http://localhost:11434
OPENAI_API_KEY=sk-...

# Register an agent
openclaw agents add ./SOUL.md

# List registered agents
openclaw agents list

# Start gateway
openclaw gateway start

# Run a one-off task
openclaw run --agent=orion --task="Prioritize today's tasks"

# Deploy to CrewClaw (optional)
crewclaw deploy --agent=./SOUL.md --platform=docker

# Start with a template
cp agents/productivity/orion/SOUL.md ./my-pm-agent.md

# Edit key sections
vim my-pm-agent.md

# Test locally
node quickstart/bot.js --soul=./my-pm-agent.md

// Sequential workflow: bug hunter → code reviewer → PR merger
const pipeline = [
  { agent: 'bug-hunter', input: 'github_issue' },
  { agent: 'code-reviewer', input: 'pull_request' },
  { agent: 'pr-merger', condition: 'approved' }
];

await crew.executePipeline(pipeline, { issueId: 456 });

# My Custom Agent

**Role**: {specific role}

**Goals**:
- Goal 1 with measurable outcome
- Goal 2
- Goal 3

**Backstory**: {1-2 paragraphs establishing expertise}

**Tools**: {comma-separated, be specific}
- tool_name: what it does
- another_tool: its purpose

**Guardrails**:
- Security boundary
- Escalation rule
- Error handling

**Memory**:
- Retain: user preferences, past decisions
- Forget: sensitive data after task complete

**Triggers**:
- Event: when to activate
- Schedule: (if recurring)

**Output Format**:
{Show exact structure with examples}

const express = require('express');
const app = express();

app.post('/webhook/github', async (req, res) => {
  const { action, pull_request } = req.body;
  
  if (action === 'opened' || action === 'synchronize') {
    const reviewer = new OpenClaw({ soulPath: './agents/development/code-reviewer/SOUL.md' });
    
    const review = await reviewer.process({
      prNumber: pull_request.number,
      files: pull_request.changed_files,
      diff: await fetchDiff(pull_request.diff_url)
    });
    
    await postGitHubComment(pull_request.number, review);
  }
  
  res.status(200).send('OK');
});

const { WebClient } = require('@slack/web-api');
const slack = new WebClient(process.env.SLACK_BOT_TOKEN);

const standup = new OpenClaw({ soulPath: './agents/productivity/daily-standup/SOUL.md' });

// Every weekday at 9 AM
cron.schedule('0 9 * * 1-5', async () => {
  const channel = 'C01234567'; // #engineering
  
  await slack.chat.postMessage({
    channel,
    text: '🌅 Time for standup! Reply with: Done | Doing | Blockers'
  });
  
  // Collect responses for 1 hour
  setTimeout(async () => {
    const messages = await fetchStandupReplies(channel);
    const summary = await standup.process({ messages });
    
    await slack.chat.postMessage({
      channel,
      text: summary,
      thread_ts: originalMessage.ts
    });
  }, 60 * 60 * 1000);
});

const { gmail } = require('googleapis').google.gmail('v1');

const inbox = new OpenClaw({ soulPath: './agents/productivity/inbox-zero/SOUL.md' });

async function processInbox() {
  const messages = await gmail.users.messages.list({
    userId: 'me',
    q: 'is:unread',
    maxResults: 50
  });
  
  for (const msg of messages.data.messages) {
    const email = await gmail.users.messages.get({ userId: 'me', id: msg.id });
    
    const triage = await inbox.process({
      subject: email.payload.headers.find(h => h.name === 'Subject').value,
      from: email.payload.headers.find(h => h.name === 'From').value,
      body: email.snippet
    });
    
    // Apply label based on triage
    if (triage.action === 'archive') {
      await gmail.users.messages.modify({
        userId: 'me',
        id: msg.id,
        resource: { removeLabelIds: ['UNREAD'] }
      });
    }
  }
}

# Check gateway status
openclaw gateway status

# Verify SOUL.md syntax
openclaw validate ./SOUL.md

# Check logs
tail -f ~/.openclaw/logs/gateway.log

// Add rate limiting to agent
const agent = new OpenClaw({
  soulPath: './SOUL.md',
  rateLimit: {
    maxRequests: 100,
    perMinutes: 1
  }
});

# In SOUL.md, add error handling

**Guardrails**:
- If GitHub API fails, retry 3x with exponential backoff
- If Slack is down, queue messages for later
- If critical tool unavailable, escalate to human

# 1. Find template
cat agents/development/code-reviewer/SOUL.md

# 2. Customize
cp agents/development/code-reviewer/SOUL.md ./my-reviewer.md
vim my-reviewer.md  # Edit goals, tools, guardrails

# 3. Test locally
cd quickstart
npm install
node bot.js --soul=../my-reviewer.md

# 4. Register
openclaw agents add ../my-reviewer.md --name=my-reviewer

# 5. Start gateway
openclaw gateway start

# 6. Integrate
# Add webhook handler for GitHub PRs

# 7. Monitor
tail -f ~/.openclaw/logs/my-reviewer.log

# 8. Deploy (optional)
crewclaw deploy --agent=../my-reviewer.md --platform=railway