🤖 NDTclaw

Trợ lý AI cá nhân chạy 24/7, điều khiển qua Telegram.
Nhắn việc — nó tự chạy lệnh, sửa file, tra cứu, tạo & gửi file, và nhớ lâu dài.

---

NDTclaw là gì?

NDTclaw là một agent AI thật sự sống trên máy tính của bạn. Khác với chat thông thường (mỗi cửa sổ là một khởi đầu trắng), NDTclaw:

• 💬 Nhận việc qua Telegram — nhắn như nói chuyện với người thật, mọi lúc mọi nơi.
• ⚙️ Tự làm việc trên máy — chạy lệnh, đọc/sửa file, tra web, tạo Excel/ảnh/PDF rồi gửi lại.
• 🧠 Nhớ lâu dài — nhớ qua cả những lần khởi động lại, tự tích luỹ hiểu biết về bạn.
• 📅 Chạy việc theo lịch — "mỗi sáng 8h tổng hợp báo cáo gửi tao" là nó tự làm.
• 💾 Tự backup dữ liệu quan trọng mỗi ngày.
• 🔄 Tự hồi sinh khi gặp sự cố — chạy nền 24/7, mở máy là có.

Lõi công nghệ: Claude Agent SDK của Anthropic — cùng bộ máy đằng sau Claude Code.

---

Cài đặt nhanh (Windows)

Cần chuẩn bị

Thứ	Lấy ở đâu
Python 3.10+	https://python.org
Node.js	https://nodejs.org (để đăng nhập Claude)
Tài khoản Claude	Gói Pro/Max (claude.ai) hoặc API key (platform.claude.com)
Bot Telegram	Nhắn @BotFather → /newbot

3 bước

1. Tải về & giải nén vào một thư mục, ví dụ C:\NDTclaw.

2. Đăng nhập Claude (một lần):

npm install -g @anthropic-ai/claude-code
claude

Chọn đăng nhập Claude.ai bằng tài khoản Pro/Max của bạn.

3. Chạy cài đặt tự động:

cd C:\NDTclaw
powershell -ExecutionPolicy Bypass -File install.ps1

Script tự lo: tạo môi trường → cài thư viện → hỏi token Telegram → đăng ký tự chạy khi mở máy.

Xong! Chạy bot:

schtasks /run /tn NDTclaw

Mở Telegram, nhắn /start cho bot của bạn.

---

Dùng thế nào?

Cứ nhắn tự nhiên:

Kiểm tra ổ C còn trống bao nhiêu
Tạo file Excel doanh thu 4 quý rồi gửi tao
Đọc file hợp đồng.pdf này, tóm tắt các điều khoản chính
Mỗi sáng 8h tổng hợp công việc gửi tao
nhớ giúp: file config của tao ở D:\project\config.json

Lệnh nhanh

Lệnh	Chức năng
/start	Khởi động
/lich	Xem việc định kỳ
/them <giờ> | <việc>	Thêm việc định kỳ
/nho	Xem trí nhớ dài hạn
/reset	Xoá ngữ cảnh, phiên mới
/id	Xem Telegram user ID

---

Bảo mật

• ⚠️ Không bao giờ chia sẻ file .env (chứa token bot).
• Luôn đặt ALLOWED_USER_IDS để chỉ mình bạn dùng được (bot có quyền chạy lệnh trên máy).
• NDTclaw dùng tài khoản Claude của chính bạn — không gửi dữ liệu cho bên thứ ba nào ngoài Anthropic.

---

Cấu trúc dự án

NDTclaw/
├── agent/bot.py          # Lõi: Telegram + agent
├── scheduler.py          # Lịch định kỳ + backup
├── skills/               # Kỹ năng tái sử dụng
├── install.ps1           # Cài đặt tự động
├── start_agent_hidden.vbs # Watchdog chạy nền
├── .env.example          # Mẫu cấu hình
└── requirements.txt      # Thư viện

---

Giấy phép

MIT License — tự do dùng, sửa, chia sẻ.

_{Made with ❤️ by NDT · Powered by Claude Agent SDK}