Cài đặt: thông báo, khóa AI và bản sao riêng

Cài đặt nằm ở đâu

Mở kho trên GitHub → Settings → Secrets and variables → Actions. Có hai thẻ:

• Secrets: giá trị ẩn (token, khóa). Không ai đọc lại được và chúng bị che trong nhật ký.
• Variables: giá trị thông thường, không bí mật (mã ngôn ngữ, tên mô hình).

Thay đổi có hiệu lực từ lần chạy tiếp theo. Chạy ngay: Actions → research-agents → Run workflow.

Thông báo Telegram

Các tác tử nhắn cho bạn khi có điều quan trọng: trạng thái thị trường thay đổi, quy tắc H-020 vào hoặc ra, giả thuyết có kết luận mới, nguồn dữ liệu bị lỗi, và mỗi tuần một bản tóm tắt.

1. Trong Telegram mở @BotFather. Dùng bot có sẵn (/mybots → bot → API Token) hoặc tạo mới bằng /newbot.
2. Mở bot của bạn và nhấn Start, nếu không bot không được phép nhắn cho bạn.
3. ID trò chuyện: nhắn cho @userinfobot, nó trả về một số như 123456789. Với nhóm hoặc kênh, thêm bot vào đó; ID bắt đầu bằng -100.
4. Trong Settings → Secrets and variables → Actions → Secrets → New repository secret tạo TELEGRAM_BOT_TOKEN (token) và TELEGRAM_CHAT_ID (ID).
5. Ngôn ngữ: trong Variables → New repository variable tạo TELEGRAM_LANG với vi (hoặc en, ru, es, pt, tr, zh). Nếu không có, thông báo bằng tiếng Anh. Mỗi thông báo kết thúc bằng liên kết tới bảng điều khiển cùng ngôn ngữ.
6. Kiểm tra: Actions → research-agents → Run workflow, chọn test_alert rồi chạy. Sau vài phút sẽ nhận "đã kết nối thông báo Telegram". Nếu bước này lỗi, token hoặc ID sai, hoặc bot chưa được bắt đầu.

Thông báo chỉ gửi khi có thay đổi.

Khóa mô hình AI (tùy chọn)

Mọi kiểm tra đều do bộ máy thực hiện theo quy tắc cố định; không bao giờ hỏi mô hình xem ý tưởng có hiệu quả không. Khóa mô hình thêm hai trợ thủ:

• Tóm tắt tuần bằng lời đơn giản. Không có khóa, bạn nhận báo cáo thô bằng tiếng Anh. Có khóa, mô hình tóm tắt bằng ngôn ngữ của TELEGRAM_LANG, chỉ dùng số liệu trong báo cáo và không gợi ý giao dịch.
• Bản nháp giả thuyết mới mỗi tháng (ngày 1). Mô hình đề xuất ý tưởng dưới dạng pull request ở trạng thái draft. Bạn quyết định đăng ký cái nào; chưa đăng ký thì chưa kiểm tra.

Lựa chọn miễn phí: Groq. Đăng ký tại console.groq.com → API Keys → Create API Key và lưu khóa thành secret LLM_API_KEY. Không cần trả tiền (gói miễn phí có giới hạn theo ngày, thừa đủ cho tóm tắt tuần). Mô hình được chọn tự động trong các mô hình miễn phí Groq đang cung cấp (chúng bị đổi tên và ngừng); đặt CRL_LLM_MODEL để cố định một mô hình. Dịch vụ tương thích OpenAI khác (OpenRouter, Gemini) cũng dùng được: điền địa chỉ vào biến CRL_LLM_BASE_URL. Nếu có cả hai khóa, dùng LLM_API_KEY.

Cách kết nối Anthropic (trả phí):

1. Vào console.anthropic.com, đăng ký và nạp tiền trong Billing. API tính phí theo mức dùng, tách biệt với gói Claude; tóm tắt tuần và đề xuất tháng chỉ tốn vài xu mỗi tháng. Hãy kiểm tra trước rằng quốc gia của bạn có trong danh sách khu vực được Anthropic hỗ trợ.
2. API Keys → Create Key, sao chép khóa (sk-ant-…). Khóa chỉ hiện một lần.
3. Trong Settings → Secrets and variables → Actions → Secrets tạo ANTHROPIC_API_KEY với khóa đó.
4. Tùy chọn: biến CRL_LLM_MODEL để chọn mô hình khác (mặc định claude-sonnet-5-5).
5. Để bản nháp đến dưới dạng pull request: Settings → Actions → General → Allow GitHub Actions to create and approve pull requests.

Muốn tắt, hãy xóa secret. Nếu khóa bị lộ, thu hồi ngay trong console.

Bản sao riêng

Mọi thứ chạy trên máy chủ miễn phí của GitHub; máy tính của bạn không cần gì.

1. Mở https://github.com/f1devbin/Crypto-Research-Labs và nhấn Fork.
2. Trong bản sao: Settings → Pages → Source: GitHub Actions.
3. Actions → bật workflows nếu được hỏi → research-agents → Run workflow. Lần chạy đầu mất khoảng 20 phút (tải lịch sử giá). Sau đó tự chạy mỗi ngày.
4. Bảng điều khiển của bạn ở https://<tên-của-bạn>.github.io/Crypto-Research-Labs/.
5. Nếu muốn, thêm Telegram và khóa AI như mô tả ở trên.

Muốn đề xuất ý tưởng, xem CONTRIBUTING.md hoặc đăng trong Discussions → Ideas.

Tất cả cài đặt