Chào Claude. Mình là người không biết lập trình, muốn dựng một trợ lý AI chạy 24/365 trên Zalo, điều khiển qua Telegram. Máy chủ này là nơi bot sẽ chạy.

Việc 1: kiểm tra máy (hệ điều hành, RAM, ổ đĩa, mạng IPv4/IPv6) và báo lại bằng tiếng Việt dễ hiểu.
Việc 2: cài những gì cần cho một bot Node.js. Nếu RAM dưới 4 GB thì thêm swap 2 GB. Nếu máy không ra được mạng IPv6 thì cho Node ưu tiên IPv4.
Việc 3: trong thư mục này, tạo file .env mẫu (chỉ chủ sở hữu được đọc) và file CLAUDE.md để ghi lại mọi quyết định về bot.

Quy tắc làm việc với mình:
- Nêu kế hoạch trước, chờ mình đồng ý rồi mới làm.
- Hỏi mình trước mọi thao tác xoá hoặc khó hoàn tác.
- Không bao giờ yêu cầu mình dán khoá bí mật vào chat. Khi cần khoá, hướng dẫn mình tự mở file .env bằng nano và dán vào.

Trước khi viết code, hãy phỏng vấn mình từng câu một để viết bản đặc tả bot vào CLAUDE.md:
- Tên bot, giọng văn, cách xưng hô (chủ bot gọi là gì, người lạ gọi là gì).
- 3 chế độ công khai: Lao động (chỉ trả lời theo dữ liệu đã nạp; không có thì nói sẽ hỏi lại chủ và lưu thành tin chờ), Chém gió (trò chuyện tự do), Ngủ (im lặng nhưng vẫn nghe lệnh chủ).
- Các chế độ riêng tư chỉ phục vụ chủ trong chat riêng: Data Storage, Data Analysis, MoneyTalk, Workspace. Người khác nhắn vào chỉ được trả lời như chế độ Lao động.
- Chủ bot được nhận diện bằng mã số tài khoản, không bằng tên hiển thị.
- Bot xưng là trợ lý của chủ, không nhận là người thật khi bị hỏi thẳng.
- Tin nhắn Zalo không dùng định dạng markdown, tối đa khoảng 1.500 ký tự.

Xong thì tóm tắt lại bản đặc tả để mình duyệt. Chưa viết code ở bước này.

Dựng bảng điều khiển qua bot Telegram, dùng long polling (không cần mở cổng trên máy chủ). Token và Id của mình nằm trong .env (TELEGRAM_BOT_TOKEN, TELEGRAM_OWNER_ID); chỉ nhận lệnh từ đúng Id này.

Cần có:
- Bàn phím nút: đổi chế độ, /status, tin chờ, làm mới.
- /status hiện: chế độ hiện tại, số tin chờ, số tin đã gửi trong giờ và 24 giờ, model đang dùng.
- Tin chờ (câu bot chưa trả lời được) hiện kèm 2 nút Trả lời và Bỏ qua; mình bấm Trả lời rồi gõ nội dung thì bot gửi lại đúng người hỏi.
- Telegram cũng là nơi bot báo lỗi cho mình.

Cho bot chạy nền bằng systemd, tự chạy lại khi lỗi và khi máy khởi động lại. Xong thì gửi thử /status cho mình.

Kết nối tài khoản Zalo phụ cho bot bằng thư viện zca-js:
- Tạo mã QR đăng nhập và gửi ảnh QR qua Telegram cho mình quét. Nếu QR hết hạn thì tạo lại.
- Lưu phiên đăng nhập vào file riêng (chỉ chủ sở hữu đọc) để lần sau tự đăng nhập.

Thêm lớp an toàn để giảm rủi ro bị khoá:
- Đọc tin 1,5–4 giây trước khi soạn; hiện "đang soạn" theo độ dài câu, tối đa 20 giây.
- Giãn cách 4–9 giây giữa hai tin gửi đi.
- Giới hạn 20 tin/giờ mỗi hội thoại, 80 tin/giờ và 400 tin/24 giờ toàn tài khoản (chủ không bị giới hạn).
- Gộp các tin nhắn dồn dập trong 4 giây thành một lượt.
- Không bao giờ gửi tin rỗng.

Tạm thời trả lời bằng một câu chào cố định để mình thử kết nối; bộ não AI sẽ gắn ở bước sau.

Bộ não của bot dùng Hermes với đăng nhập gói ChatGPT của mình.
1. Kiểm tra Hermes đã có trên máy chưa (VPS iNet của Challenge CH21AI được giới thiệu là cài sẵn). Chưa có thì cài theo hướng dẫn chính thức của Hermes Agent.
2. Hướng dẫn mình chạy "hermes model", chọn "ChatGPT or Codex Subscription" và đăng nhập.
3. Cho bot gọi Hermes để trả lời tin nhắn. Khoá Hermes chỉ còn quyền trả lời chữ: không terminal, không đọc hoặc ghi file.
4. Đặt LLM_PROVIDER=hermes trong .env để sau này đổi qua lại.
5. Nhắn thử vài câu, báo mình mỗi câu mất bao lâu và máy còn bao nhiêu RAM.

Bộ não của bot dùng API Claude. Mình đã dán ANTHROPIC_API_KEY vào .env và đặt giới hạn chi tiêu tháng trong Claude Console.
1. Dùng model nhanh (Haiku) cho tin thường; chỉ dùng model mạnh khi thật sự cần.
2. Tắt chế độ suy nghĩ với tin thường. Câu trả lời bị cắt hoặc rỗng thì thử lại, không bao giờ gửi tin rỗng.
3. Mỗi tin ghi một dòng nhật ký: số token và chi phí ước tính.
4. Đặt LLM_PROVIDER=api trong .env.
5. Bật các chế độ đã đặc tả ở prompt 2 và nhắn thử: báo mình chi phí ước tính của 10 tin đầu.

Thêm chế độ Data Storage (chỉ chủ dùng trong chat riêng): hỏi đáp trên các trang Notion và thư mục Google Drive mình đã chia sẻ cho bot. Token Notion và file khoá Google mình đã đặt theo hướng dẫn của bạn.

Yêu cầu:
- Đọc PDF, Google Docs, Word (.docx); bỏ qua video, ảnh, bảng tính.
- Máy ít RAM: đọc từng tệp trong tiến trình con có giới hạn bộ nhớ; tệp nào gây lỗi thì bỏ qua và ghi lại; lưu tiến độ sau mỗi vài tệp.
- Chia tài liệu thành đoạn khoảng 900 ký tự. Tìm kiếm kiểu BM25, không phân biệt dấu, ưu tiên tên tài liệu; mỗi câu hỏi chỉ đưa 6–8 đoạn liên quan nhất cho AI.
- Luôn ghi tên tài liệu nguồn. Không có trong kho thì nói rõ, không được bịa.
- Notion báo lỗi 429 thì chờ rồi thử lại. Tự nạp lại mỗi 30 phút; thêm lệnh /sync để nạp ngay.

Thêm chế độ Workspace (chỉ chủ dùng):
- Mình gửi file recap cuộc họp (PDF, Word .docx, .txt) hoặc nhắn "thêm task ..., hạn ...". Lưu recap vào sổ tay MEETING trên NotebookLM nếu đã kết nối.
- AI trích từng task: tên việc, hạn chót, thời lượng ước tính, người phụ trách. Task của người khác chỉ lưu, không xếp vào lịch của mình.
- Chống trùng: hai task giống nhau ít nhất 75% từ và hạn cách nhau không quá 3 ngày thì coi là một; task đã xong không được "sống lại".
- Xếp task vào các sự kiện "Trả task" trên Google Calendar: hạn gần xếp trước, việc dài chia nhiều khung, ghi danh sách vào mô tả sự kiện, không đụng sự kiện khác. Thiếu thời gian thì báo thiếu bao nhiêu phút.
- Lệnh: /task, /xong <số>, /xep, /themtask.

Nhắc tự động theo giờ Việt Nam: 06:00 lịch hôm nay (sự kiện màu Tomato là quan trọng), 06:10 xếp lại task (chỉ nhắn khi có vấn đề), 08:00 task sắp hạn hoặc quá hạn, 20:00 lịch quan trọng ngày mai, 07:30 thứ Hai tổng kết task tồn đọng.

Dựng FinanceOS trong trang Notion "FinanceOS" mình đã chia sẻ:
- Bảng Hũ chi tiêu với 5 hũ: Thiết yếu 55%, Nâng cấp bản thân 20%, Hưởng thụ 10%, Tiết kiệm 10%, Cho đi 5% (mình có thể đổi tên và tỷ lệ sau).
- Bảng Giao dịch: nội dung, số tiền, loại (chi, thu, chi hộ, thu hộ), hũ, ngày, tháng, quý, năm.
- Bảng Tổng kết tháng, quý, năm và biểu đồ.

Ở chế độ MoneyTalk (chỉ chủ):
- Mình nhắn "cà phê 45k", "ăn tối 200k hôm qua", "nhận lương 15tr", nhiều khoản trong một tin, hoặc gửi ảnh hoá đơn. Bot ghi vào Giao dịch, tự chọn hũ, nhắn xác nhận ghi rõ hũ và ngày.
- Hạn mức hũ = tỷ lệ × thu nhập đã ghi trong tháng; chưa ghi thu nhập thì nhắc mình ghi. Cảnh báo khi hũ dùng tới 80% và khi vượt 100%, mỗi mốc một lần mỗi tháng.
- Sửa bằng lời: "huỷ khoản vừa rồi", "đổi sang hũ Thiết yếu", "đổi ngày thành 10/10".
- 21:00 ngày cuối tháng, quý, năm: gửi tổng kết, so với kỳ trước, 3 khoản chi lớn nhất.

Rà soát an toàn và độ bền cho bot:
1. File .env, phiên Zalo, file khoá Google: chỉ chủ sở hữu được đọc.
2. Tạo .claude/settings.json: cho phép đọc mã và xem nhật ký không cần hỏi; cấm đọc các file khoá (.env, phiên Zalo, khoá Google, hồ sơ NotebookLM, thư mục .ssh).
3. Bot tự chạy lại khi lỗi; chỉ báo "Bot đã chạy" qua Telegram nếu lần trước cách hơn 6 giờ.
4. Lưu mã bằng git; sao lưu thư mục dữ liệu mỗi ngày.
5. Ghi vào CLAUDE.md một checklist vận hành: xem bot có chạy không, đọc nhật ký, khởi động lại, việc cần làm khi bot im lặng.

Sau đó khởi động lại máy chủ và xác nhận bot tự chạy lại. Báo mình kết quả từng mục.

Mình muốn cập nhật và sửa bot ngay từ điện thoại qua Remote Control.
1. Hướng dẫn mình bật Remote Control cho thư mục bot này với tên "Trợ lý Zalo".
2. Cho Remote Control chạy nền bằng systemd để lúc nào cũng sẵn sàng, đặt giới hạn bộ nhớ hợp lý để không làm bot chậm.
3. Ghi vào CLAUDE.md quy trình mỗi lần sửa bot: mô tả việc cần sửa → nêu kế hoạch → chờ mình duyệt → sửa → kiểm tra cú pháp → khởi động lại bot → đọc nhật ký xác nhận → báo kết quả.

Khi mình nhắn từ điện thoại, hãy trả lời ngắn gọn, bằng tiếng Việt dễ hiểu.

Bot đang gặp sự cố: [mô tả, ví dụ: không trả lời tin Zalo], bắt đầu từ [thời điểm].

Đừng sửa ngay. Hãy:
1. Đọc 50 dòng nhật ký gần nhất của bot.
2. Cho mình biết lỗi nằm ở bước nào: nhận tin, gọi AI, đọc dữ liệu hay gửi tin, và nguyên nhân có khả năng nhất, giải thích bằng tiếng Việt dễ hiểu.
3. Đề xuất cách sửa nhỏ nhất và chờ mình đồng ý.
4. Sửa xong thì kiểm tra cú pháp, khởi động lại bot, đọc nhật ký để xác nhận bot đã chạy lại bình thường, rồi báo mình kết quả.