Lộ trình triển khai OpenClaw V3.1 trong 30 ngày

Mục tiêu: có khung hệ thống V3.1 rõ ràng trên máy phụ.

• Tạo thư mục gốc D:\AutoPost\.
• Tạo các thư mục: excel, db, config, logs, logs\screenshots, media, archive, scripts.
• Đặt quy tắc: Excel là source of truth, SQLite chỉ mirror.
• Ghi chú lại danh sách page sẽ dùng trong MVP: 3–5 page trước.

• Cài Chrome bản mới.
• Cài Python 3.10+ và bật Add to PATH.
• Cài Node.js 18+.
• Cài PM2 bằng npm nếu dùng Zalo command.
• Cài các thư viện Python cần dùng: openpyxl, pandas, sqlite-utils hoặc tương đương.

• Tạo 3–5 Chrome profiles đầu tiên.
• Login Facebook từng profile.
• Kiểm tra từng profile vào đúng page tương ứng.
• Không tạo đủ 10 profile ngay nếu chưa cần.
• Ghi mapping profile vào config.

• Tạo products_raw.xlsx.
• Tạo products_caption_ready.xlsx.
• Thêm sheet huong_dan cho mỗi file.
• Thêm 1 dòng mẫu sản phẩm để test.
• Khóa hoặc tô màu các cột OpenClaw không được sửa.

• Tạo database D:\AutoPost\db\system.db.
• Tạo bảng products.
• Tạo bảng post_jobs.
• Tạo bảng rate_limit_log.
• Tạo bảng system_logs.

• Viết sync_excel_to_sqlite.py.
• Đọc products_raw.xlsx vào bảng products.
• Đọc products_caption_ready.xlsx vào bảng post_jobs.
• Đảm bảo sync một chiều từ Excel sang SQLite.
• Test chống trùng bằng product_id hoặc product_url.

• Chạy thử sync với 3 dòng sản phẩm mẫu.
• Mở SQLite kiểm tra dữ liệu đúng.
• Kiểm tra không có module nào đang đăng thật.
• Viết ghi chú lỗi tuần 1 và sửa ngay các lỗi nhỏ.

• Tạo keywords.xlsx hoặc sheet seed.
• Nhập 20–50 keyword theo niche.
• Gán mỗi keyword vào page phù hợp.
• Đặt giới hạn mỗi keyword lấy bao nhiêu sản phẩm.

• Viết hoặc cấu hình module tìm sản phẩm theo keyword.
• Chỉ lấy dữ liệu cơ bản: tên, link, niche, giá/khoảng giá.
• Không viết caption ở bước này.
• Ghi thử 5 sản phẩm vào products_raw.xlsx.

• Thêm kiểm tra trùng theo product_url.
• Thêm kiểm tra trùng gần đúng theo tên sản phẩm nếu cần.
• Dòng trùng được đánh dấu duplicate, không xóa âm thầm.
• Test chạy lại collector 2 lần không tạo trùng hàng loạt.

• Quy chuẩn image_folder: D:\AutoPost\media\product_id\.
• Collector lưu số ảnh vào image_count.
• Không tải quá nhiều ảnh, ưu tiên 1–3 ảnh/sản phẩm.
• Ảnh lỗi thì status hoặc note phải ghi rõ.

• Định nghĩa status: need_review, approved, rejected, duplicate.
• Duyệt thử 20 sản phẩm đầu tiên trong Excel.
• Thêm ghi chú lý do reject nếu cần.
• Không đưa sản phẩm chưa approved sang file caption-ready.

• Lọc các dòng approved.
• Xuất bản sao để gửi viết caption.
• Đảm bảo đủ cột: tên, link, niche, giá, điểm nổi bật, đối tượng, lưu ý nhỏ, page.
• Không gửi dòng rejected/duplicate.

• Collector tự tạo được 20 sản phẩm/ngày.
• Excel raw dễ duyệt, không rối cột.
• Sync raw Excel → SQLite không lỗi.
• Có ít nhất 30 sản phẩm approved sẵn sàng viết caption.

• Nhập caption vào products_caption_ready.xlsx.
• Kiểm tra các cột: caption_main, comment_text, reply_text.
• Đặt caption_status = caption_ready.
• Đặt post_status = pending hoặc scheduled.

• Viết queue_manager.py.
• Đọc Excel caption-ready trước mỗi đợt đăng.
• Sync job sang SQLite.
• Chọn 1 job hợp lệ theo page và status.
• Không chọn job rejected/skipped/posted.

• Thiết lập max_posts_per_page_per_day = 2.
• Thiết lập khoảng cách tối thiểu 3 giờ giữa 2 bài cùng page.
• Ghi mọi action vào rate_limit_log.
• Test: nếu page đã đủ quota thì queue không chọn job đó.

• Chuẩn hóa prompt: nhận 1 job JSON.
• OpenClaw mở đúng Chrome profile.
• OpenClaw đăng caption + ảnh.
• OpenClaw trả kết quả dạng JSON.
• Timeout mỗi job tối đa 5 phút.

• Chạy test với nội dung rõ là bài test.
• Kiểm tra đúng profile, đúng page.
• Kiểm tra đăng ảnh thành công.
• Kiểm tra comment/reply nếu có.
• Xóa bài test nếu cần.

• Sau khi OpenClaw trả JSON, cập nhật SQLite.
• Ghi ngược về Excel các cột: post_status, posted_at, post_url, error_message.
• Nếu lỗi, lưu screenshot vào logs\screenshots.
• Không sửa các cột caption.

• Đăng test thành công ít nhất 3 job.
• Khi lỗi, job chuyển failed và có lý do.
• Excel và SQLite không lệch dữ liệu vận hành.
• Không có tình trạng OpenClaw click lung tung khi login expired.

• Chỉ đăng 1–2 bài thật trong ngày.
• Theo dõi Chrome, RAM, CPU khi đăng.
• Ghi lại mọi lỗi vào log.
• Không bật deal forwarding.

• Cấu hình Zalo command: status, dừng, tiếp tục.
• Thiết lập whitelist người được ra lệnh.
• Reporter gửi số bài pending/posted/failed.
• Không cho nhóm lạ kích hoạt lệnh.

• Viết backup_excel.py.
• Backup products_raw.xlsx, products_caption_ready.xlsx, system.db.
• Lưu vào archive\YYYYMMDD\.
• Giữ 7 ngày gần nhất, tự xóa bản cũ hơn.

• Lên lịch Product Collector lúc 00:30.
• Lên lịch Queue Manager lúc 08:50, 13:50, 19:50.
• Lên lịch Reporter lúc 22:00.
• Lên lịch Backup lúc 23:00.
• Nếu dùng Node/Zalo listener, chạy bằng PM2.

• Nếu 3 ngày trước ổn, tăng lên 3–5 bài/ngày.
• Vẫn giữ tối đa 2 bài/page/ngày.
• Không đăng 2 bài liên tiếp cùng profile.
• Kiểm tra rate limit log sau mỗi đợt đăng.

• Giả lập Chrome crash.
• Giả lập ảnh upload lỗi.
• Giả lập login expired.
• Job running quá 10 phút phải chuyển failed.
• Reporter báo lỗi dễ hiểu.

• Đọc lại 10 bài đã đăng.
• Kiểm tra có bịa thông số không.
• Kiểm tra văn phong có bị lặp không.
• Ghi lại tone nào hiệu quả nhất.
• Cập nhật hướng dẫn viết caption batch cho lần sau.

• Thống kê tỷ lệ posted/failed.
• Xác định lỗi phổ biến nhất.
• Sửa prompt OpenClaw nếu lỗi do thao tác UI.
• Sửa collector nếu sản phẩm tìm ra kém chất lượng.
• Không tăng quy mô nếu lỗi > 10%.

• Hệ thống chạy được ít nhất 7 ngày không lỗi nghiêm trọng.
• Product Collector tạo 20 sản phẩm/ngày ổn định.
• OpenClaw đăng 5–10 bài/ngày nếu đủ an toàn.
• Backup hoạt động.
• Quyết định có mở rộng lên 6–10 profile hoặc thêm Zalo deal forwarding Phase 2 hay không.