Tự động hóa Telegram cho Codex và Claude

Bot CLI cho đội vận hành AI.

Cài đặt nhanh Codex Bot và Claude Bot trên server của bạn, có tự động cập nhật, service systemd, gửi kết quả qua Telegram, theo dõi tiến trình dài và tài liệu rõ để dev hoặc bot khác phát triển tiếp.

Có sẵn những gì

Một gói cài đặt cho server thật: user riêng, service riêng, log rõ, cập nhật từ manifest public, kiểm tra SHA256 và thông báo Telegram khi cập nhật thành công.

Codex Bot

Chạy Codex CLI qua Telegram, giữ session, gửi kết quả dài theo nhiều phần và phù hợp cho tác vụ code/vận hành.

Claude Bot

Chạy Claude Code, gửi từng tiến trình trong transcript, theo dõi task dài và gửi kết quả cuối khi sẵn sàng.

Tự động cập nhật

Timer systemd đọc manifest, xác minh SHA256, cập nhật bot.py an toàn và khởi động lại service.

Cài đặt nhanh

Chọn hệ điều hành, chạy lệnh trên máy cần cài bot. Script sẽ tải package mới nhất từ domain này.

Trình cài đặt Linux
bash <(curl -fsSL https://bot.ahvclaw.com/downloads/telegram-cli-bot-setup/install.sh)

Cập nhật thủ công & sửa lỗi

Khi bot bị lỗi, người vận hành có thể chủ động kéo bản mới nhất, cài lại bộ cập nhật và khởi động lại service. Linux có lệnh cập nhật nhanh bằng systemd; Windows/macOS dùng lại trình cài đặt để sửa/cập nhật.

Cập nhật thủ công trên Linux
sudo systemctl start telegram-cli-bot-package-update.service && sudo journalctl -u telegram-cli-bot-package-update.service -n 80 --no-pager

Thêm Telegram ID

Bot từ v0.0.29 tự đọc lại ALLOWED_USER_ID khi file .env đổi, nên thêm ID xong có thể nhắn bot ngay, không cần restart. Nếu cần restart thủ công, dùng một lệnh ngắn ở dưới.

Lấy ID

Người dùng nhắn /whoami cho bot để lấy Telegram user id.

Thêm ID không restart

curl -fsSL https://bot.ahvclaw.com/downloads/telegram-cli-bot-setup/allow-telegram-id.sh | sudo bash -s -- both 638048624

Restart khi cần

sudo systemctl restart tg-codex-bot tg-claude-bot

Login Codex & Claude

Sau khi cài bot, mỗi CLI cần đăng nhập một lần bằng đúng user chạy service. Chạy lệnh phù hợp trên server, làm theo hướng dẫn hiện trên terminal, rồi kiểm tra service.

Login Codex

sudo -u codexproxy -H codex login
sudo systemctl restart tg-codex-bot

Login Claude

sudo -u claudeproxy -H claude login
sudo systemctl restart tg-claude-bot

Kiểm tra sau login

sudo systemctl status tg-codex-bot tg-claude-bot --no-pager
journalctl -u tg-claude-bot -n 80 --no-pager

Link tải chính thức

Đường dẫn mới cho trình cài đặt và tự động cập nhật. Đường dẫn cũ trên ahvclaw.com vẫn được giữ tương thích để máy cũ không bị gãy.

SHA256: đang tải...

Lỗi phổ biến & cách xử lý nhanh

Nếu chưa biết lỗi nằm ở đâu, hãy chạy lệnh sửa Linux ở trên trước. Script sẽ cập nhật package, khởi động lại service và in log gần nhất.

Bot im không trả lời

Chạy repair, sau đó xem systemctl status tg-codex-bot tg-claude-bot và log journal.

Telegram không nhận kết quả cuối

Đảm bảo bot đang từ v0.0.23 trở lên; bản mới forward tiến trình và kết quả cuối từ transcript.

Model Claude bị từ chối

Kiểm tra CLAUDE_MODEL trong file .env; đổi sang model còn quyền truy cập rồi restart service.

Update báo SHA256 không khớp

Không chạy zip đó. Tải lại manifest/zip từ domain này và kiểm tra hash trước khi cập nhật.

Service restart fail

Xem journalctl -u tg-claude-bot -n 120 --no-pager hoặc journalctl -u tg-codex-bot -n 120 --no-pager.

Thiếu dependency

repair.sh tự cài curl, python3, unzip trên apt/dnf/yum/apk khi có quyền root.