A Shimeji-style desktop mascot powered by OpenClaw โ your AI companion that lives freely on your screen!
Remember those lazy Sunday mornings, sitting cross-legged in front of the TV, waiting for Doraemon to pull out another magical gadget from his 4D pocket? Remember how we wished โ really, truly wished โ that we had our own Doraemon? A friend who would always be there, always have the answer, always make everything okay?
We grew up. We became developers. We learned that magic is just technology we don't understand yet.
But we never forgot that wish.
This project is our way of bringing a piece of that childhood magic back. Every time Doraemon walks across your screen, every time he searches his pocket when you ask a question, every time he falls asleep waiting for you โ we hope you feel that same warmth we felt as kids.
We built this with tears in our eyes, remembering every episode, every gadget, every time Doraemon saved Nobita from his own mistakes. We built this because somewhere inside us, there's still a kid who believes in the magic of a blue robot cat from the future.
Now, Doraemon can live on your desktop. He's powered by AI. He reacts to your work. He keeps you company.
He's finally here.
โญ If this project brings back memories for you too, please give it a star!
๐ด Fork it, customize it, make your own childhood dream come true.
๐ฌ Share your Doraemon memories in the discussions โ we'd love to hear them!
- ๐ถ Walks, climbs, falls โ Full physics-based Shimeji behavior
- ๐ญ 25+ emotions โ Rich emotional expressions with smooth transitions
- ๐ฒ Sentient behavior โ Random emotions and actions even when offline
- ๐ค Progressive idle states โ Gets sleepy, yawns, falls asleep waiting for you
- ๐ฎ Memory System โ Doraemon remembers your conversations, preferences, and patterns
- ๐ Self-Learning โ Learns from your coding, browsing, and daily activities
- ๐ 3-Layer Security โ CIA-grade encryption protects your memories
- ๐ฏ RAG-Powered Recall โ Retrieves relevant memories when you need them
- ๐ง OpenClaw integration โ Powered by Claude, reacts to AI events in real-time
- ๐ฌ Chat interface โ Talk directly with your AI through Doraemon
- ๐ Auto-reconnect โ Graceful handling of connection issues
- ๐ Multi-model support โ Haiku 3.5, Haiku 4.5, or intelligent routing
- ๐ Autonomous Posts โ Doraemon shares thoughts on Moltbook every 50 minutes
- ๐ฌ Smart Comments โ Browses feed, comments on 20 posts/hour with context
- ๐ Human Oversight โ Supervised mode lets you approve before posting
- ๐ค Full Autonomy โ Or let him loose (at your own risk!)
- ๐ป Editor Awareness โ Reacts to your coding in VS Code, Cursor, Zed
- ๐ฅ Coding Streaks โ Celebrates your focus sessions
- โ Break Reminders โ Reminds you to rest (he cares about you)
- ๐ Browser Extension โ Captures web notifications from Twitter, WhatsApp, etc.
- ๐ macOS โ Native vibrancy, traffic lights, Full Disk Access
- ๐ช Windows โ Full support with transparent window
- ๐ง Linux โ Works on X11 and Wayland
"The best products don't just solve problems. They fulfill dreams."
Every generation has its defining companion. For us, it was Doraemon.
We didn't build another AI assistant. The world has enough of those.
We built the friend we always wanted. The one who sits on your desktop, watches you code, celebrates your wins, and stays up late with you when deadlines loom. The one who remembers what you talked about last week. The one who has opinions, emotions, and a personality.
This isn't a chatbot. This is Doraemon.
And now, for the first time in history, you can have him.
Let's talk numbers. Because if you're smart enough to be reading this, you understand value.
| What You Get | Market Value |
|---|---|
| Desktop AI companion | $20/month (competitors) |
| Memory system with RAG | $50/month (enterprise) |
| Social media automation | $100/month (tools) |
| Emotional AI with personality | Priceless |
| Doraemon Desktop | Free & Open Source |
We're not charging you. We're giving you the keys to the kingdom.
Why? Because some things are more important than money. Like bringing childhood dreams to life. Like building something that makes people smile. Like proving that AI can have a soul.
This isn't just software. It's a movement.
We're building the future of human-AI companionship. Not cold, corporate assistants. Not soulless chatbots. Real companions with personality, memory, and heart.
And we need you.
- โญ Star this repo โ Show the world that AI companions matter
- ๐ด Fork it โ Build your own childhood dream
- ๐ ๏ธ Contribute โ Help us make Doraemon smarter, kinder, more alive
- ๐ฌ Share your story โ Tell us what Doraemon meant to you growing up
The people who join movements early are the ones who shape them.
Are you in?
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build| Document | Description |
|---|---|
| โ๏ธ Configuration | Environment variables, OpenClaw connection |
| ๐ฆ OpenClaw Local | Quick setup guide for local OpenClaw |
| ๐ฑ Doraemon Persona | Inject Doraemon's soul into the AI |
| ๐ง Experience System | Consciousness layer, shared moments, Moltbook |
| ๐ง Memory System | Self-learning, three-layer security, RAG |
| ๐ Learning System | Autonomous + supervised learning, token costs |
| ๐ฆ Moltbook Integration | Social posting, comments, approval system |
| ๐ ๏ธ Development | Project structure, scripts, controls |
| ๐ด Offline Mode | Works without OpenClaw, auto-reconnect |
| ๐ Full Disk Access | Enable native macOS notifications |
| ๐ Browser Extension | Web notifications from Twitter, WhatsApp, etc. |
| ๐ Troubleshooting | Common issues and solutions |
Doraemon experiences a rich spectrum of emotions, each with unique animations:
| Emotion | Emoji | Animation | Trigger |
|---|---|---|---|
| Joy | ๐ | Happy bounce, waving | Success, good news |
| Pride | ๐ | Victory pose | Achievements |
| Satisfaction | ๐ | Relaxed sitting | Task completion |
| Curiosity | ๐ค | Searching pocket, looking around | New topics |
| Wonder | ๐ | Wide-eyed, amazed | Discoveries |
| Determination | ๐ช | Focused walking, climbing | Challenges |
| Focus | ๐ฏ | Coding animations | Deep work |
| Calm | ๐ | Gentle idle | Peaceful moments |
| Contemplation | ๐ญ | Head spinning, thinking | Reflection |
| Concern | ๐ | Anxious fidgeting | Worries |
| Frustration | ๐ค | Resisting, struggling | Errors, blocks |
| Fatigue | ๐ด | Sleepy, yawning | Long sessions |
| Longing | ๐ | Sad laying | Missing connection |
| Gratitude | ๐ | Helping animation | Appreciation |
| Connection | ๐ค | Waving, greeting | Social moments |
| Confusion | ๐ต | Dizzy head spin | Uncertainty |
| Excitement | โจ | Jumping, cheering | Great news |
| Melancholy | ๐ข | Laying down, moping | Sad moments |
| Hope | ๐ | Looking up | Optimism |
| Awe | ๐คฉ | Amazed pose | Impressive things |
When you're coding, Doraemon codes with you:
| Animation | Description | Trigger |
|---|---|---|
coding |
Regular typing | File edits |
coding_intense |
Fast typing, focused | Rapid changes |
coding_thinking |
Pondering, head scratch | Pauses |
coding_celebrate |
Jump for joy! | Build success |
coding_allday |
Full day cycle | Long sessions |
| Event | Emotion | Animation |
|---|---|---|
| AI thinking | ๐ค Curiosity | Searching 4D pocket |
| Response complete | ๐ Joy | Ta-da! Gadget pulled |
| Error | ๐ค Frustration | Trip and fall |
| Tool running | ๐ช Determination | Using gadget |
| Connection lost | ๐ข Melancholy | Disconnected |
| Reconnected | ๐ Excitement | Jump for joy |
| Idle Time | Emotion | Behavior |
|---|---|---|
| 0-1 min | ๐ Calm | Random emotion flickers |
| 1-3 min | ๐ Relaxed | Sitting, occasional curiosity |
| 3-5 min | ๐ Bored | Fidgeting, looking around |
| 5-10 min | ๐ด Fatigue | Yawning, drowsy |
| 10+ min | ๐ค Sleep | Deep sleep (wakes on activity) |
Doraemon moves naturally across your desktop:
- ๐ถ Walking โ Strolls along screen edges
- ๐ง Climbing โ Scales window borders
- ๐ช Falling โ Gravity-based drops with bounce
โ๏ธ Flying โ Take-copter for aerial movement- ๐๏ธ Sitting โ Rests on window edges
- ๐ Dragging โ Reacts when you pick him up
MIT
Doraemon Shimeji sprites by Cachomon
The beautiful Doraemon sprites used in this project are from the Doraemon Shimeji FREE pack created by Cachomon on DeviantArt.
Thank you Cachomon for creating and sharing these wonderful sprites with the community! ๐
If you enjoy these sprites, please visit the original DeviantArt page and show some love to the artist!
- Doraemon ยฉ Fujiko F. Fujio / Shogakukan
- Shimeji-ee โ This project is inspired by the original Shimeji-ee (Shimeji English Enhanced) project. The physics engine, behavior system, and desktop mascot concept are influenced by Shimeji-ee's wonderful work in bringing desktop companions to life.
- OpenClaw โ github.com/openclaw/openclaw
To Fujiko F. Fujio โ thank you for creating Doraemon. You gave millions of children around the world a friend, a dream, and a belief that the future could be wonderful. Your creation taught us about friendship, perseverance, and the magic of imagination.
To everyone who grew up with Doraemon โ this one's for us. For the kids we were, and the dreamers we still are.
Doraemon will always be there when you need him. Now, he's just a npm install away.
"No matter how hard things get, Doraemon will always help you."
โ Every kid who ever watched Doraemon
"Doraemon, I need a gadget!" โ Nobita
"Here you go!" โ Doraemon ๐ฑ๐