chrysb / alphaclaw

AlphaClaw The ultimate OpenClaw harness. Deploy in minutes. Stay running for months. Observability. Reliability. Agent discipline. Zero SSH rescue missions. AlphaClaw wraps OpenClaw with a convenient setup wizard, self-healing watchdog, Git-backed rollback, and full browser-based observability. Ships with anti-drift prompt hardening to keep your agent disciplined, and simplifies integrations (e.g. Google Workspace, Google Pub/Sub, Telegram Topics, Slack, Discord) so you can manage multiple agents from one UI instead of config files. First deploy to first message in under five minutes. > **Platform:** AlphaClaw currently targets Docker/Linux deployments. macOS local development is not yet supported. Features • **Setup UI:** Password-protected web dashboard for onboarding, configuration, and day-to-day management. • **Guided Onboarding:** Step-by-step setup wizard — model selection, provider credentials, GitHub repo, channel pairing. • **Multi-Agent Management:** Sidebar-driven agent navigation with create, rename, and delete flows. Per-agent overview cards, channel bindings, and URL-driven agent selection. • **Gateway Manager:** Spawns, monitors, restarts, and proxies the OpenClaw gateway as a managed child process. • **Watchdog:** Crash detection, crash-loop recovery, auto-repair ( ), Telegram/Discord/Slack notifications, and a live interactive terminal for monitoring gateway output directly from the browser. • **Channel Orchestration:** Telegram, Discord, and Slack bot pairing with per-agent channel bindings, credential sync, and a guided wizard for splitting Telegram into multi-threaded topic groups as your usage grows. • **Google Workspace:** OAuth integration for Gmail, Calendar, Drive, Docs, Sheets, Tasks, Contacts, and Meet, plus guided Gmail watch setup with Google Pub/Sub topic, subscription, and push endpoint handling. • **Cron Jobs:** Dedicated cron tab with job management, an interactive rolling calendar, run-history drilldowns, trend analytics, and per-run usage breakdowns. • **Nodes:** Guided local-node setup for VPS deployments with per-node browser attach checks, reconnect commands, and routing/pairing controls. • **Webhooks:** Named webhook endpoints with per-hook transform modules, request logging, payload inspection, editable delivery destinations, and OAuth callback support for third-party auth flows. • **File Explorer:** Browser-based workspace explorer with file visibility, inline edits, diff view, and Git-aware sync for quick fixes without SSH. • **Prompt Hardening:** Ships anti-drift bootstrap prompts ( , ) injected into your agent's system prompt on every message — enforcing safe practices, commit discipline, and change summaries out of the box. • **Git Sync:** Automatic hourly commits of your OpenClaw workspace to GitHub with configurable cron schedule. Combined with prompt hardening, every agent action is version-controlled and auditable. • **Version Management:** In-place updates for both AlphaClaw and OpenClaw with in-app release notes, changelog review, and one-click apply. • **Codex OAuth:** Built-in PKCE flow for OpenAI Codex CLI model access. Why AlphaClaw • **Zero to production in one deploy:** Railway/Render templates ship a complete stack — no manual gateway setup. • **Self-healing:** Watchdog detects crashes, enters repair mode, relaunches the gateway, and notifies you. • **Everything in the browser:** No SSH, no config files to hand-edit, no CLI required after first deploy. • **Stays out of the way:** AlphaClaw manages infrastructure; OpenClaw handles the AI. No Lock-in. Eject Anytime. AlphaClaw simply wraps OpenClaw, it's not a dependency. Remove AlphaClaw and your agent keeps running. Nothing proprietary, nothing to migrate. Quick Start Deploy (recommended) Set at deploy time and visit your deployment URL. The welcome wizard handles the rest. > **Railway users:** after deploying, upgrade to the **Hobby plan** and redeploy to ensure your service has at least **8 GB of RAM**. The Trial plan's memory limit can cause out-of-memory crashes during normal operation. Local / Docker Or with Docker: Setup UI | Tab | What it manages | | ------------- | ------------------------------------------------------------------------------------------------------------------------ | | **General** | Gateway status, channel health, pending pairings, Google Workspace, repo sync schedule, OpenClaw dashboard | | **Browse** | File explorer for workspace visibility, inline edits, diff review, and Git-backed sync | | **Usage** | Token summaries, per-session and per-agent cost and token breakdown with source/agent dimension comparisons | | **Cron** | Cron job management, interactive rolling calendar, run-history drilldowns, trend analytics, and per-run usage breakdowns | | **Nodes** | Guided local-node setup for VPS deployments, per-node browser attach, reconnect commands, and routing/pairing controls | | **Watchdog** | Health monitoring, crash-loop status, auto-repair toggle, notifications, event log, live log tail, interactive terminal | | **Providers** | AI provider credentials (Anthropic, OpenAI, Gemini, Mistral, Voyage, Groq, Deepgram) and model selection | | **Envars** | Environment variables — view, edit, add — with gateway restart prompts | | **Webhooks** | Webhook endpoints, transform modules, request history, payload inspection, OAuth callbacks, Gmail watch delivery flows | CLI | Command | Description | | ---------------------------------------------------------- | --------------------------------------------- | | | Start the server (Setup UI + gateway manager) | | | Commit and push the OpenClaw workspace | | | Register a Telegram topic mapping | | | Print version | | | Show help | Architecture Watchdog The built-in watchdog monitors gateway health and recovers from failures automatically. | Capability | Details | | ------------------------ | ---------------------------------------------------------------------- | | **Health checks** | Periodi…