← Về thư mục
📄 / / opt / ai-os / INSTALL.md

🤖 INSTALL.md — Playbook cài đặt cho AI Agent

Mở thư mục này bằng một AI agent (Antigravity / Cursor / Claude Code / Codex — ưu tiên GUI cho người không rành kỹ thuật). Codex dùng tài khoản OpenAI (gộp với LLM key của bot); Claude Code chỉ cần đăng nhập, không cần API key. Bạn là AI agent đang giúp user cài CEO AI OS. Thực thi checklist dưới đây tuần tự. Sau MỖI bước: (1) cập nhật & in lại BẢNG TIẾN TRÌNH, (2) dùng đúng FORMAT THÔNG BÁO. Hỏi user khi cần thông tin. Dừng chờ duyệt ở bước nhạy cảm. Tiến trình hiện trong khung chat này (không gửi ra ngoài — giữ bảo mật).


📋 BẢNG TIẾN TRÌNH (in lại sau mỗi bước)

📋 CÀI ĐẶT CEO AI OS — [client]
[ ] 0. Chuẩn bị môi trường (paramiko, đọc tài liệu)
[ ] 1. Thu thập thông tin (VPS + bot + gateway)  →  tạo .env
[ ] 2. Cài Hermes (Phase 1)
[ ] 3. Cấu hình AI / LLM (9router tự host — hoặc gateway có sẵn)
[ ] 4. Kết nối Telegram (Phase 3)
[ ] 5. GitHub CLI (Phase 4 — tùy chọn)
[ ] 6. Nạp CEO AI OS (Bước 2: deploy_ceo_os)
[ ] 7. Kiểm tra & bàn giao

Ký hiệu trạng thái: [ ] chờ · [⏳] đang chạy · [✅] xong · [❌] lỗi · [⏭️] bỏ qua.


💬 FORMAT THÔNG BÁO (dùng NHẤT QUÁN)

Tình huống Format
Bắt đầu bước ⏳ Bước N/7 — <tên>: đang chạy…
Xong ✅ Bước N/7 — <tên>: xong. <1 dòng kết quả thật>
Lỗi ❌ Bước N/7 — <tên>: LỖI
• Triệu chứng: <dòng lỗi gốc, gọn>
• Nguyên nhân có thể: <…>
• Cách xử lý: <hành động>
• Cần user: <nếu cần>
Xin thông tin 🔑 Cần nhập: <field> — <hướng dẫn lấy ở đâu>
Dừng xác nhận ⏸️ Sắp <hành động nhạy cảm>. Xác nhận để tiếp tục? [Đồng ý] [Dừng]
Báo + gợi ý đổi (sau mỗi mốc lớn) ✅ <mốc> xong — <trạng thái thật>.
💡 Muốn đổi <điều có thể đổi>? Cứ nhắn mình (vd: "<câu mẫu>").
Hoàn tất 🎉 Xong! CEO AI OS đã sống. Mở Telegram → nhắn bot "/start" để bắt đầu.

🧭 CÁC BƯỚC CHI TIẾT

Bước 0 — Chuẩn bị môi trường

Bước 1 — Thu thập thông tin → tạo .env

Bước 2 — Cài Hermes (Phase 1)

Bước 3 — Cấu hình AI / LLM (chọn 1 cách)

Bước 4 — Kết nối Telegram (Phase 3)

Bước 5 — GitHub CLI (Phase 4 — tùy chọn)

Bước 6 — Nạp CEO AI OS + bật abilities

Bước 7 — Kiểm tra & bàn giao


⚠️ Quy tắc xuyên suốt