中文

DeskClaw

Your AI workforce, orchestrated. Deploy, manage, and scale AI agents on Kubernetes -- from a single pane of glass.

DeskClaw is a visual orchestration platform for AI employees. It organizes multiple AI Agents into collaborative teams through Cyber Workspaces, equips them with a Gene capability system, and enables one-click deployment, real-time monitoring, and elastic scaling on K8s clusters.

Highlights

• Cyber Workspace -- Hexagonal topology workspace where AI employees auto-collaborate, share a blackboard, and publish tasks
• Gene System -- Modular capability marketplace for hot-loading skills onto Agents, with support for private enterprise genes
• One-Click Deploy -- End-to-end visual deployment pipeline with SSE real-time progress streaming
• Multi-Cluster Management -- Cross-cluster instance orchestration, health checks, and elastic scaling
• Feishu SSO -- Enterprise-grade authentication with automatic org structure sync

CE / EE

Dual-edition architecture: Community Edition / Enterprise Edition.

	CE (Community)	EE (Enterprise)
License	Apache 2.0	Commercial
Features	Instance deploy, cluster management, log monitoring, gene marketplace	All of CE + multi-org, billing, advanced audit
Code	This repository	Private ee/ directory

Runtime auto-detection via FeatureGate -- if ee/ exists it runs as EE, otherwise CE. Feature registry defined in features.yaml.

Technical implementation: Backend Factory abstraction + Hook event bus; Frontend Stub + Vite Alias Override.

Architecture

DeskClaw/
├── nodeskclaw-portal/             # User Portal -- Vue 3 + Tailwind CSS (CE + EE)
├── nodeskclaw-backend/            # API Server -- Python 3.12 + FastAPI + SQLAlchemy
├── nodeskclaw-llm-proxy/          # LLM Proxy -- Go
├── nodeskclaw-artifacts/          # Docker images & deploy manifests
├── openclaw-channel-nodeskclaw/   # Workspace Agent channel plugin
├── features.yaml                  # CE/EE feature registry
├── ee/                            # Enterprise Edition (private)
│   └── nodeskclaw-frontend/      # Admin Console -- Vue 3 + shadcn-vue (EE-only)
├── openclaw/                      # DeskClaw runtime source (external)
└── vibecraft/                     # VibeCraft source (external)

i18n

Full-stack internationalization covering Portal, Admin, and Backend.

• Language detection: zh* -> zh-CN, en* -> en-US, fallback en-US
• Error display: prefer message_key local translation, fall back to message when missing
• Backend contract: code + error_code + message_key + message + data

Quick Start

Prerequisites

Dependency
Python >= 3.12 + uv	Backend runtime & package manager
Node.js >= 18 + npm	Frontend runtime
PostgreSQL	Database
Feishu App	SSO (App ID + App Secret)

1. Configure

cd nodeskclaw-backend
cp .env.example .env
# Edit .env -- fill in the required values below

Variable	Description
DATABASE_URL	postgresql+asyncpg://user:pass@host:5432/dbname
JWT_SECRET	JWT signing key
ENCRYPTION_KEY	KubeConfig AES key (32-byte base64)
FEISHU_APP_ID	Feishu App ID
FEISHU_APP_SECRET	Feishu App Secret
FEISHU_REDIRECT_URI	http://localhost:4518/api/v1/auth/feishu/callback

2. One-command Start

./dev.sh          # Auto-detect: ee/ exists -> EE, otherwise -> CE
./dev.sh ce       # Force CE mode (backend + portal)
./dev.sh ee       # Force EE mode (backend + portal + admin)
./dev.sh --fresh  # Force reinstall all dependencies

The script handles dependency installation, starts all services with colored log prefixes, and cleans up on Ctrl+C.

Mode	Services	Ports
CE	backend + portal	8000, 4517
EE	backend + portal + admin	8000, 4517, 4518

Manual Start (alternative)

Start each service individually

Backend:

cd nodeskclaw-backend
uv sync
uv run uvicorn app.main:app --reload --port 8000

API at http://localhost:8000 | Swagger at http://localhost:8000/docs | Auto-migration on first boot.

Frontend (Portal):

cd nodeskclaw-portal
npm install && npm run dev

Portal at http://localhost:4517 | /api auto-proxy to backend.

Frontend (Admin, EE-only):

cd ee/nodeskclaw-frontend
npm install && npm run dev

Admin at http://localhost:4518 | /api and /stream auto-proxy to backend.

3. Go

Open http://localhost:4517 (Portal) or http://localhost:4518 (Admin, EE), sign in.

Feishu redirect URL: http://localhost:4518/api/v1/auth/feishu/callback

Documentation

Backend	API overview, directory layout, env vars
Artifacts	DeskClaw image build & Dockerfile
Channel Plugin	Workspace agent collaboration plugin

Contributing

PRs welcome. See CONTRIBUTING.md for guidelines.

License

Apache License 2.0