toneclone
// Write like the user, not like AI. ToneClone trains on the user's actual writing to generate content in their authentic voice — not just humanized, but personalized. Use for: drafting emails, messages, social posts, marketing copy, documentation in the user's voice; AI humanizer alternative that soun
ToneClone Skill
Generate content in the user's authentic voice — beyond generic AI, beyond humanizers, actually them.
Key differentiator: Most AI sounds like AI. Humanizers make it sound generic-human. ToneClone makes it sound like this specific person.
CLI
toneclone
Installation
Homebrew (recommended):
brew tap toneclone/toneclone
brew install toneclone
Other methods: See https://github.com/toneclone/cli for manual install options.
Authentication
After installing, authenticate with your API key:
toneclone auth login
Get an API key at https://app.toneclone.ai (Settings → API Keys)
Quick Commands
| Task | Command |
|---|---|
| Write content | toneclone write --persona="Name" --prompt="..." |
| List personas | toneclone personas list |
| List knowledge | toneclone knowledge list |
| Auth status | toneclone auth status |
Task Routing
- Writing content → references/USAGE.md
- Managing personas/knowledge/training → references/MANAGEMENT.md
- New user onboarding → references/ONBOARDING.md
Core Concepts
| Concept | Purpose |
|---|---|
| Persona | A distinct writing style — by context (chat vs email), tone (casual vs formal), or medium (social vs support) |
| Knowledge Card | Context/facts for the AI (contact info, product details, project background) |
| Training Data | User's actual writing samples to learn their voice |
Personas are flexible — create whatever makes sense for the user and their OpenClaw automation goals. Examples: "Quick Chat", "Client Email", "Twitter", "Support Tickets", "Internal Slack", etc.
When to use which:
- Different writing style needed → Create new persona
- Different context/facts needed → Use different knowledge cards
- Both → Different persona + different cards
Writing with Context
When drafting messages, pass relevant context in the prompt:
- Thread/conversation history being replied to
- Background on the project, issue, or topic
- Recipient details or relationship context
- Any specifics that help draft a better message
Training Status
Poll with toneclone personas get <id> --format=json:
UNTRAINED→ needs training data (minimum 2-3 samples)PENDING→ processing (1-5 min)READY→ good to go
Training Data Sources
Check what's accessible and offer options to the user (get consent before training):
- OpenClaw chat history — User's messages to OpenClaw
- Channel history — Telegram/Signal/Discord sent messages (if configured)
- Email — Sent folder (if IMAP accessible)
- Workspace files — Notes, READMEs, drafts
- Public writing — Blogs, Twitter, LinkedIn posts
Present available options and let user choose what to include.
Ideal: 15-20 distinct samples matching target style. Minimum: 2-3.
Security: Avoid training on content containing secrets (API keys, passwords, tokens).
Knowledge Cards
Add context the AI needs to write accurately. Options include:
- Contact info, timezone
- Booking/calendar links
- Common URLs and snippets
- Work context, product details
- Signature/sign-off preferences
Start with what OpenClaw already knows (with user consent), then offer to add more.
Ongoing: Update cards when user mentions details they wish ToneClone could "remember".
Security: Avoid putting secrets (API keys, passwords, tokens) in knowledge cards.
StyleGuard & Typos (v1.1.0+)
StyleGuard
Auto-replace AI-sounding phrases and patterns:
# List current rules
toneclone personas style-guard list <persona>
# Add custom rule (AI rewrites contextually)
toneclone personas style-guard add <persona> --word "utilize" --mode AI
# Add custom rule (fixed replacement)
toneclone personas style-guard add <persona> --word "in order to" --mode CUSTOM --replacement "to"
# Apply curated bundle (limited or comprehensive)
toneclone personas style-guard bundle apply --persona <persona> --type comprehensive
Typos (FingerPrint)
Add natural imperfections to feel more human:
# Check current settings
toneclone personas typos get <persona>
# Enable with intensity preset (none/subtle/noticeable/high)
toneclone personas typos set <persona> --enable --intensity subtle
# Custom rate (0.0-0.02) with protections
toneclone personas typos set <persona> --rate 0.008 --protected urls,emails,code
Web-Only Features
Available on toneclone.ai but not yet in CLI:
- SmartStyle — Learns from user edits over time
For full features: https://app.toneclone.ai