Cài đặt Telegram Bot điều khiển AI Agent chứng khoán với Antigravity CLI

Trong quá trình xây dựng các công cụ kết nối dữ liệu chứng khoán và tự động hóa hệ thống cho vnstock, một trong những vấn đề khiến nhiều người trăn trở là: Làm sao để điều khiển một hệ thống AI của riêng mình mọi lúc mọi nơi mà không phải lúc nào cũng dính chặt lấy màn hình máy tính cá nhân? Việc cài đặt telegram bot kết hợp với công cụ dòng lệnh Google Antigravity CLI là giải pháp hoàn hảo cho bài toán này.

Các công cụ như Antigravity mang lại khả năng điều khiển AI Agent¹ vô cùng mạnh mẽ, nhưng việc phải thao tác qua máy tính lại khá bất tiện mỗi khi bạn cần di chuyển. Thực tế, không phải lúc nào chúng ta cũng có thể mở máy tính lên để làm việc. Do đó, khả năng ra lệnh cho AI trực tiếp qua ứng dụng chat trên smartphone là một lựa chọn tiện lợi và linh hoạt nhất.

Xuất phát từ chính nhu cầu thực tế này, dự án mã nguồn mở antigravity-cli-telegram đã ra đời. Trong bài viết hôm nay, mình sẽ chia sẻ với cộng đồng cách biến Telegram thành một cầu nối an toàn, đưa trợ lý AI lên môi trường làm việc 24/7 trên máy chủ VPS² cá nhân của bạn.

Hình ảnh repository Antigravity CLI x Telegram Bot được chia sẻ miễn phí bởi Vnstock qua Github

Kiến trúc hệ thống: Tại sao lại là Golang và Telegram?

Trước khi đi sâu vào lợi ích, hãy cùng lướt qua lý do tại sao dự án này lại chọn hai công nghệ cốt lõi dưới đây:

• Golang (Go): Việc lựa chọn Golang³ giúp bot cực kỳ nhẹ, hiệu suất cao và có thể biên dịch thành một file chạy độc lập duy nhất. Bạn không phải đau đầu cài đặt hàng tá môi trường hay thư viện phụ thuộc như python, rất lý tưởng để treo ngầm 24/7 trên máy chủ.
• Telegram: Thực tế, Discord cung cấp khả năng trình bày nội dung tin nhắn tốt hơn hẳn và có nhiều tính năng mạnh mẽ hơn cho bot. Tuy nhiên, việc cài đặt bot Discord có phần phức tạp hơn đối với phần đông người dùng. Telegram được chọn vì tính phổ biến, ứng dụng nhẹ và quá trình tạo bot cực kỳ đơn giản (chỉ cần chat với @BotFather).

Tại sao lại chọn giải pháp này thay vì các công cụ khác?

Có thể bạn đã từng nghe tới các công cụ wrapper API bên thứ 3 (như OpenClaw). Tuy nhiên, giải pháp sử dụng Antigravity CLI kết hợp Telegram Bot mang lại 3 lợi thế thực tiễn dễ nhận thấy:

1. Tận dụng tối đa gói Google AI sẵn có (Tiết kiệm chi phí): Thay vì phải trả phí đắt đỏ cho các lần gọi API từ OpenAI hay Anthropic, dự án này giao tiếp thông qua cơ chế chính thức của Antigravity CLI. Điều này có nghĩa là nó sử dụng trực tiếp tài khoản Google của bạn (nơi bạn có thể đã đăng ký gói Gemini 1.5 Pro hoặc Ultra) để thực thi.

2. Luồng giao tiếp chính thức (Không qua API trung gian thứ 3): Thay vì phụ thuộc vào một bên thứ 3 (như OpenClaw kiểm soát mọi giao tiếp), việc sử dụng trực tiếp Antigravity CLI là phương thức được hỗ trợ chính thức. Tuy nhiên, do yêu cầu xác thực trực tiếp dự án với tài khoản Google, bạn cần đặc biệt lưu ý về bảo mật: Phải dùng một tài khoản AI tách biệt hoàn toàn với tài khoản cá nhân chứa dữ liệu nhạy cảm. Tuyệt đối không đưa bot lên các máy chủ web công khai vốn có nguy cơ bị tấn công. Thay vào đó, bạn có thể chạy trên máy chủ ảo (VPS) riêng tư, hoặc đơn giản là cài đặt ngay trên máy tính cá nhân ở nhà – rất phù hợp cho những ai muốn cắm máy 24/24 nhưng chưa có đủ kinh nghiệm xử lý các cấu hình máy chủ phức tạp.

3. Cơ chế cách ly và Danh sách cho phép (Kiểm soát rủi ro hệ thống): Khi cấp quyền cho một trợ lý AI thực thi mã lệnh trên thiết bị, bạn phải chấp nhận những rủi ro nhất định nếu cấu hình sai. Để kiểm soát điều này, dự án cung cấp tính năng Cơ chế cách ly (Sandbox)⁴ (thông qua biến ALLOWED_DIRS), giới hạn cụ thể những thư mục mà AI được phép thao tác nhằm tránh tác động nhầm vào các file hệ thống quan trọng. Thêm vào đó, tính năng Danh sách cho phép (Whitelist)⁵ đảm bảo bot chỉ nhận lệnh từ đúng mã người dùng (User ID) đã được phê duyệt. Lưu ý: Người dùng bắt buộc phải hiểu rõ mình đang cấp quyền cho thư mục nào, vì cơ chế cách ly chỉ an toàn khi bạn cấu hình đúng.

Hướng dẫn cài đặt Telegram Bot tự động hoá hoàn toàn

Để triển khai công cụ này lên máy chủ, bạn không cần phải là một chuyên gia IT. Một điểm "ăn tiền" của repo này là nó đã được đóng gói kèm một kỹ năng AI sẵn sàng (antigravity-telegram-setup) để bạn ra lệnh kích hoạt.

Bạn chỉ cần kích hoạt trợ lý AI trên máy chủ và yêu cầu cài đặt, sử dụng giao diện Antigravity CLI để ra lệnh tự động hoàn thành toàn bộ quy trình:

• Tự động nhận diện hệ điều hành và cài đặt môi trường Go.
• Tải về và cấu hình Antigravity CLI nếu hệ thống chưa có.
• Tự động tải mã nguồn dự án từ Github.
• Tương tác để xin Token Telegram và thiết lập file cấu hình bảo mật .env.
• Tự động biên dịch file thực thi và cấu hình dịch vụ để bot chạy ẩn và tự khởi động lại 24/7.

Tất cả những gì bạn cần chuẩn bị là một con VPS, một API Token từ BotFather (trên Telegram), và quan sát Agent hoàn thành phần việc cực nhọc nhất.

Hướng dẫn điều hướng & Tối ưu cơ bản với Antigravity CLI

Trước khi đi vào thực chiến, có một vài lưu ý nhỏ để bạn làm chủ con bot này tốt hơn:

• Chuyển thư mục: Để chuyển vào đúng không gian làm việc, bạn cần biết đường dẫn của thư mục đó. Mẹo là hãy yêu cầu AI liệt kê cấu trúc thư mục từ một vị trí bất kỳ trước. Sau khi xác định được đường dẫn mong muốn, bạn chỉ cần dùng lệnh /dir <đường dẫn> để chuyển bot vào đó. Sử dụng lệnh "slash" để kích hoạt một lệnh đã định sẵn trên Telegram Bot
• Tuỳ biến Mô hình AI: Mặc định, hệ thống sử dụng mô hình Gemini 3.5 Flash (High) để đảm bảo tốc độ phản hồi chớp nhoáng. Tuy nhiên, nếu bạn gặp một bài toán cần suy luận sâu, bạn hoàn toàn có thể yêu cầu AI chuyển sang sử dụng mô hình khác mạnh mẽ hơn.
• Kiểm soát triển khai bầy Agent: Trên các môi trường máy chủ có hạn chế về tài nguyên (CPU/RAM), bạn cần dặn AI giới hạn việc tạo ra số lượng lớn sub-agents⁶ (các AI Agent phụ chạy đồng thời). Việc tạo quá nhiều AI phụ có thể vắt kiệt tài nguyên hệ thống, dẫn đến treo máy hoặc tự động khởi động lại máy chủ ngoài ý muốn.

Ứng dụng thực chiến cùng hệ sinh thái vnstock

Khi kết hợp Telegram Bot này cùng các thư viện lập trình và cấu trúc dự án sẵn có trong hệ sinh thái vnstock, bạn đang sở hữu một chuyên gia phân tích làm việc không ngừng nghỉ ngay trong khung chat điện thoại.

Tuy nhiên, một lưu ý cực kỳ quan trọng: Để tránh việc AI tự động "bịa" ra các đoạn code hoặc phân tích sai lệch logic nghiệp vụ, giải pháp này giả định bạn đã thiết lập sẵn các kịch bản kiểm thử⁷, các module truy vấn dữ liệu hoặc các quy trình xử lý (workflows⁸/skills⁹) cụ thể trong thư mục làm việc của mình. AI lúc này đóng vai trò là một điều phối viên¹⁰ thông minh nhận lệnh và thực thi chính xác các công cụ đã được thiết kế sẵn.

Dưới đây là một số Tình huống sử dụng thực tế giúp bạn hình dung cách vận hành bot chuyên nghiệp khi đang di chuyển:

• Chạy kịch bản kiểm thử chiến lược (Backtesting Workflow): Thay vì yêu cầu AI viết lại một kịch bản kiểm thử mới từ đầu, bạn chỉ định AI thực thi các workflow hoặc kịch bản đã được chuẩn hóa trong thư mục dự án để tính toán hiệu suất chiến lược.

  Nhắn cho Bot: "/dir /path/to/trading-system Hãy thực thi workflow /run-backtest trong dự án để chạy kiểm thử chiến lược MA20 chéo trên dữ liệu 1 năm của HPG, FPT. Sử dụng file cấu hình tham số tại configs/backtest_params.json và hiển thị bảng so sánh Sharpe Ratio¹¹."

• Khai thác cơ sở dữ liệu & Tự động tổng hợp báo cáo: Khi máy chủ tự động cào và lưu trữ dữ liệu thị trường hàng ngày vào database cục bộ (như DuckDB¹² hay SQLite¹³), bạn có thể hướng dẫn AI sử dụng các module phân tích có sẵn của dự án để trích xuất dữ liệu theo bộ lọc mong muốn.

  Nhắn cho Bot: "Sử dụng module insights_layer trong thư viện của dự án để quét database data/market.db. Trích xuất danh sách top 5 cổ phiếu nhóm thép có dòng tiền lớn (Cá mập) chủ động mua ròng nhiều nhất trong phiên hôm nay và lập bảng thống kê giá vốn trung bình của họ."

• Tự động chẩn đoán và khắc phục sự cố hệ thống (Troubleshooting Workflow): Nếu các tác vụ tự động¹⁴ như đồng bộ dữ liệu cuối ngày gặp lỗi do nghẽn mạng hay API¹⁵ bị timeout, bạn có thể gọi workflow xử lý sự cố để AI tự động quét nhật ký lỗi, tìm nguyên nhân và chạy lại tiến trình bù dữ liệu.

  Nhắn cho Bot: "/goal Thực thi workflow /troubleshoot-sync để chẩn đoán nhật ký lỗi của scheduler¹⁶ từ hôm qua đến nay. Nếu phát hiện tiến trình đồng bộ dữ liệu khớp lệnh bị gián đoạn giữa chừng, hãy chạy lại lệnh bù dữ liệu cho phiên giao dịch ngày 2026-07-07 và xác minh tính toàn vẹn của database."

Tất cả kết quả phân tích, bảng biểu thống kê, hay thậm chí đoạn mã sửa lỗi sẽ được AI phản hồi trực tiếp vào khung chat Telegram. (Và đừng lo về giới hạn 4096 ký tự của Telegram, bot đã có cơ chế tự động chia nhỏ tin nhắn khi kết quả trả về quá dài).

Lời kết

Giải pháp cầu nối antigravity-cli-telegram là một minh chứng cụ thể cho việc đưa sức mạnh của trợ lý AI vào tự động hoá quy trình làm việc thực tế. Vì là một dự án mã nguồn mở, mình rất mong nhận được sự quan tâm, trải nghiệm và đóng góp mã nguồn từ các anh em lập trình viên trong cộng đồng.

Nếu bạn thấy bài viết này hữu ích thông qua tìm kiếm và có chung niềm đam mê ứng dụng lập trình, dữ liệu vào đầu tư, hãy tham gia cộng đồng của chúng ta tại nhóm Facebook Vnstock Official. Đây là nơi những người đi trước sẵn sàng đồng hành, chia sẻ kiến thức để giúp bạn làm chủ các kỹ thuật xử lý dữ liệu và xây dựng hệ thống đầu tư độc lập. Hẹn gặp bạn trong nhóm!

---

Footnotes

1. AI Agent: Hệ thống trí tuệ nhân tạo có khả năng tự hoạt động, lập kế hoạch, tương tác với các công cụ và thực thi tác vụ một cách độc lập để đạt mục tiêu cụ thể. ↩

2. VPS (Virtual Private Server): Máy chủ riêng ảo hoạt động liên tục 24/7 trên môi trường internet, dùng để treo các chương trình chạy ngầm hoặc cơ sở dữ liệu. ↩

3. Golang (Go): Ngôn ngữ lập trình biên dịch do Google phát triển, nổi bật với tính gọn nhẹ, hiệu năng cực cao và quản lý bộ nhớ tốt. ↩

4. Cơ chế cách ly (Sandbox): Kỹ thuật phân tách môi trường thực thi, giới hạn các quyền thao tác tệp tin của chương trình để bảo vệ sự an toàn của toàn bộ hệ thống máy chủ. ↩

5. Danh sách cho phép (Whitelist): Cơ chế lọc bảo mật chỉ cho phép các thực thể hợp lệ (ví dụ: đúng Telegram User ID được cấu hình sẵn) gửi yêu cầu và nhận phản hồi. ↩

6. Sub-agents: Các Agent phụ được Agent chính khởi chạy độc lập để thực hiện các nhiệm vụ song song nhằm tối ưu hóa hiệu năng xử lý. ↩

7. Backtest: Quá trình chạy thử nghiệm một chiến lược giao dịch trên dữ liệu lịch sử để đánh giá hiệu quả trước khi mang ra áp dụng thực tế. ↩

8. Workflows (Luồng công việc): Các quy trình/kịch bản hướng dẫn từng bước được định nghĩa rõ ràng để AI thực hiện một loạt nhiệm vụ phức tạp. ↩

9. Skills (Kỹ năng): Tập hợp các chỉ dẫn, prompt chuyên sâu và logic code giúp mở rộng năng lực xử lý của Agent cho một công việc cụ thể. ↩

10. Orchestrator (Bộ điều phối): Vai trò của AI khi đứng ra điều hành, phân chia công việc cho các bộ công cụ hoặc sub-agents và tổng hợp kết quả cuối cùng. ↩

11. Sharpe Ratio (Hệ số Sharpe): Thước đo lợi nhuận ròng trên một đơn vị rủi ro của một chiến lược hoặc danh mục đầu tư. ↩

12. DuckDB: Hệ quản trị cơ sở dữ liệu quan hệ hướng cột tối ưu cao cho việc chạy các phân tích dữ liệu nhanh trực tiếp trong bộ nhớ ứng dụng. ↩

13. SQLite: Cơ sở dữ liệu nhẹ dạng tệp tin nhúng trực tiếp trong ứng dụng, lý tưởng để lưu trữ dữ liệu cục bộ nhỏ gọn. ↩

14. Cron job: Tiến trình lập lịch tự động chạy ngầm trên máy chủ Linux/Unix theo thời gian hoặc tần suất được quy định. ↩

15. API (Application Programming Interface): Giao diện lập trình ứng dụng đóng vai trò cầu nối giúp các phần mềm kết nối và trao đổi dữ liệu với nhau. ↩

16. Scheduler: Tiến trình lập lịch tự động chịu trách nhiệm quản lý và kích hoạt các tác vụ định kỳ trên máy chủ. ↩