Skip to content

Turn your Claude Code and Codex into personal AI assistants like OpenClaw

Notifications You must be signed in to change notification settings

suitedaces/dorabot

Repository files navigation

dorabot

A superhuman AI agent that knows you - running on the subscriptions you already pay for.

dorabot wraps Claude and ChatGPT in a multi-channel agent harness - WhatsApp, Telegram, browser automation, email, cron, persistent memory, and Mac control - so they can do real work outside the IDE.

image

What It Does

  • Chat on WhatsApp, Telegram, or the desktop app — persistent memory across channels
  • Browse the web: fill forms, click buttons, read pages, stay logged in
  • Read and send email
  • Schedule reminders, recurring tasks, and cron jobs
  • Create PRs, review issues, check CI via GitHub
  • Control your Mac: windows, apps, Spotify, Calendar, system settings
  • Generate and edit images via Gemini
  • Extend with custom skills (drop a markdown file in a folder)
dorabot-demo-0.mp4

Quick Start

Prerequisites

  • Node.js 22+
  • A Claude account (API key or Pro/Max subscription) or OpenAI account (API key or ChatGPT login) — dorabot talks to Claude via the Agent SDK and to OpenAI via the Codex SDK
  • Chrome, Brave, or Edge (for browser features)

Install

git clone https://github.com/suitedaces/dorabot.git
cd dorabot
npm install
npm run build
npm link

Run

# development — gateway + desktop with HMR
npm run dev

# or run individually
npm run dev:gateway   # gateway with auto-reload
npm run dev:desktop   # electron-vite with HMR

# production
dorabot -g            # gateway mode — powers desktop app and channels
dorabot -i            # interactive terminal
dorabot -m "what's the weather in SF?"   # one-off question

Channels

WhatsApp

dorabot --whatsapp-login    # scan the QR code

Telegram

  1. Create a bot with @BotFather
  2. Set TELEGRAM_BOT_TOKEN=your_token in your environment
  3. Start from the desktop app or config

Desktop App

cd desktop
npm install
npm run dev    # starts electron-vite with HMR

Make It Yours

Ask dorabot to onboard you.

File Purpose
SOUL.md Personality and tone
USER.md Who you are, your preferences
MEMORY.md Persistent facts it should always remember
AGENTS.md Extra instructions

Skills

Built-in skills include GitHub, email, macOS automation, image generation, and memes. Add your own by dropping a SKILL.md in ~/.dorabot/skills/your-skill/.

Config

~/.dorabot/config.json:

{
  "model": "claude-sonnet-4-5-20250929",
  "channels": {
    "whatsapp": { "enabled": false },
    "telegram": { "enabled": false, "token": "" }
  }
}

Security

  • Scoped file access (default: ~/, /tmp)
  • Sensitive dirs always blocked: ~/.ssh, ~/.gnupg, ~/.aws
  • Token-authenticated gateway
  • Configurable tool approval tiers

License

MIT

About

Turn your Claude Code and Codex into personal AI assistants like OpenClaw

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published