OpenClaw Prompting Guide

OpenClaw is not ChatGPT. You don't write prompts - you shape an agent. This guide covers SOUL.md, AGENTS.md, USER.md, memory, and the prompting techniques that actually matter.

Why OpenClaw Prompting Is Different

In ChatGPT, you write a prompt, get a response, and start over. Every conversation is a blank slate.

OpenClaw works differently. Your agent has persistent identity files that load every session. Instructions compound over time instead of resetting. Your agent remembers who it is, who you are, and what happened yesterday.

This means prompting OpenClaw is less about writing clever one-shot prompts and more about configuring a persistent system that gets better with every interaction. If you want to build a personal AI, understanding this difference is everything.

AspectChatGPT / ClaudeOpenClaw
InstructionsSystem prompt (resets each chat)Persistent files (SOUL.md, AGENTS.md)
MemoryLimited or noneMEMORY.md + daily memory files
Your contextRepeat every timeUSER.md (reads automatically)
PersonalityGeneric or custom GPTSOUL.md (fully customizable)
ToolsFixed pluginsSkills (SKILL.md files you can create)
ImprovementStarts fresh each chatCompounds across sessions

The Four Files That Shape Your Agent

SOUL.md
Who your agent is
Most Important

This is your agent's identity. Personality, tone, values, boundaries. Loaded at the start of every session.

# SOUL.md ## Personality You are direct, slightly sarcastic, and genuinely helpful. Skip the "Great question!" filler. Just answer. ## Tone Casual but competent. Talk like a smart friend, not a corporate chatbot. ## Boundaries - Private things stay private - Ask before sending emails or public messages - Never half-bake a reply

Start simple. You can always add more personality as you figure out what you like.

AGENTS.md
How your agent operates

The operating manual. Rules for memory, safety, file handling, group chat behavior, and external actions.

# Key rules in AGENTS.md ## Memory - Write daily notes to memory/YYYY-MM-DD.md - Curate important stuff into MEMORY.md ## Safety - trash > rm (recoverable beats gone forever) - Ask before sending external messages - Don't exfiltrate private data ## Group Chats - Don't respond to every message - Stay quiet when you have nothing to add
USER.md
Who you are

Your name, timezone, preferences, and context. So your agent knows you without you repeating yourself.

# USER.md - Name: Alex - Timezone: EST (UTC-5) - Preferred language: English - Notes: Prefers bullet points over paragraphs. Working on a SaaS startup. Uses Notion for docs.
MEMORY.md
What your agent remembers

Long-term memory that persists across sessions. The agent reads it on startup and updates it with important information.

# MEMORY.md ## Preferences - Alex prefers Claude for coding, Gemini for research - Likes concise responses, hates verbose explanations ## Projects - Working on "Launchpad" - SaaS for startups - Uses Next.js, Supabase, Vercel ## Important - Product launch date: March 15 - Investor meeting next Tuesday at 3 PM

You do not need to write this manually. Your agent builds it over time as you interact.

Prompting Techniques That Actually Work

1. Be Specific About Output Format
Bad

"Summarize this article"

Good

"Summarize this article in 3 bullet points. Include the main argument, one key stat, and the author's conclusion."

2. Give Context, Not Just Commands
Bad

"Write a cold email"

Good

"Write a cold email to a SaaS founder. I'm selling dev tools. Keep it under 100 words. Casual tone, no buzzwords."

3. Use "Remember This" for Important Context

Say "remember this" and OpenClaw writes it to memory. Next session, it already knows. "Remember: I prefer TypeScript over JavaScript" or "Remember: our API rate limit is 100 req/min."

4. Chain Tasks, Not Single Prompts

OpenClaw is an agent, not a chatbot. Give it multi-step tasks: "Research the top 5 competitors for our product, summarize their pricing, and save a comparison table to a file." It will execute all steps.

5. Tell It What NOT to Do

Negative instructions are powerful. "Don't use marketing language." "Don't explain what you're doing, just do it." "Don't ask for confirmation on file reads." Put recurring ones in SOUL.md so they apply every session.

SOUL.md Examples by Use Case

Use CasePersonalityKey Instructions
Developer assistantTechnical, concise, opinionated"Prefer TypeScript. Use functional patterns. No verbose explanations."
Business assistantProfessional, structured"Use bullet points. Include action items. Flag deadlines."
Creative writingExpressive, experimental"Take risks with language. Suggest unexpected angles. No cliches."
Crypto researchData-driven, cautious"Always include risk factors. No hype. Cite data sources."
Content creatorEngaging, audience-aware"Write for humans, not algorithms. Hook in first line."

Skills: Task-Specific Prompts

For recurring tasks, create custom skills. A skill is a SKILL.md file with task-specific instructions that the agent loads when relevant.

# SKILL.md - Blog Writer ## When to Use When asked to write a blog post or article. ## Instructions - Start with a hook, not a definition - Use short paragraphs (2-3 sentences max) - Include at least one real example - End with a clear CTA - No em dashes, no "in today's world"

Browse pre-built skills at Best OpenClaw Skills.

Common Prompting Mistakes

  • Being too vague - "help me with marketing" gives generic results. "Write 3 Twitter posts about our new feature launch, casual tone, under 280 chars" gets exactly what you need.
  • Overloading SOUL.md - start with 10-15 lines. A 500-line SOUL.md wastes tokens and confuses the model. Add rules only when you notice problems.
  • Not using memory - if you keep repeating the same context, tell the agent to remember it. That is literally what MEMORY.md is for.
  • Treating it like a search engine - do not ask "what is X?" when you want action. Ask "research X and save a summary to a file."
  • Ignoring USER.md - fill in your timezone and name at minimum. It makes every response more relevant.
  • Not iterating - if the first response is not right, refine. "Make it shorter." "More casual." "Add numbers." The agent adjusts instantly.

Advanced: Cron Prompts and Automation

The most powerful prompting in OpenClaw is not interactive - it is automated. Set up cron jobs with prompts that run on a schedule:

  • Morning brief: "Summarize my unread emails, today's calendar, and any crypto price alerts."
  • End of day: "Write today's memory file with what we worked on and any open tasks."
  • Weekly review: "Review this week's memory files and update MEMORY.md with anything worth keeping long-term."

These prompts run without you. Your agent works in the background, maintaining context and delivering updates to your phone via Telegram, WhatsApp, or Discord.

Quick Start: Your First 5 Minutes

  • Edit SOUL.md - add 3-5 lines about the personality you want
  • Edit USER.md - add your name and timezone
  • Start chatting - the agent reads your files automatically
  • Say "remember this" - when you share something important
  • Iterate - update SOUL.md when something annoys you

For the full setup, see the beginner guide. For advanced configuration, check the config reference. To pick the right model, see the AI model guide. To switch models, see how to change models.

Frequently Asked Questions

What is SOUL.md in OpenClaw?
SOUL.md defines your agent's personality, tone, and behavior guidelines. It is loaded at the start of every session. Think of it as your agent's identity - who it is and how it should act.
What is AGENTS.md?
AGENTS.md defines workspace rules - how the agent handles files, memory, safety, external actions, group chats, and tools. It is the operating manual for how the agent works in your environment.
What is USER.md?
USER.md stores information about you - your name, timezone, preferences, and context. The agent reads this to personalize responses without you repeating yourself every session.
How is OpenClaw prompting different from ChatGPT?
ChatGPT uses a single system prompt that resets each conversation. OpenClaw uses persistent files (SOUL.md, AGENTS.md, USER.md, MEMORY.md) that persist across sessions. Your instructions compound over time instead of resetting.
Can I change my agent's personality?
Yes. Edit SOUL.md in your workspace directory. Changes take effect on the next session. You can make your agent professional, casual, funny, direct, or anything you want.
What is MEMORY.md?
MEMORY.md is your agent's long-term memory. It stores curated information across sessions - decisions, preferences, project context. The agent reads and updates it to maintain continuity.
How do I give OpenClaw custom instructions?
Edit the workspace files: SOUL.md for personality, AGENTS.md for behavior rules, USER.md for your context. For task-specific instructions, use skills (SKILL.md files) or simply tell the agent in conversation.

Also Read

OpenClaw Skills: How to Build Your Own Custom Skill
Skills

OpenClaw Skills: How to Build Your Own Custom Skill

OpenClaw Configuration Guide for Beginners
Guide

OpenClaw Configuration Guide for Beginners

10 minMay 23, 2026
Best AI Model for OpenClaw: Compare Pricing & Features
Guide

Best AI Model for OpenClaw: Compare Pricing & Features

Michael Park

Written by

Michael Park

Senior Technical Writer & DevRel

Michael creates comprehensive installation and setup guides for developers and system administrators. With experience across Linux, macOS, Windows, and embedded systems, he has written over 200 technical tutorials used by millions of developers. He focuses on clear, step-by-step instructions that work the first time, covering everything from Raspberry Pi to enterprise servers.

Shape your AI agent

OpenClaw is an agent you configure, not a chatbot you prompt. Start with a free trial and build your perfect assistant.

Start Free Trial