OpenClawDashboard/README.md
Manohar 50a6520c20 docs: rewrite README + ARCHITECTURE for 2026-06-10 reality, extend TOOLS
ARCHITECTURE was last true on 2026-05-03 (pre-gateway, OpenRouter chains,
webhook mirror). Now documents: LiteLLM gateway routing, real spawning,
inbox loop, transcript mirror, audit trail, token rotation procedure,
RAM constraints. README no longer says 'Clawd Dashboard'.
2026-06-10 14:59:41 +00:00

2.4 KiB
Raw Permalink Blame History

Tiger Command Center

Self-hosted AI orchestration: one Tiger, four specialists, every action audited.

The control plane for Tiger, an OpenClaw-based AI agent running on a Hetzner VPS, reachable at agent.manohargupta.com. Tiger orchestrates four specialist sub-agents — Cody (code), Ethan (research), Cathy (writing), Elon (planning) — handles Telegram, watches Angel One positions, and drains a TASKS.md inbox while you do real work.

What lives here

Path What it is
dashboard/ Next.js 14 command center UI (tiger-dashboard, :3100)
bridge/ Express control-plane API (tiger-bridge, :3456, localhost-only)
skills/ OpenClaw skills (spawn-delegate, angel-positions, inbox-manager, sys-health, youtube-full)
ARCHITECTURE.md The real system map — read this first
TOOLS.md Tool/skill quick reference

Core capabilities

  • Sub-agent spawningPOST /tiger/spawn runs a specialist in an isolated OpenClaw session; result lands on Telegram. Tracked in executions.
  • TASKS.md inbox — drop - [ ] lines under ## 📥 INBOX; the bridge dispatches the top item to the right specialist every 30 min (920 IST).
  • Telegram mirror — the homepage thread reads OpenClaw's native session transcript: full history, both directions, perfectly in sync.
  • Audit trail/activity merges spawns, cron runs, task lifecycle, and outputs into one paginated, filterable timeline.
  • Own model gateway — every model call routes through llm.manohargupta.com (LiteLLM on own MiniMax/Anthropic keys). Primary: MiniMax-M3.

Running it

Both services are systemd units on the host:

systemctl restart tiger-bridge      # Express via tsx — no build step
cd dashboard && npm run build && systemctl restart tiger-dashboard

Env contracts:

  • bridge/.envTIGER_BRIDGE_TOKEN, LLM_GATEWAY_URL, LLM_GATEWAY_KEY, TIGER_ROUTER_MODEL, Telegram credentials
  • dashboard/.env.localTIGER_BRIDGE_URL, TIGER_BRIDGE_TOKEN

⚠️ The bridge token is also embedded in OpenClaw cron payloads (cron/jobs.json, twice). Rotate all four locations together.

Git

Forgejo is canonical (git.manohargupta.com/manohar/OpenClawDashboard, SSH port 2222); GitHub (manohar6839/NemoClawDashboard) is a public mirror — never commit secrets. Push to both:

git push origin main && git push github main