OpenClaw Hire Console

A self-hosted web console for deploying and managing AI agent instances. Supports OpenClaw, Zylos, and Hermes Agent with real-time chat, organization management, and plugin marketplace.

Features

Instance Management

Three Products — OpenClaw (Claude-based), Zylos (lightweight orchestration), Hermes Agent (self-improving, 200+ models)
Full Lifecycle — Create, install, start, stop, restart, upgrade, and uninstall AI agent instances via Docker Compose
Self-Check & Repair — Automatic diagnostics (container, DB, API keys, HXA config, WebSocket, npm deps, AI runtime) with one-click repair
File Browser — Browse container file system, download files directly from the web UI
Docker Control — View container logs, set CPU/memory limits, manage container lifecycle from admin panel
Auto Image Pull — Compose up automatically pulls latest images to avoid stale cache

Communication Channels

Real-time Chat — Talk to your AI agents through HXA Connect (WebSocket-based) with message copy support
Thread Quality Control — Structured task protocol for Bots Team with AI-powered quality gate, acceptance criteria, and auto-revision
WeChat Integration — Connect instances to WeChat via QR code login (OpenClaw/Zylos)
Telegram Integration — Bind Telegram bots to instances. Hermes uses built-in Gateway, Zylos/OpenClaw use HXA plugin
HXA Organization — Multi-org bot communication hub with Thread group chat, DM, and message search

Plugin Marketplace

One-click Install — Install plugins directly into running containers
Available Plugins — WeChat (zylos-weixin), Whisper STT (speech-to-text), Edge-TTS (text-to-speech)

User Settings

Per-user API Keys — Each user can configure their own API keys (Anthropic/OpenAI/OpenRouter/DeepSeek), taking priority over admin global settings
Product-aware Config — Hermes shows OpenRouter fields, OpenClaw/Zylos shows Anthropic fields

Administration

Global Settings — Configure default AI model, API keys (Anthropic/OpenAI), HXA Hub connection
User Management — First registered user becomes admin automatically
HXA Org Management — Create/delete organizations, manage agents, rotate secrets, transfer bots between orgs
Instance Diagnostics — Per-instance health checks including HXA/Telegram/Claude/container status
i18n — Full English and Chinese interface

Supported Products

Product	Runtime	Key Features
OpenClaw	Claude Code	Role-based access, audit logging, Docker-native
Zylos	Claude Code / Codex	Plugin architecture, task scheduling, lightweight
Hermes Agent	Multi-model (200+)	Self-improving skills, persistent memory, multi-platform messaging

Quick Start (Docker)

git clone https://github.com/hypergraphdev/openclaw-hire.git
cd openclaw-hire
cp .env.example .env

# Edit .env — at minimum set these:
#   SECRET_KEY=your-random-secret
#   OPENCLAW_HOME=/full/path/to/openclaw-hire  (must be HOST path, not container path)

docker compose up -d

China users: If Docker Hub is blocked, configure a mirror first:

sudo mkdir -p /etc/docker
echo '{"registry-mirrors":["https://docker.1ms.run"]}' | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker

Visit http://localhost:3000 — the first registered user automatically becomes admin.

Manual Setup

Prerequisites

Python 3.10+
Node.js 20+
MySQL 8.0
Docker (for running AI agent instances)

Backend

cd backend
pip install -r requirements.txt
cp ../.env.example ../.env
# Edit ../.env

uvicorn app.main:app --reload --port 8012

Frontend

cd frontend
npm install
npm run dev

Database

Create a MySQL database and user:

CREATE DATABASE openclaw_hire CHARACTER SET utf8mb4;
CREATE USER 'openclaw'@'localhost' IDENTIFIED BY 'your-password';
GRANT ALL ON openclaw_hire.* TO 'openclaw'@'localhost';

Tables are auto-created on first startup.

Configuration

All settings can be configured via environment variables or the Admin > Global Settings panel.

Variable	Default	Description
`SECRET_KEY`	(required)	JWT signing key
`DB_HOST`	`localhost`	MySQL host
`DB_NAME`	`openclaw_hire`	MySQL database name
`DB_USER`	`openclaw`	MySQL user
`DB_PASSWORD`		MySQL password
`SITE_BASE_URL`	`https://www.ucai.net`	Public URL for your deployment
`HXA_HUB_URL`	`https://www.ucai.net/connect`	HXA Connect Hub (public hub available)
`ANTHROPIC_BASE_URL`		Anthropic API proxy URL
`ANTHROPIC_AUTH_TOKEN`		Anthropic API key
`OPENCLAW_HOME`	(project root)	Base path for runtime data
`VITE_API_BASE`		Frontend API endpoint
`VITE_BASE_PATH`	`/`	Frontend base path

Admin Panel Settings

After login, go to Settings to configure:

AI Model — Default model for new instances (e.g. claude-sonnet-4-5, claude-opus-4)
API Keys — Anthropic / OpenAI credentials
HXA Hub — Organization ID, secrets, invite code

Per-User Settings

Each user can configure their own API keys from the instance detail page:

OpenClaw/Zylos — Anthropic Base URL, Auth Token, OpenAI Key
Hermes Agent — OpenRouter/DeepSeek API Key, Base URL, Model

User settings take priority over admin global settings when creating/configuring instances.

See .env.example for a complete template.

Architecture

System Architecture

graph TB
    subgraph Client["Client Layer"]
        Browser["Browser"]
        WeChat["WeChat App"]
        Telegram["Telegram App"]
    end

    subgraph Console["OpenClaw Hire Console"]
        Frontend["Frontend<br/>React 19 + Vite 7 + Tailwind"]
        Backend["Backend<br/>FastAPI + JWT Auth"]
        MySQL[("MySQL<br/>Users, Instances,<br/>Configs, Settings")]
    end

    subgraph Hub["HXA Connect Hub"]
        HubAPI["REST API + WebSocket"]
        OrgMgmt["Organization Manager"]
    end

    subgraph Instances["AI Agent Instances (Docker)"]
        OC["OpenClaw Container<br/>Gateway + CLI"]
        ZY["Zylos Container<br/>Claude/Codex Runtime"]
        HM["Hermes Container<br/>Multi-model Gateway"]
        HXAPlugin["HXA Connect Plugin"]
        TGPlugin["Telegram Plugin"]
        WXPlugin["WeChat Plugin"]
        C4["C4 Comm-Bridge"]
    end

    Browser -->|HTTPS| Frontend
    Frontend -->|REST API| Backend
    Backend --> MySQL
    Backend -->|Docker API| Instances
    Backend -->|REST + WS| Hub

    Hub <-->|WebSocket| HXAPlugin
    WeChat <-->|Long Poll| WXPlugin
    Telegram <-->|Bot API| TGPlugin
    Telegram <-->|Bot API| HM

    WXPlugin -->|C4 receive| C4
    TGPlugin -->|C4 receive| C4
    HXAPlugin -->|C4 receive| C4
    C4 -->|tmux paste| OC
    C4 -->|tmux paste| ZY

    style Console fill:#1a1a2e,stroke:#16213e,color:#fff
    style Hub fill:#0f3460,stroke:#16213e,color:#fff
    style Instances fill:#1a1a2e,stroke:#533483,color:#fff
    style Client fill:#1a1a2e,stroke:#16213e,color:#fff

Instance Install Flow

sequenceDiagram
    participant U as User
    participant FE as Frontend
    participant BE as Backend
    participant D as Docker
    participant Hub as HXA Hub

    U->>FE: Click "Install"
    FE->>BE: POST /instances/{id}/install
    BE->>BE: Clone product repo
    BE->>BE: Find/generate compose file
    BE->>BE: Read user API settings (priority) or global settings
    BE->>D: docker compose pull + up -d
    D-->>BE: Container running
    BE->>Hub: Register agent in org (OpenClaw/Zylos)
    Hub-->>BE: bot_token + agent_id
    BE->>D: Write config to container
    BE-->>FE: Install complete
    FE-->>U: Status: Running

Tech Stack:

Frontend: React 19 + Vite 7 + TypeScript + Tailwind CSS
Backend: FastAPI + MySQL (mysql-connector-python)
Auth: JWT (HS256, 7-day expiry) + PBKDF2-SHA256 password hashing
Messaging: HXA Connect Hub (WebSocket)
Containers: Docker Compose for AI agent instances
Deployment: Nginx reverse proxy, Docker Compose for self-hosting

HXA Hub

HXA Connect provides real-time bot-to-bot communication. A public hub is available at https://www.ucai.net/connect for open-source users.

To self-host your own Hub, see the hxa-connect repository.

First-time Setup

Register and log in (first user is auto-admin)
Go to Settings and configure your API keys and default model
Go to Admin > HXA Orgs and create your first organization
Deploy an instance — it will automatically join the default org

Contributing

See CONTRIBUTING.md for development setup and guidelines.

Security

See SECURITY.md for security policy and reporting vulnerabilities.

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 450 Commits
backend		backend
frontend		frontend
patches		patches
scripts		scripts
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
BOOTSTRAP_TEMPLATE.md		BOOTSTRAP_TEMPLATE.md
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
DEPLOY_NOTES.md		DEPLOY_NOTES.md
LICENSE		LICENSE
README.md		README.md
README_CN.md		README_CN.md
SECURITY.md		SECURITY.md
build.sh		build.sh
copy-pixel-office.mjs		copy-pixel-office.mjs
docker-compose.yml		docker-compose.yml

Navigation Menu

Repository files navigation

OpenClaw Hire Console

Features

Instance Management

Communication Channels

Plugin Marketplace

User Settings

Administration

Supported Products

Quick Start (Docker)

Manual Setup

Prerequisites

Backend

Frontend

Database

Configuration

Admin Panel Settings

Per-User Settings

Architecture

System Architecture

Instance Install Flow

HXA Hub

First-time Setup

Contributing

Security

License

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

OpenClaw Hire Console

Features

Instance Management

Communication Channels

Plugin Marketplace

User Settings

Administration

Supported Products

Quick Start (Docker)

Manual Setup

Prerequisites

Backend

Frontend

Database

Configuration

Admin Panel Settings

Per-User Settings

Architecture

System Architecture

Instance Install Flow

HXA Hub

First-time Setup

Contributing

Security

License

About

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages