openclaw-agent-template/README.md

OpenClaw Agent Template

A starter kit for creating a new OpenClaw agent in 5 minutes.

What's This?

When you set up OpenClaw, you need a workspace with a bunch of files that define your agent's identity, memory, and behavior. This template gives you a clean starting point.

Quick Start

# 1. Clone this repo
git clone https://github.com/dtzp555-max/openclaw-agent-template my-agent
cd my-agent

# 2. Copy files to your agent workspace
cp -r . ~/.openclaw/workspaces/my-agent/

# 3. Edit the placeholder files
#    - IDENTITY.md  → your agent's name, vibe, emoji
#    - USER.md      → info about the person the agent helps
#    - SOUL.md      → behavioral guidelines (customize or leave as-is)

# 4. Register the agent in openclaw.json and reload gateway
openclaw gateway reload

Files

File	Purpose
SOUL.md	Agent's behavioral DNA — persona, tone, continuity rules
IDENTITY.md	Name, creature type, vibe, emoji
USER.md	Info about the human the agent is helping
AGENTS.md	Workspace rules (session startup, memory, safety)
MEMORY.md	Long-term curated memory (persists across sessions)
TOOLS.md	Notes on local tools and setup specifics
memory/CURRENT_STATE.md	Short-term task state (In Flight / Blocked / Next)

FAQ

How is this different from just creating files manually? It's not — this just saves you 20 minutes of copy-pasting from docs.

Do I need all these files? SOUL.md is the most important. The others are optional but help the agent stay focused.

How do I add a Telegram bot? Get a bot token from @BotFather, then add it to your openclaw.json under accounts.