[BREAKGLASS] Windows companion suite for OpenClaw - System Tray app, Shared library, Node, and PowerToys Command Palette extension
40a68ec100
Some checks failed
Build and Test / test (push) Has been cancelled
Build and Test / build-extension (x64) (push) Has been cancelled
Build and Test / build (win-arm64) (push) Has been cancelled
Build and Test / build (win-x64) (push) Has been cancelled
Build and Test / build-extension (arm64) (push) Has been cancelled
Build and Test / release (push) Has been cancelled
- New ModernTrayMenu: Windows 11-style flyout replacing ContextMenuStrip - Dark/light mode auto-detection - Lobster branding header with accent colors - Clickable channel toggles (start/stop Telegram/WhatsApp) - Sessions link to /sessions, Cron Jobs to /cron - Status badges with color coding (READY/IDLE/ON/OFF) - New ModernForm base class for all dialogs - Rounded corners via DWM APIs - Consistent theming across Settings, QuickSend, WebChat, etc. - Accent color support - New WelcomeDialog for first-run experience - Guides users to get API token - Links to docs.molt.bot documentation - Opens Settings after onboarding - Channel status parity: unified READY status for linked channels - Service Health menu item (replaces Run Health Check) - Test Notification button in Settings - Various DPI and spacing fixes - Updated README with screenshot and expanded feature list |
||
|---|---|---|
| .github/workflows | ||
| docs | ||
| src | ||
| tests/Moltbot.Shared.Tests | ||
| .gitignore | ||
| CODE_REVIEW.md | ||
| GitVersion.yml | ||
| installer.iss | ||
| LICENSE | ||
| moltbot-windows-hub.slnx | ||
| README.md | ||
| TEST_COVERAGE.md | ||
🦞 Moltbot Windows Hub
A Windows companion suite for Moltbot - the AI-powered personal assistant.
Projects
This monorepo contains three projects:
| Project | Description |
|---|---|
| Moltbot.Tray | System tray application for quick access to Moltbot |
| Moltbot.Shared | Shared gateway client library |
| Moltbot.CommandPalette | PowerToys Command Palette extension |
🚀 Quick Start
Prerequisites
- .NET 10.0 SDK
- Windows 10/11
- PowerToys (for Command Palette extension)
Build
dotnet build
Run Tray App
dotnet run --project src/Moltbot.Tray
📦 Moltbot.Tray (Molty)
Modern Windows 11-style system tray companion that connects to your local Moltbot gateway.
Features
- 🦞 Lobster branding - Pixel-art lobster tray icon with status colors
- 🎨 Modern UI - Windows 11 flyout menu with dark/light mode support
- 💬 Quick Send - Send messages via global hotkey (Ctrl+Alt+Shift+C)
- 🔄 Auto-updates - Automatic updates from GitHub Releases
- 🌐 Web Chat - Embedded chat window with WebView2
- 📊 Live Status - Real-time sessions, channels, and usage display
- 🔔 Toast Notifications - Clickable Windows notifications with filters
- 📡 Channel Control - Start/stop Telegram & WhatsApp from the menu
- ⏱ Cron Jobs - Quick access to scheduled tasks
- 🚀 Auto-start - Launch with Windows
- ⚙️ Settings - Full configuration dialog
- 🎯 First-run experience - Welcome dialog guides new users
Menu Sections
- Status - Gateway connection status with click-to-view details
- Sessions - Active agent sessions (clickable → dashboard)
- Channels - Telegram/WhatsApp status with toggle control
- Actions - Dashboard, Web Chat, Quick Send, Cron Jobs, History
- Settings - Configuration, auto-start, logs
Mac Parity Status
| Feature | Mac | Windows |
|---|---|---|
| System tray icon | ✅ | ✅ |
| Connection status | ✅ | ✅ |
| Quick send hotkey | ✅ | ✅ |
| Web chat window | ✅ | ✅ |
| Toast notifications | ✅ | ✅ |
| Auto-start | ✅ | ✅ |
| Session display | ✅ | ✅ |
| Channel health | ✅ | ✅ |
| Channel control | ✅ | ✅ |
| Modern UI styling | ✅ | ✅ |
| Dark/Light mode | ✅ | ✅ |
| Deep links | ✅ | 🔄 |
📦 Moltbot.CommandPalette
PowerToys Command Palette extension for quick Moltbot access.
Commands
- 🦞 Open Dashboard - Launch web dashboard
- 💬 Quick Send - Send a message
- 📊 Full Status - View gateway status
- ⚡ Sessions - View active sessions
- 📡 Channels - View channel health
- 🔄 Health Check - Trigger health refresh
Installation
- Build the solution in Release mode
- Deploy the MSIX package via Visual Studio
- Open Command Palette (Win+Alt+Space)
- Type "Moltbot" to see commands
📦 Moltbot.Shared
Shared library containing:
MoltbotGatewayClient- WebSocket client for gateway protocolIMoltbotLogger- Logging interface- Data models (SessionInfo, ChannelHealth, etc.)
- Channel control (start/stop channels via gateway)
Development
Project Structure
moltbot-windows-hub/
├── src/
│ ├── Moltbot.Shared/ # Shared gateway library
│ ├── Moltbot.Tray/ # System tray app
│ └── Moltbot.CommandPalette/ # PowerToys extension
├── docs/
│ └── molty1.png # Screenshot
├── moltbot-windows-hub.sln
├── README.md
├── LICENSE
└── .gitignore
Configuration
Settings are stored in:
- Settings:
%APPDATA%\MoltbotTray\settings.json - Logs:
%LOCALAPPDATA%\MoltbotTray\moltbot-tray.log
Default gateway: ws://localhost:18789
First Run
On first run without a token, Molty displays a welcome dialog that:
- Explains what's needed to get started
- Links to documentation for token setup
- Opens Settings to configure the connection
License
MIT License - see LICENSE