Nhảy tới nội dung

Tích hợp Telegram Bot

Telegram là nền tảng được khuyến nghị nhất khi bắt đầu với OpenClaw vì tính ổn định cao, API mạnh mẽ và hoàn toàn miễn phí.

Tại sao chọn Telegram?
- **Dễ nhất**: Chỉ cần 1 Token là chạy ngay. - **Mượt nhất**: Hỗ trợ đầy đủ định dạng file, ảnh, và nút bấm (Inline Buttons). - **An toàn**: Bạn có thể giới hạn chính xác ai mới được phép trò chuyện với Bot.

Bước 1: Lấy Token từ @BotFather​

Để OpenClaw có thể "nói chuyện" trên Telegram, bạn cần tạo một con Bot ảo thông qua Bot chính thức của Telegram.

  1. Mở ứng dụng Telegram và tìm kiếm người dùng @BotFather.
  2. Gửi lệnh /newbot để bắt đầu.
  3. Đặt tên cho Bot: Đây là tên hiển thị (Ví dụ: OpenClaw Của Tôi).
  4. Đặt Username: Phải kết thúc bằng chữ bot (Ví dụ: my_openclaw_ai_bot).
  5. BotFather sẽ gửi cho bạn một chuỗi ký tự gọi là HTTP API Token. Hãy lưu nó lại thật kỹ!

Bước 2: Cấu hình OpenClaw​

Sau khi đã có Token, bạn có hai cách để kết nối:

Cách 1: Sử dụng CLI (Nhanh nhất)​

Mở terminal trên máy bạn đã cài OpenClaw và chạy lệnh:

openclaw channels login telegram

Nhập Token khi được yêu cầu. OpenClaw sẽ tự động kiểm tra kết nối và lưu vào cấu hình.

Cách 2: Chỉnh sửa file openclaw.json​

Mở file cấu hình (thường ở ~/.openclaw/openclaw.json) và thêm vào mục channels:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_TELEGRAM_TOKEN_HERE"
    }
  }
}

Bước 3: Bảo mật & Giới hạn người dùng​

Mặc định, bất kỳ ai biết username Bot của bạn đều có thể nhắn tin. Để đảm bảo an toàn (tránh tiêu tốn token AI bừa bãi), bạn PHẢI giới hạn quyền truy cập.

Chỉ cho phép người dùng cụ thể​

Bạn có thể lấy user_id bằng cách nhắn tin cho Bot @userinfobot. Sau đó cấu hình:

{
  "channels": {
    "telegram": {
      "allowedUsers": ["123456789", "987654321"]
    }
  }
}

Chế độ Pairing (Khuyên dùng)​

OpenClaw có tính năng "Pairing". Khi một người lạ nhắn tin, Bot sẽ không trả lời mà gửi một yêu cầu phê duyệt đến dashboard hoặc máy chủ Gateway. Bạn chỉ cần Approve một lần để cho phép họ.

Các tính năng nổi bật trên Telegram​

📄 Xử lý File & Tài liệu​

Gửi một file PDF hoặc văn bản cho Bot, kèm theo yêu cầu "Tóm tắt file này giúp tôi". OpenClaw sẽ đọc nội dung và trả lời ngay trong chat.

🖼️ Thị giác máy tính (Vision)​

Gửi ảnh cho Bot. Nếu bạn dùng model hỗ trợ Vision (như Claude 3.5 Sonnet), Bot có thể mô tả ảnh, trích xuất text từ ảnh (OCR) hoặc phân tích biểu đồ.

👥 Hoạt động trong Nhóm (Groups)​

Thêm Bot vào nhóm và cấu hình:

  • Mention-only: Bot chỉ trả lời khi được @mention.
  • Always-listening: Bot lắng nghe mọi tin nhắn (Cẩn thận chi phí API!).

Xử lý sự cố thường gặp​

🔴 Bot không trả lời​

  • Kiểm tra status: Chạy openclaw status xem Gateway có đang online không.
  • Kiểm tra Token: Thử lệnh openclaw logs --filter telegram để xem có lỗi "Unauthorized" không.
  • Mạng: Đảm bảo máy chủ của bạn không chặn kết nối tới api.telegram.org.

Bước tiếp theo​