Skip to content

faheemazizm/openclaw-boilerplate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

OpenClaw Personal AI Assistant — Boilerplate

A ready-to-customize starter kit for running your own AI assistant with OpenClaw.

What You Get

  • A personal AI assistant accessible via Discord, Telegram, or web
  • Long-term memory across sessions
  • Customizable personality and skills
  • Free-tier model support (Groq, Cerebras, OpenRouter)

Quick Start

1. Install OpenClaw

npm install -g openclaw

2. Run the Setup Wizard

openclaw onboard

This walks you through:

  • Choosing your AI provider (Anthropic, OpenAI, Groq, etc.)
  • Connecting Discord/Telegram (optional)
  • Setting up your workspace

3. Customize Your Assistant

Edit the files in your workspace (created during onboard):

~/.openclaw/workspaces/<your-workspace>/
├── AGENTS.md      ← How your agent behaves (read this first)
├── SOUL.md        ← Personality, name, tone, directives
├── USER.md        ← Info about you (name, timezone, preferences)
├── TOOLS.md       ← Local notes (SSH hosts, device names, etc.)
├── HEARTBEAT.md   ← Periodic tasks checklist
├── MEMORY.md      ← Long-term memory (auto-maintained)
└── memory/        ← Daily session logs

4. Start the Gateway

openclaw gateway start

Files Explained

SOUL.md — Who Your Agent Is

# My Assistant

**Name:** Atlas
**Role:** Personal AI assistant
**Personality:** Friendly, concise, proactive

## What I Do
- Answer questions and research topics
- Manage tasks and reminders
- Monitor emails and calendar
- Help with coding and writing

## What I Don't Do
- Share private data with anyone
- Run destructive commands without asking
- Send messages on your behalf without permission

USER.md — Who You Are

# About Me
- **Name:** Your Name
- **Timezone:** Your/Timezone
- **Notes:** Whatever helps your assistant understand you

HEARTBEAT.md — Periodic Checks

# Heartbeat Tasks
- [ ] Check for unread emails
- [ ] Review calendar for upcoming events
- [ ] Any pending reminders?

Connecting Discord

  1. Go to Discord Developer Portal
  2. Create a New Application → Bot
  3. Copy the bot token
  4. Run: openclaw wizard discord
  5. Invite bot to your server using the OAuth2 URL

Connecting Telegram

  1. Message @BotFather on Telegram
  2. Create a new bot, get the token
  3. Run: openclaw wizard telegram

Free Model Options

Provider Model Cost Notes
Groq Llama 3.3 70B Free Fast, good quality
Cerebras GPT-OSS 120B Free Large context
OpenRouter Various free models Free Many options
Ollama Local models Free Runs on your machine

Set your model in the config:

openclaw config set defaultModel groq/llama-3.3-70b-versatile

Useful Commands

openclaw status          # Check everything is running
openclaw gateway start   # Start the gateway daemon
openclaw gateway stop    # Stop it
openclaw gateway restart # Restart after config changes
openclaw doctor          # Diagnose issues
openclaw memory search "query"  # Search your memory

Tips

  • Config changes need a gateway restart to take effect
  • Memory files are your continuity — the agent reads them every session
  • HEARTBEAT.md runs every 30 min — use it for recurring checks
  • Skills extend your agent — browse ClawHub for community skills

Resources


Built with ❤️ by MedGate Holdings

About

Ready-to-customize OpenClaw personal AI assistant starter kit

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors