abm1click-openclaw 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ABM — AI Business Master (https://abmedu.vn)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,163 @@
+# OneClick OpenClaw Launcher
+
+> **1 lệnh duy nhất** để cài đặt và cấu hình 9Router + OpenClaw — từ zero đến production-ready.
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue?logo=typescript)](https://www.typescriptlang.org/)
+[![Tests](https://img.shields.io/badge/tests-47%2F47-brightgreen)](./test)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen?logo=node.js)](https://nodejs.org/)
+
+---
+
+## ⚡ Quick Start
+
+```bash
+# Cài đặt toàn bộ (1 lệnh)
+npx oneclick-openclaw install
+
+# Hoặc global install
+npm install -g oneclick-openclaw
+oneclick-openclaw install
+```
+
+Chỉ cần 1 lệnh — hệ thống sẽ tự động:
+1. Kiểm tra môi trường (Node, npm, ports)
+2. Cài đặt & khởi động 9Router gateway
+3. Xác thực Google OAuth
+4. Cấu hình OpenClaw CLI
+5. Chạy smoke test end-to-end
+
+---
+
+## 📋 CLI Commands
+
+| Lệnh | Mô tả |
+|-------|--------|
+| `oneclick-openclaw install` | Cài đặt đầy đủ 14-step pipeline |
+| `oneclick-openclaw resume` | Tiếp tục từ checkpoint (sau lỗi) |
+| `oneclick-openclaw doctor` | Kiểm tra sức khỏe hệ thống |
+| `oneclick-openclaw dashboard` | Mở web dashboard (port 20199) |
+| `oneclick-openclaw auth google` | Xác thực lại Google OAuth |
+| `oneclick-openclaw logs` | Xem log cài đặt |
+| `oneclick-openclaw reset` | Xóa toàn bộ state, bắt đầu lại |
+| `oneclick-openclaw uninstall` | Gỡ cài đặt hoàn toàn |
+
+---
+
+## 🏗️ Architecture
+
+```
+                    ┌──────────────────────┐
+                    │   CLI (Commander.js)  │
+                    │   8 commands          │
+                    └──────────┬───────────┘
+                               │
+                    ┌──────────▼───────────┐
+                    │   State Machine      │
+                    │   14 steps           │
+                    │   Idempotent         │
+                    │   Resumable          │
+                    └──────────┬───────────┘
+                               │
+              ┌────────────────┼────────────────┐
+              │                │                │
+    ┌─────────▼──────┐ ┌──────▼───────┐ ┌──────▼───────┐
+    │  9Router       │ │  OpenClaw    │ │  Config      │
+    │  Adapter       │ │  Adapter     │ │  Adapter     │
+    │  (Gateway API) │ │  (CLI tool)  │ │  (JSON merge)│
+    └────────────────┘ └──────────────┘ └──────────────┘
+
+    ┌────────────────────────────────────────────────────┐
+    │  Web Dashboard (ABMedu Style)                      │
+    │  Real-time state | Service monitor | Pipeline view │
+    └────────────────────────────────────────────────────┘
+```
+
+---
+
+## 🎨 Dashboard
+
+Web dashboard tại `http://127.0.0.1:20199/dashboard`:
+
+- **Hero section**: Tổng quan hệ thống
+- **4 stat cards**: 9Router, OpenClaw, Auth, Smoke Test
+- **Service Monitor**: Trạng thái dịch vụ real-time
+- **Install Pipeline**: 14-step progress tracker
+- **Quick Actions**: 6 nút hành động nhanh
+- **Auto-refresh**: Cập nhật mỗi 5 giây
+
+```bash
+oneclick-openclaw dashboard
+```
+
+---
+
+## 🔧 Development
+
+```bash
+# Install dependencies
+npm install
+
+# Type check
+npm run lint
+
+# Run tests
+npm test
+
+# Development mode
+npm run dev -- install
+
+# Production build
+npm run build
+```
+
+### Project Structure
+
+```
+src/
+├── cli.ts                  # CLI entrypoint (8 commands)
+├── constants.ts            # Configuration constants
+├── types/contracts.ts      # TypeScript interfaces
+├── adapters/               # External system adapters
+│   ├── nineRouterAdapter.ts
+│   ├── openClawAdapter.ts
+│   └── configAdapter.ts
+├── state/                  # State machine + persistence
+│   ├── machine.ts
+│   ├── store.ts
+│   └── transitions.ts
+├── steps/                  # 14 step handlers
+├── process/                # Process management (spawn, ports, health)
+├── utils/                  # Utilities (logger, retry, fs, crypto)
+└── web/                    # Dashboard + auth pages
+    ├── server.ts
+    └── pages/ (4 HTML files)
+```
+
+---
+
+## 🔒 Security
+
+- **API key encryption**: AES-256-GCM trong state file
+- **Secret redaction**: Tự động ẩn keys trong logs
+- **Local-only server**: Bind `127.0.0.1` (không expose)
+- **Atomic writes**: State file không bị corrupt
+- **Backup trước patch**: Config backup tự động
+
+---
+
+## 🩺 Troubleshooting
+
+| Vấn đề | Giải pháp |
+|---------|-----------|
+| Port 20128 đã dùng | `oneclick-openclaw reset` rồi thử lại |
+| OAuth timeout | `oneclick-openclaw auth google` |
+| Config sai | `oneclick-openclaw doctor` để kiểm tra |
+| Muốn làm lại | `oneclick-openclaw reset && oneclick-openclaw install` |
+| Xem chi tiết lỗi | `oneclick-openclaw logs` |
+
+---
+
+## 📄 License
+
+MIT © [ABM — AI Business Master](https://abmedu.vn)

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node