Tóm tắt nhanh
- OpenClaw-bot-review là dashboard web nhẹ để giám sát nhanh bot, model, session và gateway trong hệ sinh thái OpenClaw.
- Dự án không cần cơ sở dữ liệu riêng, vì dữ liệu được đọc trực tiếp từ
~/.openclaw/openclaw.jsonvà các file session cục bộ.- Dashboard có đủ lớp quan sát quan trọng cho vận hành hằng ngày: xem trạng thái bot, thống kê token, test model, test session, theo dõi gateway và kiểm kê skill.
- Cách triển khai đơn giản bằng Node.js hoặc Docker khiến công cụ này phù hợp cho cả homelab lẫn môi trường self-hosted quy mô nhỏ đến vừa.
Tại sao bạn cần một dashboard cho OpenClaw
Khi OpenClaw chỉ chạy một bot, việc kiểm tra thủ công vẫn còn chấp nhận được. Nhưng khi hệ thống mở rộng sang nhiều agent, nhiều model và nhiều platform như Feishu, Discord, Telegram hay WhatsApp, trạng thái vận hành bắt đầu phân tán. Lúc đó, người quản trị phải liên tục trả lời các câu hỏi như bot nào đang dùng model nào, session nào đang hoạt động mạnh, gateway có ổn định không, hay token đang bị tiêu tốn ở đâu.
OpenClaw-bot-review giải quyết đúng lớp vấn đề đó. Thay vì buộc bạn dựng thêm một hệ thống quan sát nặng nề, dự án gom các tín hiệu quan trọng vào một giao diện web thống nhất. Mục tiêu của nó không phải là thay thế toàn bộ stack observability cấp doanh nghiệp, mà là cung cấp một bảng điều khiển đủ dùng, sát với nhu cầu vận hành thực tế của người triển khai OpenClaw.
Vai trò của OpenClaw-bot-review trong quản lý vòng đời bot
Sau khi một AI agent được triển khai, công việc chưa kết thúc ở bước “chạy được”. Bạn còn phải quan sát, kiểm tra kết nối, xác minh model, theo dõi chi phí token và phát hiện dấu hiệu bất thường. OpenClaw-bot-review đóng vai trò như lớp vận hành nằm sát runtime.
Xem nhanh trạng thái bot
Trang tổng quan chính hiển thị các agent dưới dạng card. Mỗi card thể hiện tên, emoji, model đang dùng, platform binding, số session, token sử dụng và hoạt động gần nhất. Chỉ riêng lớp tổng quan này đã đủ trả lời nhiều câu hỏi thường gặp mà nếu không có dashboard, bạn sẽ phải mở config hoặc đọc log mới biết.
Thống kê session
Repository cho thấy dashboard đọc dữ liệu từ thư mục ~/.openclaw/agents/<agent>/sessions. Nó sử dụng sessions.json để liệt kê session và quét file .jsonl để tổng hợp token, message count, thời gian hoạt động cuối và response time trung bình. Đây là phần quan trọng nhất, vì session phản ánh hành vi thật của bot sau khi đã đi vào hoạt động.
Quản lý model
Trang model không chỉ liệt kê provider và model đang cấu hình, mà còn hiển thị context window, max output, hỗ trợ reasoning, bot nào đang sử dụng và có thể test model ngay từ giao diện. Với hệ thống có nhiều provider, đây là một lớp inventory rất hữu ích.
OpenClaw-bot-review lấy dữ liệu trạng thái như thế nào
Điểm kỹ thuật đáng chú ý nhất của dự án là cách lấy dữ liệu: không cần database trung gian.
Đọc trực tiếp từ openclaw.json
Trong lib/openclaw-paths.ts, dự án xác định OPENCLAW_HOME từ biến môi trường hoặc mặc định về ~/.openclaw, sau đó dùng đường dẫn đó để tìm openclaw.json. Route /api/config đọc file cấu hình này để dựng danh sách agent, model mặc định, fallback model, binding platform và thông tin gateway.
Lợi ích của cách làm này rất rõ: dashboard phản ánh đúng hệ thống đang chạy, không cần đồng bộ dữ liệu sang một kho riêng và cũng không tạo thêm gánh nặng bảo trì.
Đọc session và thống kê từ file local
Các route như /api/sessions/[agentId], /api/config và /api/stats-all đều làm việc trực tiếp với thư mục session của OpenClaw. Mã nguồn cho thấy dashboard quét file .jsonl, lấy usage token từ message assistant và ghép timestamp giữa user với assistant để tính thời gian phản hồi. Cách tiếp cận này đơn giản nhưng thực dụng, đặc biệt phù hợp với hệ thống self-hosted nơi dữ liệu runtime đã nằm sẵn trên máy.
Kiểm tra gateway và bài test kết nối
Một điểm hay khác là route /api/gateway-health không phụ thuộc vào một cách kiểm tra duy nhất. Nó thử endpoint health, fallback sang web probe và thậm chí gọi openclaw gateway status --json qua CLI. Cách thiết kế có lớp dự phòng như vậy làm dashboard đáng tin hơn trong môi trường vận hành thật.
Các tính năng chính của OpenClaw-bot-review
Giao diện tổng quan cho bot và agent
Trang chủ là nơi phù hợp nhất cho nhu cầu “nhìn một cái là hiểu”. Bạn có thể thấy toàn bộ agent, trạng thái hoạt động, gateway, refresh interval và các nút test nhanh cho model, platform hoặc session.
Thống kê session và biểu đồ token
Trang session giúp phân loại main, DM, group và cron. Trong khi đó, trang stats hiển thị token consumption và response time theo ngày, tuần hoặc tháng. Đây là nền tảng tốt để phát hiện bot nào đang bị tăng tải hoặc chậm dần theo thời gian.
Quản lý skill, alert và model
Ngoài model page, dự án còn có skill page để kiểm kê skill built-in, extension và custom. Alert center hỗ trợ rule như model unavailable, bot no response hoặc cron thất bại liên tiếp. Nhìn dưới góc vận hành, đây là bộ tính năng đủ dày để theo dõi một hệ OpenClaw thực chiến.
Phân tích ưu điểm “Lightweight”
Tinh thần của dự án rất rõ: gọn nhẹ. Nhưng đây không phải kiểu “lightweight” chỉ để quảng bá.
Thứ nhất, không cần database. Điều đó cắt bỏ một lớp triển khai và bảo trì đáng kể. Thứ hai, dự án tận dụng dữ liệu đã tồn tại trong OpenClaw thay vì bắt người dùng dựng thêm pipeline observability riêng. Thứ ba, stack công nghệ khá đơn giản: Next.js, TypeScript, Tailwind CSS và file system local.
So với các giải pháp giám sát nặng phải đi kèm exporter, collector, time-series database và dashboard engine riêng, OpenClaw-bot-review nhẹ hơn rất nhiều về công cài đặt lẫn chi phí vận hành. Đổi lại, nó tập trung đúng vào bài toán giám sát AI agent trong phạm vi ứng dụng.
Hướng dẫn chuẩn bị môi trường và cài đặt chi tiết
Bạn cần Node.js 18+ và một hệ thống OpenClaw đã cài đặt, với dữ liệu nằm trong ~/.openclaw hoặc một thư mục tùy chỉnh.
Cài đặt thủ công
Cài đặt thủ công bằng Git
Cách cài phổ biến nhất là clone repo, cài dependency và chạy server:
git clone https://github.com/xmanrui/OpenClaw-bot-review.git
cd OpenClaw-bot-review
npm install
npm run devQuick Start cũng cho thấy một biến thể khởi chạy bằng npm run dev, trong khi README nêu cách start dashboard và mở tại http://localhost:3000. Về mặt thực hành, npm run dev phù hợp cho test hoặc chỉnh sửa nhanh; còn môi trường production có thể dùng quy trình build/start theo các script của dự án.
Cài đặt qua Docker
Dự án hỗ trợ Dockerfile sẵn có. Bạn có thể build image, mở cổng 3000 và nếu cần thì mount thư mục OpenClaw vào container, đồng thời đặt OPENCLAW_HOME trỏ tới vị trí chứa openclaw.json.
docker build -t openclaw-dashboard .
docker run -d -p 3000:3000 openclaw-dashboardKhi OpenClaw không nằm ở đường dẫn mặc định, bạn có thể mount thư mục cấu hình và truyền OPENCLAW_HOME vào container. Đây là cách phù hợp cho môi trường server hoặc homelab, nơi dashboard cần chạy ổn định và tách biệt với môi trường phát triển.
Cách cấu hình kết nối với server OpenClaw hiện có
Yếu tố quan trọng nhất là dashboard phải đọc đúng thư mục dữ liệu OpenClaw. Mặc định, dự án đọc từ ~/.openclaw. Nếu hệ thống của bạn dùng vị trí khác, hãy đặt biến môi trường OPENCLAW_HOME trỏ đến thư mục chứa openclaw.json, agents/ và toàn bộ session data. Nếu mount sai thư mục hoặc thiếu quyền đọc, dashboard sẽ không thể phản ánh đúng trạng thái runtime.
Cách đọc các chỉ số trên giao diện web
Khi dùng OpenClaw-bot-review, nên ưu tiên ba nhóm tín hiệu: bot và platform binding để bắt lỗi kết nối, session count cùng token usage để theo dõi tải, và gateway health để xác định lỗi gốc ở lớp hạ tầng.
OpenClaw-bot-review là một dự án open-source nhỏ nhưng đánh đúng nhu cầu vận hành của hệ sinh thái OpenClaw. Nó cung cấp một OpenClaw dashboard tập trung, dễ tự triển khai, đủ chi tiết để giám sát AI agent, model và session theo thời gian thực mà không kéo theo một stack giám sát nặng nề.
Nếu bạn đang tìm một giải pháp self-hosted để quản lý AI bot và quan sát trạng thái OpenClaw mỗi ngày, đây là lựa chọn rất đáng thử: nhẹ, rõ và sát thực tế.
