Repolode
Submit
chrysb

chrysb/alphaclaw

A setup and operations harness for OpenClaw that adds a browser-based setup wizard, a self-healing watchdog, and Git-backed workspace sync.

View on GitHub
Stars
1,476
Forks
234
Open issues
42
Last commit
6 days ago

What is it?

AlphaClaw wraps the OpenClaw AI agent gateway with a browser UI so it can be deployed and run without hand-editing config files or using SSH. It covers guided onboarding for model providers, GitHub workspace sync, and channel pairing for Telegram, Discord, and Slack, and lets you manage multiple agents from one dashboard.

The built-in watchdog runs periodic health checks, detects gateway crashes and crash loops, runs `openclaw doctor --fix` for auto-repair, and sends alerts through Telegram, Discord, or Slack. Workspace files are committed to GitHub on an hourly schedule, so changes can be reviewed, diffed, and rolled back. Deployment templates are provided for Render and Railway, and it can also run locally or in Docker on Linux.

AlphaClaw is described as a thin wrapper rather than a dependency, so the OpenClaw gateway keeps running if AlphaClaw is removed. It trades some of OpenClaw's default hardening for easier setup, with a single setup password gating access.

Key features

  • 01Browser setup wizard for model providers, GitHub repo, and channel pairing.
  • 02Watchdog with crash-loop detection, auto-repair, and Telegram/Discord/Slack alerts.
  • 03Hourly Git sync of the OpenClaw workspace with a browsable file explorer and diff view.
  • 04Multi-agent management with per-agent channel bindings and cron job dashboard.
  • 05Google Workspace OAuth integration and Gmail watch setup via Google Pub/Sub.
  • 06OpenAI-compatible /v1 proxy that can be enabled from the setup UI.

Use cases

  • Deploying a personal OpenClaw agent on Render or Railway without writing config by hand.
  • Keeping a long-running agent gateway recovered automatically after crashes.
  • Running several agents from one dashboard, each bound to different Telegram or Slack channels.
  • Auditing and rolling back agent workspace changes through Git history.

Quick start

  1. 1

    Install the package from npm

    npm install @chrysb/alphaclaw
  2. 2

    Start the server (Setup UI and gateway manager)

    npx alphaclaw start

Things to know

  • Currently targets Docker/Linux deployments; macOS local development is not yet supported.
  • Requires an OpenClaw setup and a GitHub token and workspace repo for Git sync.
  • Railway deployments need the Hobby plan with at least 8 GB RAM to avoid out-of-memory crashes.

In collections

Open-source AI agent frameworks & appsSelf-hosted apps

Topics

#ai-agent#openclaw#watchdog#setup-ui#gateway#nodejs#self-hosted

FAQ

What is alphaclaw?
A setup and operations harness for OpenClaw that adds a browser-based setup wizard, a self-healing watchdog, and Git-backed workspace sync. AlphaClaw wraps the OpenClaw AI agent gateway with a browser UI so it can be deployed and run without hand-editing config files or using SSH. It covers guided onboarding for model providers, GitHub workspace sync, and channel pairing for Telegram, Discord, and Slack, and lets you manage multiple agents from one dashboard.
Is alphaclaw free to use? What license does it have?
alphaclaw is open source under the MIT license. Check the license terms before using it in commercial products.
Is alphaclaw still maintained?
Actively maintained. The last commit to alphaclaw was on Oct 16, 2026.
What can I use alphaclaw for?
Deploying a personal OpenClaw agent on Render or Railway without writing config by hand. Keeping a long-running agent gateway recovered automatically after crashes. Running several agents from one dashboard, each bound to different Telegram or Slack channels. Auditing and rolling back agent workspace changes through Git history.
How do I install alphaclaw?
Install the package from npm: npm install @chrysb/alphaclaw Start the server (Setup UI and gateway manager): npx alphaclaw start
Where can I get alphaclaw?
The source code and installation instructions are on GitHub: https://github.com/chrysb/alphaclaw

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects