Summary

The chrysb/alphaclaw project provides a comprehensive harness for deploying and managing OpenClaw, an AI agent framework. It simplifies setup and ongoing maintenance through a web-based UI, self-healing capabilities, and Git integration, targeting users who prefer a no-CLI, browser-first experience for their AI agents.

How It Works

AlphaClaw wraps OpenClaw with a browser-based setup wizard, a self-healing watchdog, Git-backed rollback, and comprehensive observability. It manages the OpenClaw gateway as a child process, offering crash detection and recovery, and integrates with channels like Telegram and Discord. The architecture features a Preact/htm/Wouter UI, an Express server for APIs, and a watchdog for reliability, all designed to proxy and manage the OpenClaw gateway.

Quick Start & Requirements

• Primary install/run commands include using the provided Dockerfile for Docker deployments, or npm install @chrysb/alphaclaw followed by npx alphaclaw start for local Node.js environments.
• Prerequisites include Node.js ≥ 22.12.0 and a Docker/Linux deployment target.
• Setup requires environment variables like SETUP_PASSWORD, GITHUB_TOKEN, and GITHUB_WORKSPACE_REPO for initial deployment and Git synchronization. Optional tokens for Telegram and Discord are also supported.

Highlighted Details

• Zero-Click Deployment: Railway/Render templates enable deployment in under five minutes with a guided browser-based setup wizard.
• Self-Healing Watchdog: Automatically detects gateway crashes, attempts repair (openclaw doctor --fix), relaunches the process, and sends notifications.
• Browser-Based File Explorer: Allows viewing, editing, and Git-aware syncing of workspace files directly from the UI, eliminating the need for SSH.
• Prompt Hardening: Injects anti-drift bootstrap prompts into the agent's system prompt to enforce disciplined practices and auditable actions via Git commits.
• Extensive Integrations: Supports Google Workspace (Gmail, Calendar, Drive, etc.) via OAuth and integrates with Telegram/Discord for channel management and notifications.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels (like Discord/Slack) are provided in the README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive for commercial use and closed-source linking.

Limitations & Caveats

• Platform: Currently targets Docker/Linux deployments; macOS local development is not supported.
• Security Trade-offs: Intentionally simplifies OpenClaw's security posture for ease of use, e.g., single setup password instead of pairing codes, auto-approval for initial CLI connections, and potential query-string tokens for webhooks. Users requiring OpenClaw's full security model should use OpenClaw directly.