Kết nối FoneClaw với bot Telegram: tạo bot, ghép tài khoản và kiểm tra tác vụ đầu tiên
Hướng dẫn kết nối FoneClaw với bot Telegram riêng: tạo bot bằng BotFather, lưu token, ghép chat riêng trong 10 phút, kiểm tra ToDo và xử lý lỗi kết nối.
- Cách kết nối FoneClaw với bot Telegram là tạo một bot riêng bằng BotFather, giữ kín token và dùng bot đó làm cửa chat riêng để gửi yêu cầu tới FoneClaw.
- Sau khi lưu token trong Telegram Connections, hãy mở đúng bot của bạn, gửi “hello” trong vòng 10 phút và chờ xác nhận ghép nối trước khi gửi yêu cầu tác vụ.
- Kết nối bot chỉ là đường nhắn tin; tác vụ Android vẫn cần quyền liên quan, phê duyệt phù hợp trong FoneClaw và kết quả có thể kiểm tra trên điện thoại.
- Khi lỗi xảy ra, hãy phân biệt token sai, gửi nhầm bot, bot đã kết nối nơi khác, lỗi mạng hoặc xung đột webhook để tránh làm gián đoạn dịch vụ khác.
Tạo một bot Telegram riêng
Kết nối FoneClaw với bot Telegram khác với việc điều khiển ứng dụng Telegram bằng giọng nói. Ở đây, bạn tạo một bot Telegram riêng để gửi tin nhắn tới FoneClaw trong chat riêng. Nếu mục tiêu của bạn là thao tác trong app Telegram bằng giọng nói trên điện thoại, bài Điều khiển Telegram bằng giọng nói FoneClaw là tuyến hướng dẫn phù hợp hơn.
Để tạo bot, mở Telegram và tìm đúng BotFather chính thức của Telegram. Gửi lệnh /newbot, đặt tên hiển thị và tên người dùng của bot. Khi BotFather trả về token, hãy lưu nó ở nơi riêng tư. Token này dùng để xác thực bot, không phải mật khẩu tài khoản Telegram cá nhân và cũng không phải mã đăng nhập Telegram. Ai có token có thể điều khiển bot, vì vậy không gửi token vào nhóm chat, ghi chú chia sẻ hoặc ảnh chụp màn hình công khai.
Nên dùng một bot mới dành riêng cho FoneClaw. Nếu bạn tái dùng bot đang phục vụ một hệ thống khác, bot đó có thể đã có webhook hoặc cơ chế nhận tin riêng, dễ gây xung đột. Một bot riêng giúp bạn biết rõ tin nhắn nào thuộc FoneClaw, token nào đang được lưu và khi cần gỡ kết nối thì không ảnh hưởng tới dịch vụ khác.
Ghép tài khoản Telegram riêng của bạn
Trong FoneClaw, mở màn hình Telegram Connections. Dán token từ BotFather vào trường BotFather token, rồi dùng nút Save bot token. Sau khi lưu, hãy mở bot của chính bạn trong Telegram, không phải BotFather. Gửi đúng chữ “hello” trong vòng 10 phút và chờ thông báo xác nhận trước khi bắt đầu trò chuyện với FoneClaw qua bot.
Nếu cửa sổ ghép nối đã hết hạn, hãy chạm Connect this chat trên điện thoại để mở lại ghép nối cho chat này, rồi gửi đúng chữ “hello” tới bot của bạn trong cửa sổ 10 phút mới và chờ xác nhận. Nhãn Connect this chat nghĩa là kết nối chat hiện tại với FoneClaw; nó không phải nút tạo bot mới và cũng không thay thế token từ BotFather.
Điểm quan trọng là bot chỉ hỗ trợ chat riêng. Tài khoản Telegram gửi tin nhắn đầu tiên sẽ được ghép với kết nối đó. Vì vậy, hãy tự gửi “hello” từ tài khoản bạn muốn dùng. Đừng gửi token cho người khác để họ thử hộ; nếu họ nhắn trước, kết nối có thể gắn với tài khoản không đúng. Cũng đừng thêm bot vào nhóm và kỳ vọng FoneClaw đọc mọi cuộc trò chuyện trong nhóm hoặc mọi chat cá nhân của bạn.
Sau khi ghép nối thành công, bot là đường gửi yêu cầu tới FoneClaw. Nó không tự cấp quyền Android, không tự bỏ qua bước phê duyệt và không biến Telegram thành trung tâm điều khiển mọi tác vụ. Khi yêu cầu cần quyền hoặc xác nhận trên điện thoại, hãy xử lý trong FoneClaw theo màn hình hiện có.
Kiểm tra một kết quả Android được hỗ trợ
Sau khi ghép bot, hãy thử một việc nhỏ, dễ kiểm tra và không có ngày. Ví dụ gửi qua bot: “Tạo ToDo: kiểm tra pin dự phòng trong túi công tác.” Câu này không có ngày, không có thứ trong tuần và không có mốc tương đối, nên kết quả phù hợp là một ToDo chưa lên lịch. Đây là cách kiểm tra tốt vì bạn có thể mở danh sách ToDo và xem mục đã được lưu hay chưa.
Kết nối Telegram thành công chỉ chứng minh đường nhắn tin hoạt động. Để việc thật sự hoàn tất, FoneClaw vẫn cần hiểu yêu cầu, dùng hành động Android được hỗ trợ, có quyền liên quan và hiển thị kết quả để bạn kiểm tra. Nếu tác vụ cần phê duyệt, phê duyệt đó không mặc nhiên diễn ra trong Telegram. Hãy xem nội dung, nơi lưu và trạng thái trong FoneClaw trước khi coi việc đã xong.
Nếu bạn mới dùng FoneClaw, bài Cách dùng AI agent miễn phí trên Android với FoneClaw giúp kiểm tra tác vụ đầu tiên trên điện thoại. Nếu bạn muốn hiểu rõ hơn vì sao việc không ngày nên nằm trong phần chưa lên lịch, hãy đọc Lưu ToDo AI trên Android khi chưa có ngày. Để xem phạm vi tác vụ Android đang được trình bày công khai, có thể mở trang tính năng FoneClaw; khi cần cài đặt, dùng trang tải FoneClaw.
Chẩn đoán đúng lỗi kết nối
Khi bot không hoạt động, đừng tạo nhiều bot liên tiếp trước khi biết lỗi nằm ở đâu. Hãy tách lỗi theo dấu hiệu hiển thị: token, bot, tài khoản gửi tin đầu tiên, mạng hoặc xung đột với dịch vụ đang dùng bot.
| Dấu hiệu | Nguyên nhân thường gặp | Cách xử lý an toàn |
|---|---|---|
| Token bị từ chối | Dán thiếu ký tự, nhầm token của bot khác hoặc lấy từ nguồn không phải BotFather. | Quay lại BotFather, sao chép lại token đầy đủ và lưu lại trong FoneClaw. |
| Không có xác nhận sau khi gửi “hello” | Bạn nhắn BotFather, nhắn nhầm bot hoặc quá thời gian ghép nối. | Chạm Connect this chat trên điện thoại, mở đúng bot của bạn và gửi đúng “hello” trong cửa sổ 10 phút mới, rồi chờ xác nhận. |
| Bot báo đã kết nối | Bot có thể đang được dùng trong một kết nối hiện có. | Dùng bot riêng mới cho FoneClaw hoặc gỡ kết nối cũ nếu đó là kết nối của bạn. |
| Không liên hệ được Telegram | Mạng, Telegram hoặc thiết bị không truy cập được dịch vụ tại thời điểm đó. | Kiểm tra kết nối mạng, Telegram và thử lại sau khi dịch vụ ổn định. |
| Xung đột poller hoặc webhook | Bot đang được một dịch vụ khác nhận tin qua webhook hoặc cơ chế nhận tin riêng. | Ưu tiên tạo bot riêng mới. Chỉ gỡ webhook nếu bạn thật sự muốn dừng điểm nhận tin hiện tại của dịch vụ kia. |
Gỡ webhook không phải bước vô hại: nó dừng việc gửi cập nhật tới điểm nhận tin hiện tại của bot. Nếu bot đang dùng cho một hệ thống khác, hãy tạo bot mới cho FoneClaw thay vì cắt đường nhận tin của hệ thống đó.
Tạm dừng, tiếp tục hoặc gỡ kết nối
Sau khi kết nối hoạt động, bạn có thể quản lý nó theo nhu cầu. Nút Pause connection dùng khi bạn muốn tạm dừng nhận yêu cầu qua bot. Khi đã tạm dừng, cần dùng Resume connection để tiếp tục. Việc tạm dừng phù hợp khi bạn không muốn bot nhận yêu cầu trong một khoảng thời gian, nhưng vẫn muốn giữ cấu hình để dùng lại.
Nếu bạn cập nhật token của bot, FoneClaw giữ ghép nối và lịch sử chat cục bộ. Điều này hữu ích khi cần thay token nhưng vẫn muốn tiếp tục với cùng tài khoản Telegram đã ghép. Tuy vậy, nếu kết nối đang tạm dừng, bạn vẫn phải tiếp tục lại trước khi dùng. Token mới không tự biến kết nối đang tạm dừng thành đang hoạt động.
Khi gỡ kết nối, FoneClaw xóa token đã lưu, các yêu cầu đang chờ và bản ghi giao nhận liên quan tới kết nối đó; lịch sử chat cục bộ vẫn được giữ. Sau khi gỡ, bot Telegram vẫn tồn tại trên Telegram. Nếu bạn nghi token đã lộ hoặc muốn đổi thông tin đăng nhập của bot, hãy quản lý token qua BotFather; việc gỡ kết nối trong FoneClaw chỉ xóa thông tin đã lưu ở FoneClaw.
Kết nối Telegram giúp bạn gửi yêu cầu tiện hơn, nhưng không phải lời hứa luôn hoạt động mọi lúc hoặc điều khiển mọi thứ trên điện thoại. Hãy xem bot như một cửa nhắn tin riêng vào FoneClaw: yêu cầu đi vào qua Telegram, còn hành động Android vẫn phụ thuộc vào tác vụ được hỗ trợ, quyền hiện có, phê duyệt phù hợp và kết quả bạn có thể kiểm tra.