Skip to content

README.md

Latest commit

 

History

History
110 lines (66 loc) · 2.69 KB

README.md

File metadata and controls

110 lines (66 loc) · 2.69 KB

FeiControl

💖 A cute little mission control for your OpenClaw ~

FeiControl is a real-time dashboard that sits alongside your OpenClaw installation. It reads agents, sessions, memory, and logs straight from the filesystem — no extra backend needed!

Fork from TenacitOS 🙏 — see ATTRIBUTION.md

🚀 Quick Start

git clone https://github.com/your-org/feicontrol.git
cd feicontrol
npm install
cp .env.example .env.local   # edit with your password & secrets ✏️

Then run!

npm run dev          # dev → http://localhost:3000
# or
npm run build && npm start   # production ✨

💡 Set OPENCLAW_DIR in .env.local if your OpenClaw isn't at the default ~/.openclaw

Screenshots

🏠 Dashboard — greeting, system health, agent team status & daily heartbeat

Dashboard

📅 Calendar — weekly view synced with Google Calendar & Tasks

Calendar

🏢 3D Office — isometric office with cherry blossoms, agent desks & real-time activity feed

3D Office

🏢 3D Office — Interior — peek inside your agents' workspace~

3D Office Interior

🏢 3D Office — Overview — full team overview with status dock

3D Office Overview

📝 Doc Viewer — browse & edit agent memory files (SOUL.md, TOOLS.md, etc.)

Doc Viewer

⏰ Cron Tasks — manage scheduled jobs with run history & manual triggers

Cron Tasks

💰 Cost Analysis — daily cost trends, per-agent breakdown & budget tracking

Cost Analysis

Requirements

  • Node.js 18+ (tested with v22)
  • OpenClaw running on the same host
  • PM2 or systemd for production 🌸

Tech Stack
🧩 Framework Next.js 15 (App Router)
🎨 UI React 19 + Tailwind CSS v4
🌸 3D React Three Fiber + Drei
📊 Charts Recharts
🗄️ Database SQLite (better-sqlite3)

Contributing

  1. Fork & create a feature branch
  2. Keep secrets in .env.local (gitignored~)
  3. Open a PR 💌

See CONTRIBUTING.md for details!

License

MIT — see LICENSE

Links