← Back to directory
E

EmperorClaw

Community
The self-hosted operations platform for companies run with AI agents.
GitHub source repository ↗
★ 217 Stars Category · Other Very popular Source revision a690532ce18e
45FMRS · D
Reliability
6/20
Security and permissions
7/20
Maintenance
8/20
Documentation
12/20
Setup experience
12/20

EmperorClaw provides a comprehensive self-hosted platform for managing AI agent operations, with runtime independence, durable task leasing, knowledge management, pipelines, and human approvals. It's ideal for organizations looking to establish a reliable, auditable record of multi-agent workflows, but requires infrastructure to run a long-running Node.js process and PostgreSQL.

Read the FMRS scoring method →

EmperorClaw is a self-hosted, runtime-neutral operations platform for coordinating agents, customers, projects, knowledge, artifacts, approvals, and incidents. It provides durable state around agent execution, serving as a single system of record for the entire workforce. It does not execute agent logic or call LLMs; instead, it coordinates, records, and surfaces everything around that execution. It uses PostgreSQL for state, WebSocket for realtime features, and includes a watchdog process for lease expiry and dead letters.

Tools

The tool list has not been reviewed yet.

Setup

  1. Run the one-command install script with curl -fsSL https://raw.githubusercontent.com/emperorclaw/emperorclaw/main/install.sh | bash, or the PowerShell script for Windows. 2. Open http://localhost:3000 and create your admin account. Alternatively, manually clone the repo, copy .env.example to .env, fill in the required environment variables, and run npm install, npm run db:migrate, npm run build, and npm start.

Fit and risk

Best for

  • Digital agencies operating AI agents and needing durable operational state
  • Accounting and bookkeeping firms requiring client-isolated knowledge and audit history
  • Consultancies needing structured artifact storage and approvals
  • Ecommerce companies running AI back-office operations
  • Software companies needing multi-agent workflow coordination

Not for

  • People looking for a chatbot or prompt wrapper
  • Users needing fully serverless deployment without persistent WebSocket connections
  • Teams seeking an open-source (non-Fair Source) license
  • Users looking for a lightweight task management tool rather than an operations platform

Required permissions

  • Requires access to a PostgreSQL database for state storage
  • Requires ability to maintain persistent WebSocket connections
  • May require local filesystem or external storage backend (e.g., Bunny CDN) for artifacts
  • Requires secrets in environment variables (e.g., NEXTAUTH_SECRET, EMPEROR_CLAW_MASTER_KEY)

Risks and side effects

  • Self-hosting: risk of data loss if not properly configured; regular backups needed
  • Not open source (Fair Source) — restriction on offering it as a competing commercial product/service
  • Requires Node.js 20+ and PostgreSQL 16 as prerequisites
  • Not compatible with serverless platforms; requires a long-running process like a VPS or dedicated server

Troubleshooting

  1. Ensure Node.js version is >= 20
  2. Check that PostgreSQL connection string is correct
  3. Confirm migrations have been run with `npm run db:migrate`
  4. Verify WebSocket connections are not blocked by firewall
  5. Check that the watchdog process is running (ensured via Postgres advisory lock)

Use cases

Create a durable, auditable operating record for AI agent workflows
Coordinate projects and tasks across multiple clients with leases and approval gates
Provide agents with context before they act via scoped knowledge (Company Brain)
Track task lifecycles through task leases, retries, and dead-letter queues
Visualize and monitor AI workflows through pipeline registration and run reports

Supported clients

Supported clients have not been confirmed yet.