A Guide by The Operator Vault

OpenClaw Prompts and Templates Library

Copy. Customize. Deploy. Ready-to-use instructions for your AI agent.

OpenClaw uses plain markdown files to control agent behavior. No GUI builders, no drag-and-drop, no vendor lock-in. Just files you own and can edit with any text editor. This guide explains the prompt system and gives you templates to start with.

~/.openclaw/workspace/
SOUL.md
AGENTS.md
IDENTITY.md
USER.md
HEARTBEAT.md
BOOT.md

The prompt architecture

How OpenClaw prompts work

Most AI tools bury your prompt settings behind a dashboard. OpenClaw takes the opposite approach. Every instruction your agent follows lives in a markdown file you control. There are no hidden system prompts. What you write is what your agent reads.

Files, Not Forms

Your agent's instructions live in markdown files inside your workspace directory. Edit them with VS Code, Vim, Obsidian, or any text editor. Version-control them with Git. Share them with your team by pushing to a repo.

Layered Configuration

Each file controls a different aspect of agent behavior. SOUL.md sets the personality. AGENTS.md provides task instructions. IDENTITY.md defines who the agent is. They layer together to create a complete agent persona.

Instant Updates

Edit a file. Start a new conversation. Your changes are live. No deployment pipeline, no waiting for caches to clear, no restarting services. The agent reads fresh instructions at the start of every chat.

The core files

The 5 prompt files that matter

OpenClaw supports several prompt files, but these five do the heavy lifting. Master these and you control 90% of your agent's behavior.

SOUL.md
Personality and values

Defines the agent's temperament, communication style, ethical boundaries, and behavioral traits. Think of it as the agent's character. A formal SOUL.md produces formal responses. A casual one produces casual responses.

# Soul

You are precise, helpful, and direct.
You prefer short answers over long ones.
When uncertain, say so honestly.
Never fabricate data or sources.
AGENTS.md
Task instructions

Provides the specific instructions for how the agent handles tasks. This is where you define workflows, standard operating procedures, and decision trees. You can create multiple agent files (AGENTS.sales.md, AGENTS.support.md) for different roles.

# Default Agent

When given a task:
1. Confirm you understand the goal
2. Break it into steps
3. Execute each step
4. Report what you did

Always ask before taking actions
that cannot be undone.
IDENTITY.md
Who the agent is

Defines the agent's name, role, and organizational context. This gives the agent a consistent identity across conversations. Useful when the agent needs to introduce itself or sign messages.

# Identity

Name: Atlas
Role: Operations Assistant
Org: Acme Corp
Timezone: US/Pacific

You work for the operations team.
Your manager is Sarah Chen.
USER.md
Context about the human

Provides context about you, the operator. Your preferences, your business, your tools. The more context you give, the fewer times you need to repeat yourself. The agent references this file to personalize every response.

# User Context

Name: Kevin
Business: SaaS, B2B
Stack: Next.js, Vercel, Stripe
Preferences:
- Concise responses
- Use bullet points
- No emojis in work output
HEARTBEAT.md
Autonomous behavior

Defines what the agent does on its own, without being prompted. Set up recurring checks, periodic summaries, or automated workflows that run in the background. This is the foundation of truly autonomous agent operation.

# Heartbeat

Every 30 minutes:
- Check inbox for urgent emails
- Summarize any new messages
- Post digest to #updates channel

Every morning at 8am:
- Generate daily task summary
- Check calendar for conflicts

Also available: BOOT.md runs once on first startup (great for initial setup tasks). BOOTSTRAP.md runs when initializing a new workspace. These are optional and most users do not need them when getting started.

Copy and customize

Ready-to-use templates

We've tested and refined these templates across hundreds of real workflows. Copy the snippet, paste it into your AGENTS.md, and customize the details for your business. Each template is designed to work with the bundled skills.

Lead Qualification Bot

Trigger: New message in #leads channel

Reads inbound leads from Slack or email, scores them against your ICP criteria, and routes high-quality leads to your sales channel with a summary. Low-quality leads get a polite auto-response.

## Lead Qualification

When a new lead appears:
1. Extract: name, company, role, message
2. Score against ICP criteria:
   - Company size > 10 employees
   - B2B SaaS or ecommerce
   - Mentioned a specific pain point
3. If score >= 2/3, post to #qualified
   with summary and recommended action
4. If score < 2/3, draft a polite
   acknowledgment for review

Customer Support Triage

Trigger: New support ticket via email

Categorizes incoming support requests by urgency and type, drafts initial responses using your knowledge base, and escalates critical issues to the right team member.

## Support Triage

For each new support message:
1. Classify urgency: critical/high/normal
2. Classify type: bug/question/feature
3. Search knowledge base for solution
4. If solution found:
   - Draft response with source link
   - Queue for human review
5. If critical + no solution:
   - Escalate immediately to #urgent
   - Tag on-call team member
6. Never promise timelines or refunds

Content Repurposer

Trigger: On demand or scheduled

Takes a long-form piece (blog post, transcript, report) and generates platform-specific versions for social media, email newsletters, and short-form content.

## Content Repurposing

Given a source document:
1. Identify 3-5 key takeaways
2. Generate for each platform:
   - Twitter thread (5-8 tweets)
   - LinkedIn post (professional tone)
   - Email newsletter section (150 words)
   - Short summary (50 words)
3. Preserve original voice and claims
4. Add relevant hashtags per platform
5. Save all versions to Notion

Daily Report Generator

Trigger: Every morning at 8am via HEARTBEAT.md

Compiles data from multiple sources into a daily summary. Checks email, Slack, project management tools, and calendar, then delivers a structured morning briefing.

## Daily Report

Every morning at 8:00 AM:
1. Check inbox for overnight emails
2. Scan Slack for unread mentions
3. Review calendar for today's meetings
4. Compile into morning briefing:
   - Urgent items requiring action
   - New messages needing response
   - Today's schedule + prep notes
   - Yesterday's unfinished tasks
5. Post briefing to #daily-digest
6. Keep it under 300 words

Email Follow-up Sequence

Trigger: After initial outreach (3-day, 7-day, 14-day)

Manages a follow-up sequence for outbound emails. Checks for replies, adjusts tone based on engagement signals, and stops the sequence when a response is received.

## Follow-up Sequence

Track outreach in Notion database.
For each contact without a reply:

Day 3 - Gentle bump:
  "Quick follow-up on my note from
   [date]. Worth a 10-min chat?"

Day 7 - Value add:
  Share relevant resource or insight
  related to their specific challenge

Day 14 - Final touch:
  "Closing the loop. Happy to
   reconnect when timing is better."

Stop sequence immediately on reply.
Log all interactions in Notion.

Data Extraction Pipeline

Trigger: On demand or new file upload

Extracts structured data from unstructured sources like PDFs, web pages, and documents. Normalizes the output into a consistent format and loads it into your chosen destination.

## Data Extraction

When given a document or URL:
1. Identify the data type:
   invoice, contract, report, listing
2. Extract fields into structured JSON:
   - dates, amounts, names, addresses
   - line items, totals, references
3. Validate: flag missing/suspicious data
4. Output as clean JSON or CSV
5. Log extraction to Notion database
   with source link and confidence score
6. If confidence < 80%, flag for review

How to use these templates: Copy any snippet above and paste it into your AGENTS.md file. Customize the specifics (channel names, criteria, output formats) for your business. The agent will follow these instructions the next time you start a conversation.

Writing effective prompts

6 principles for better prompts

We've written thousands of prompt instructions across dozens of use cases. These six principles consistently produce the best results.

01

Be Specific, Not Vague

Vague instructions produce vague results. Instead of 'be helpful,' specify exactly what helpful means in your context. The more precise your instructions, the more consistent the agent's output.

Bad: "Respond to customer emails." Good: "Respond to customer emails within 2 hours. Use first name. Acknowledge their issue before offering a solution. Keep responses under 150 words."
02

Use Examples and Templates

Show the agent what good output looks like. Include example responses, formatted outputs, or template structures directly in your prompt files. Agents learn better from examples than from abstract descriptions.

Include a "## Example Response" section in your AGENTS.md with 2-3 sample outputs. The agent will match the format, tone, and length of your examples.
03

Set Clear Boundaries

Tell the agent what NOT to do. Boundaries prevent costly mistakes. Define actions that require human approval, topics to avoid, and limits on what the agent can promise or commit to.

"Never promise delivery dates. Never approve refunds over $50 without human review. Never share internal pricing formulas. Always escalate legal questions."
04

Define Output Formats

Specify how you want the output structured. Bullet points? JSON? Paragraphs? Table? When the agent knows the expected format, it delivers cleaner results with less back-and-forth.

"Format all reports as: Summary (2 sentences), Key Findings (bullet points), Recommended Actions (numbered list), Raw Data (JSON block at the end)."
05

Handle Edge Cases Explicitly

Think about what could go wrong. What if the data is missing? What if the email is spam? What if the request is outside scope? Adding error handling instructions prevents the agent from making bad decisions when things are not straightforward.

"If the PDF has no extractable text, note it as image-only and skip extraction. If the email is clearly spam, archive it silently. If the request is outside your skill set, say so."
06

Iterate Based on Real Output

Your first prompt draft will not be perfect. Run it through real scenarios, review the output, and tighten the instructions where the agent drifts. The best prompts are refined over weeks, not written in one sitting.

Keep a running log of cases where the agent's output surprised you. Each surprise is a signal that your instructions need clarification in that specific area.

Get started in the workshop

The workshop includes ready-to-use templates for your first workflow. In 15 minutes, you'll have OpenClaw installed, your prompt files configured, your first channel connected, and a working automation running.

Start the $19 Workshop

Organization tips

Organizing prompts for real workflows

As you build more automations, your prompt files grow. Here is how we keep things organized across multiple workflows and team members.

One AGENTS File Per Role

Create AGENTS.sales.md for your sales workflow, AGENTS.support.md for support, and AGENTS.content.md for content creation. Swap between them by renaming or symlinking to AGENTS.md. This keeps instructions focused and avoids bloated files.

Version Control Everything

Commit your prompt files to Git. Track changes over time. Roll back when a prompt edit makes things worse. Share across team members by pulling from a shared repo. Prompts are code, so treat them like code.

Keep SOUL.md Stable

Your SOUL.md should rarely change once dialed in. It defines personality, not procedures. If you find yourself editing SOUL.md frequently, the instructions probably belong in AGENTS.md instead.

Document Your USER.md

The more context you put in USER.md, the fewer times you repeat yourself in conversations. Include your tech stack, your preferences, your team structure, and your communication style. Update it quarterly.

Recommended workspace structure
~/.openclaw/workspace/
  SOUL.md                # Personality (stable)
  IDENTITY.md            # Agent identity
  USER.md                # Your context
  HEARTBEAT.md           # Autonomous tasks

  # Role-specific agent files
  AGENTS.md              # Active agent (symlink)
  AGENTS.sales.md        # Sales workflow
  AGENTS.support.md      # Support workflow
  AGENTS.content.md      # Content workflow

  # Shared resources
  templates/
    email-templates.md   # Reusable email formats
    report-format.md     # Standard report structure
Premium prompt packs

Pre-built prompts for every business type

Our premium skill packs include optimized prompt templates alongside matching skills and credential configs. Each pack is tested across real business workflows. You get AGENTS.md files, SOUL.md presets, template libraries, and step-by-step setup guides.

Complete prompt filesMatching skill configsSetup documentation
>_Browse Premium Packs

Avoid these

Common prompt mistakes

We see these patterns in almost every new user's prompt files. Fixing them usually produces an immediate improvement in agent output quality.

Overloading SOUL.md

Keep personality traits in SOUL.md. Move task instructions to AGENTS.md. If your SOUL.md is longer than 300 words, it is probably doing double duty.

Being Too Vague

"Handle emails well" tells the agent nothing. "Respond to customer emails within 2 hours, use first name, keep under 150 words" gives it a clear playbook.

Skipping USER.md

Without USER.md, the agent asks the same clarifying questions every conversation. Spend 10 minutes filling in your context once. Save hours of repetition forever.

No Error Handling

Your prompts should cover what to do when things go wrong. What if the API returns an error? What if the data is missing? The agent follows your instructions literally.

Giant Monolithic Files

A 2,000-word AGENTS.md with every workflow crammed in leads to inconsistent results. Break it into role-specific files and swap as needed.

Never Iterating

Your first draft is a starting point. Review the agent's output weekly, note where it drifts, and tighten the instructions. Great prompts are refined, not written.

Keep going

Related guides

Skills Guide
Install and manage skills for your agent
ClawHub Guide
Browse the skill marketplace
Build Custom Skills
Create your own skills from scratch
What is OpenClaw?
New here? Start with the fundamentals
Security Guide
Best practices for safe agent operation
Use Cases
Real business workflows in action

Prompts FAQ

Everything you want to know about prompts.

Kevin Jeppesen, Founder of The Operator Vault

Written by

Kevin Jeppesen

Founder, The Operator Vault

Kevin is an early OpenClaw adopter who has saved an estimated 400 to 500 hours through AI automation. He stress-tests new workflows daily, sharing what actually works through step-by-step guides and a security-conscious approach to operating AI with real tools.

Ready to put your
prompts to work?

Premium skill packs include optimized prompt templates, matching skills, and step-by-step setup guides. Or start with the $19 workshop to get the fundamentals right.

>_Browse Premium Skill PacksStart the $19 Workshop