{"id":48187998,"url":"https://github.com/boydfd/claw-agent-dashboard","last_synced_at":"2026-04-04T17:52:05.664Z","repository":{"id":345656002,"uuid":"1183034873","full_name":"boydfd/claw-agent-dashboard","owner":"boydfd","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-20T03:21:26.000Z","size":250,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-20T19:32:08.199Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boydfd.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-16T07:53:39.000Z","updated_at":"2026-03-20T14:48:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/boydfd/claw-agent-dashboard","commit_stats":null,"previous_names":["boydfd/claw-agent-dashboard"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/boydfd/claw-agent-dashboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boydfd%2Fclaw-agent-dashboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boydfd%2Fclaw-agent-dashboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boydfd%2Fclaw-agent-dashboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boydfd%2Fclaw-agent-dashboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boydfd","download_url":"https://codeload.github.com/boydfd/claw-agent-dashboard/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boydfd%2Fclaw-agent-dashboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31407655,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-04T17:52:05.300Z","updated_at":"2026-04-04T17:52:05.640Z","avatar_url":"https://github.com/boydfd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[中文](README_CN.md)\n\n# Claw Agent Dashboard\n\nA web-based management dashboard for [OpenClaw](https://github.com/openclaw/openclaw) AI agents. Monitor system health, browse agent workspaces, manage sessions, edit blueprints, and interact with your agents — all from a single UI.\n\n\u003c!-- ![Screenshot](docs/screenshot.png) --\u003e\n\n## What Is This?\n\n[OpenClaw](https://github.com/openclaw/openclaw) is a platform for running AI agents across multiple messaging channels (Signal, Telegram, Nextcloud Talk, etc.). Each agent has a **workspace** — a set of configuration files (personality, tools, memory, skills) that define its behavior.\n\n**Claw Agent Dashboard** gives you a centralized web interface to:\n\n- **See what your agents are doing** — live session history, message streams, model usage\n- **Edit how they behave** — modify blueprints, sync changes to workspaces, review diffs before applying\n- **Monitor your system** — CPU, memory, disk, Gateway health, all in real time\n- **Search across everything** — full-text search through files and session transcripts\n- **Talk to your agents** — send messages directly from the session detail page\n\nIt's designed for OpenClaw operators who want visibility and control without SSH-ing into their server.\n\n## Key Features\n\n### 🤖 Agent Management\n- **Workspace File Browser** — Browse all agent workspace files (`SOUL.md`, `AGENTS.md`, `TOOLS.md`, skills, memory, etc.) with syntax highlighting and in-browser editing\n- **Blueprint Editor** — View, compare, and sync blueprint-to-workspace changes with inline diff review. Blueprints are templates; workspaces are live — the dashboard shows you exactly what's different\n- **Global Skills Browser** — Explore globally installed OpenClaw skills and their configurations\n\n### 💬 Session Monitoring \u0026 Interaction\n- **Session Viewer** — Paginated message history for every agent session, showing provider, model, timestamps, tool calls, and thinking blocks\n- **Session Compose** — Send messages directly from the session detail page. Choose between:\n  - **Raw mode** — send plain text directly to the agent\n  - **Envelope mode** — wrap messages with OpenClaw-compatible context headers (channel, sender, timestamps) to simulate channel input\n- **Chat View Mode** — Toggle between detailed view (full verbose output including tool calls) and chat view (clean conversation showing only user messages and agent replies)\n- **Model Switching** — Switch the active model for any running session\n\n### 🔍 Search\n- **File Search** — Full-text search across all agent workspace files with jump-to-result and keyword highlighting\n- **Session Search** — Search across agent session transcripts (requires Elasticsearch) with hit highlighting\n\n### 📊 System Monitoring\n- **Dashboard** — Real-time system metrics: CPU, memory, disk, and network usage\n- **Gateway Health** — Monitor OpenClaw Gateway status, connectivity, and uptime\n- **Change Detector** — Background file watcher that detects workspace changes and notifies you\n\n### 📝 Other\n- **File Translation** — Translate any workspace file to Chinese using a configurable LLM service (OpenAI-compatible API)\n- **File Version History** — Track file changes over time with inline diff comparison and one-click restore to previous versions\n- **Mobile Responsive** — Full responsive layout for phones and tablets — manage your agents on the go\n- **Bilingual UI** — Complete English and Chinese interface\n\n## Quick Start\n\n### Prerequisites\n\n- [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/)\n- A running [OpenClaw](https://github.com/openclaw/openclaw) instance\n\n### Option A — Docker Hub (recommended)\n\n```bash\n# 1. Create a project directory\nmkdir claw-agent-dashboard \u0026\u0026 cd claw-agent-dashboard\n\n# 2. Download config files\ncurl -LO https://raw.githubusercontent.com/boydfd/claw-agent-dashboard/main/docker-compose.yml\ncurl -LO https://raw.githubusercontent.com/boydfd/claw-agent-dashboard/main/.env.example\ncp .env.example .env\n\n# 3. Edit .env — at minimum set OPENCLAW_HOME and GATEWAY_TOKEN\n#    (see Configuration below)\n\n# 4. Start\ndocker compose up -d\n```\n\n### Option B — Build from source\n\n```bash\ngit clone https://github.com/boydfd/claw-agent-dashboard.git\ncd claw-agent-dashboard\ncp .env.example .env\n# Edit .env\ndocker compose up -d --build\n```\n\nThen open [http://localhost:8080](http://localhost:8080).\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Description | Default |\n|----------|----------|-------------|---------|\n| `OPENCLAW_HOME` | Yes | Path to your OpenClaw home directory (`~/.openclaw`) | `~/.openclaw` |\n| `DATA_HOST_DIR` | Yes | Writable data directory for translations, version DB, config | `./data` |\n| `GATEWAY_URL` | No | OpenClaw Gateway URL | `http://host.docker.internal:18789` |\n| `GATEWAY_TOKEN` | Yes | Gateway authentication token (see below) | — |\n| `ALLOWED_ORIGINS` | No | CORS allowed origins (comma-separated) | `*` |\n| `OPENCLAW_SKILLS_DIR` | No | Path to global skills directory | — |\n| `OPENCLAW_LOGS_DIR` | No | Path to OpenClaw logs directory | — |\n| `OPENCLAW_AGENTS_DIR` | No | Custom agents directory (overrides `OPENCLAW_HOME/agents`) | — |\n\n### Getting `GATEWAY_TOKEN`\n\nThe dashboard authenticates with the OpenClaw Gateway to read sessions, switch models, and send messages. Find your token in OpenClaw's config:\n\n```bash\ncat ~/.openclaw/openclaw.json | python3 -c \"import sys,json; print(json.load(sys.stdin)['gateway']['auth']['token'])\"\n```\n\nOr look for `gateway.auth.token` in `~/.openclaw/openclaw.json`:\n\n```jsonc\n{\n  \"gateway\": {\n    \"auth\": {\n      \"mode\": \"token\",\n      \"token\": \"your-token-here\"   // ← copy this\n    }\n  }\n}\n```\n\n\u003e **Note:** If `gateway.auth.mode` is not `\"token\"`, the Gateway may not require authentication — you can leave `GATEWAY_TOKEN` empty.\n\n### Build Args (for proxy / mirror environments)\n\n| Build Arg | Description | Default |\n|-----------|-------------|---------|\n| `NPM_REGISTRY` | npm registry mirror | `https://registry.npmjs.org` |\n| `PIP_INDEX_URL` | pip index URL | `https://pypi.org/simple` |\n\n```bash\ndocker compose build \\\n  --build-arg NPM_REGISTRY=https://registry.npmmirror.com \\\n  --build-arg PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple\n```\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────┐\n│              Docker Container               │\n│                                             │\n│  ┌─────────────┐   ┌────────────────────┐  │\n│  │  Vue 3 SPA  │──▶│  FastAPI (:8080)   │  │\n│  │  (static)   │   │                    │  │\n│  └─────────────┘   │  REST APIs:        │  │\n│                     │  • /api/agents     │  │\n│                     │  • /api/status     │  │\n│                     │  • /api/translate  │  │\n│                     │  • /api/versions   │  │\n│                     │  • /api/search     │  │\n│                     │  • /api/blueprints │  │\n│                     │  • /api/settings   │  │\n│                     └───┬────────┬───────┘  │\n│                         │        │          │\n│                  ┌──────▼──┐ ┌───▼────┐     │\n│                  │ /agents │ │ /data  │     │\n│                  │ (r/w)   │ │ (r/w)  │     │\n│                  └─────────┘ └────────┘     │\n└─────────────────────────────────────────────┘\n         │                          │\n    ~/.openclaw               ./data\n   (agent workspaces,       (versions.db,\n    blueprints, config)      translations)\n```\n\n- **Frontend**: Vue 3 + Element Plus + Pinia, built with Vite, served as static files\n- **Backend**: FastAPI (Python) providing REST APIs, proxying to the OpenClaw Gateway for session and agent data\n- **Storage**: Bind-mounted host directories — `/agents` for OpenClaw home, `/data` for dashboard-specific data (SQLite version DB, translations, config)\n- **Process Manager**: supervisord runs the FastAPI server and a background worker (change detection, file version tracking)\n\n## Tech Stack\n\n| Layer | Technology |\n|-------|-----------|\n| Frontend | Vue 3, Element Plus, Pinia, Vite, markdown-it, highlight.js, Monaco Editor |\n| Backend | Python 3.12, FastAPI, httpx, aiosqlite |\n| Infrastructure | Docker, supervisord |\n| Testing | pytest (backend), Playwright (E2E) |\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\nCopyright 2026 Lin Ran.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboydfd%2Fclaw-agent-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboydfd%2Fclaw-agent-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboydfd%2Fclaw-agent-dashboard/lists"}