中文文档

ClaudeBot is a system tray application for Windows, macOS, and Linux that lets you remotely control the Claude Code CLI via Telegram or Dopamind.

Send a message from your phone, and ClaudeBot will invoke Claude Code on your computer and stream the results back in real time.

• Telegram Bot — Send prompts and commands to Claude Code through Telegram
• Dopamind Integration — Receive and process tasks from the Dopamind cloud queue
• Session Memory — Maintains conversation context across messages
• Live Progress — Real-time progress updates while tasks are running
• System Tray — Runs silently in the background
• Auto Update — Automatically checks and installs new versions from GitHub Releases
• Cross-Platform — Windows, macOS, and Linux

Go to the Releases page and download the installer for your platform:

You must have the Claude Code CLI installed and the claude command available in your terminal.

1. Open @BotFather in Telegram, send /newbot
2. Follow the prompts to set a name — you'll receive a Bot Token (e.g. 123456:ABC-DEF...)
3. Open @userinfobot and send any message to get your User ID

1. Launch ClaudeBot — the settings window opens automatically on first run
2. Fill in:
   • Telegram Bot Token — the token from step 1
   • Allowed User IDs — your Telegram User ID (comma-separated for multiple users)
   • Work Directory — the working directory for Claude Code (e.g. your project folder)
3. Click Save — the bot starts automatically

Open Telegram, find your bot, and send a message:

Hey, list the files in the current directory

ClaudeBot will pass your message to Claude Code and send the result back to Telegram.

Just send a message — no command needed. ClaudeBot passes it to Claude Code and streams the result back. Session context is preserved automatically.

ClaudeBot can connect to the Dopamind platform to receive tasks from a cloud queue.

1. Right-click the tray icon → Settings
2. Check Enable Dopamind
3. Enter the Device Token from the Dopamind app (format: dpm_...)
4. Save and restart

Once enabled, ClaudeBot continuously polls the Dopamind queue in real time, processes incoming tasks via Claude Code, and posts progress and results back.

Right-click the system tray icon to access:

# Clone the repository
git clone https://github.com/Philo-Li/claudebot.git
cd claudebot

# Install dependencies
npm install

# Run as Electron tray app (development)
npm run electron:dev

# Or run Telegram bot only (without Electron)
npm start

npm run build:win      # Windows (NSIS installer + portable)
npm run build:mac      # macOS (DMG)
npm run build:linux    # Linux (AppImage + deb)

All settings are stored in a .env file under the system user data directory:

• Windows: %APPDATA%\ClaudeBot\.env
• macOS: ~/Library/Application Support/ClaudeBot/.env
• Linux: ~/.config/ClaudeBot/.env

ClaudeBot checks for new versions on GitHub Releases at startup. When an update is available:

1. The update downloads in the background
2. A dialog prompts you when the download is complete
3. Choose "Restart Now" to install immediately

You can also trigger a check manually via Check for Updates in the tray menu.

MIT