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.
โถ Click to watch demo video
โญ 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!
Install one Kiro extension. Doraemon walks out of the editor and onto your desktop โ transparent, always on top, draggable, throwable.
Nothing else to download. No API key. No account. No network call, ever.
Every desktop pet ever built shipped an entire browser just to draw itself. Electron alone is 274 MB.
Ours is 792 KB.
| Size | |
|---|---|
| Electron runtime | 274 MB |
| Doraemon companion | 792 KB |
| Whole extension, download | 4.5 MB |
Same 247 sprites. Same physics engine. Same everything.
Because 288 lines of Rust borrow the webview your operating system already shipped. macOS has WebKit. Windows has WebView2. Linux has WebKitGTK.
Nobody needs a second copy of Chromium to animate a cartoon cat.
33 signals. Not "detects activity" โ thirty-three, each with its own
reaction, all from first-party editor APIs. No polling. No ps scraping. No
guessing.
Typing. Saves. Errors appearing and clearing. The whole project going green.
Terminal commands โ he knows a test run from a build from a git push from an
rm -rf. Tasks passing and failing, by name. Commits. Branch switches. Merge
conflicts. Breakpoints. Debug sessions. Going idle. Coding too long.
2,046 written lines, and the language ones match the file you're actually in.
Kiro is running. You went for coffee. It hit a prompt and stopped.
Doraemon holds that on your desktop for five minutes. Click the bubble and Kiro comes to the front.
An extension cannot un-minimise its own window. The mascot is a separate process, so it can ask the OS. That is the whole reason this works.
- Built and verified on macOS arm64. CI builds Windows, Linux and Intel Mac; those are unverified by hand.
- A downloaded build needs Apple notarization to clear Gatekeeper. Measured: a quarantined binary starts and prints nothing.
- "Waiting on approval" is inferred from the agent going quiet, because Kiro has no such hook trigger. A slow tool looks the same from outside.
- Approving from the bubble is deliberately not built. It would stall the agent while you're away.
๐ Full detail, including everything above: kiro-extension/README.md
This release adds a local gateway tunnel that routes every Claude call through your Kiro IDE session, so OpenClaw runs Claude Opus 4.7 as the orchestrator and Haiku 4.5 for workers โ without touching api.anthropic.com.
| Tier | Agent | Upstream model |
|---|---|---|
| ๐ง Orchestrator | main |
Claude Opus 4.7 |
| โก Responders | every worker | Claude Haiku 4.5 |
- ๐ No hardcoded credentials. The gateway reads your local Kiro token at runtime.
- โ๏ธ Works on macOS (LaunchAgent) and Linux/Contabo (systemd) with one-shot installers.
- ๐ Setup guide:
scripts/README-kiro-gateway.md
- ๐ถ 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
- ๐ Local gateway tunnel โ Wraps your Kiro IDE session in an Anthropic-shape API on
127.0.0.1:18790 - ๐ง Opus 4.7 orchestrator โ The
mainagent thinks with Claude Opus 4.7 - โก Haiku 4.5 responders โ Every worker agent (osint, weather, web-search, messagingโฆ) runs on Haiku 4.5
- ๐ธ Zero per-token cost โ Routes through your Kiro entitlement, not
api.anthropic.com - ๐ No keys in code โ Reads
~/.aws/sso/cache/kiro-auth-token.jsonfrom your machine at runtime - ๐ macOS LaunchAgent + ๐ง Linux systemd โ One-shot installers for both
- โ๏ธ Contabo-ready โ
./scripts/bootstrap-contabo.shdeploys the whole stack to a Linux VPS - ๐ Structured logs โ Every call writes
[llm] provider=kiro model=claude-opus-4.7 ms=โฆ ok=true
See
scripts/README-kiro-gateway.mdfor setup and verification.
- ๐ 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. |
| ๐ฅ Health Integration | Hospital API integration, doctor search, partner config |
| ๐ Troubleshooting | Common issues and solutions |
Doraemon experiences a rich spectrum of emotions, each with unique animations:
The live sprite set now includes 139 transparent PNG frames: 79 emotion frames for the 20 emotional states below, plus 60 action frames for chat, coding, research, gadget use, eating, rest, anger, hunger, take-copter, time travel, and random thought moments. Each set is normalized to a stable 128x128 frame box so animations keep a consistent scale and anchor.
| 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 |
|---|---|---|
action_coding_typing |
Laptop typing loop | File edits |
action_coding_thinking |
Pondering with code | Pauses, reviews |
emotion_focus |
Deep-work focus pose | Long focus streaks |
emotion_determination |
Intense coding energy | Rapid changes |
emotion_pride |
Victory pose | Build success |
coding_allday |
Full day cycle | Long sessions |
| Action Asset | Used For |
|---|---|
action_chat_question, action_chat_answer |
Getting a chat question and answering |
action_research |
Browser activity and web/search work |
action_gadget_search, action_gadget_use, action_explain_gadget, action_gadget_surprise |
Looking for, using, and explaining gadgets |
action_eating, action_hungry |
Dorayaki hunger and eating moments |
action_rest, action_nap |
Resting after long sessions |
action_angry, action_protect, action_greeting |
Strong emotion, helping, and social moments |
action_take_copter, action_time_travel, action_walk |
Doraemon-series gadget and movement moments |
action_random_thought |
Idle/random thought bubbles |
| 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 ๐ฑ๐