> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nagare.smtdfc.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Kênh Telegram

> Trò chuyện với Nagare và phê duyệt công cụ qua bot Telegram bằng plugin tích hợp sẵn.

Plugin Telegram (`nagare.plugin.builtins.telegram`) cho phép bạn trò chuyện với Nagare từ ứng dụng Telegram, nhận kết quả cron job và phê duyệt công cụ khi không ngồi trước máy.

## Cài đặt

**1. Tạo bot Telegram**

Trò chuyện với [@BotFather](https://t.me/BotFather), dùng lệnh `/newbot` và lưu lại **bot token**.

**2. Đặt biến môi trường cho gateway**

Plugin đọc token từ biến `NAGARE_TELEGRAM_TOKEN`. Plugin kế thừa môi trường của gateway, nên hãy đặt biến này trước khi khởi động gateway:

> [tab] Linux / macOS
>
> ```bash theme={null}
> export NAGARE_TELEGRAM_TOKEN="123456:ABC-your-bot-token"
> nagare gateway start
> ```

> [tab] Windows (PowerShell)
>
> ```powershell theme={null}
> $env:NAGARE_TELEGRAM_TOKEN = "123456:ABC-your-bot-token"
> nagare gateway start
> ```

**3. Cài plugin**

Gói plugin được cài sẵn tại:

```text theme={null}
~/.nagare/assets/plugins/builtins/nagare.plugin.builtins.telegram.nagare_plugin
```

Vào **Settings → Plugins → Install Plugin**:

* Trên giao diện web: tải lên tệp `.nagare_plugin` ở trên.
* Trên ứng dụng desktop: nhập đường dẫn tuyệt đối tới tệp.

Sau đó **kích hoạt** plugin. Xem [Tổng quan plugin](https://docs.nagare.smtdfc.net/plugins/overview.md#quan-ly-plugin).

**4. Bắt đầu trò chuyện**

Mở bot trên Telegram và gửi `/start`.

## Lệnh

| Lệnh | Mô tả |
| - | - |
| `/start` | Bắt đầu sử dụng bot. |
| `/help` | Xem danh sách lệnh. |
| `/ping` | Kiểm tra bot có phản hồi không. |
| `/chat_id` | Xem ID cuộc trò chuyện Telegram hiện tại. |
| `/reset` | Bắt đầu một phiên trò chuyện mới với Nagare. |
| `/model_providers` | Xem danh sách nhà cung cấp mô hình đã cấu hình. |
| `/approve <request-id>` | Chấp nhận một yêu cầu phê duyệt công cụ. |
| `/reject <request-id>` | Từ chối một yêu cầu phê duyệt công cụ. |

Mọi tin nhắn văn bản khác được chuyển tới Nagare như một tin nhắn trò chuyện bình thường.

## Phê duyệt công cụ

Khi Nagare cần chạy công cụ có rủi ro, bot gửi tin nhắn kèm hai nút **Approve** và **Reject**. Bạn cũng có thể dùng lệnh `/approve` hoặc `/reject` kèm ID yêu cầu.

## Lưu ý

> [!WARNING]
>
> Plugin không giới hạn người dùng Telegram nào được phép trò chuyện. Bất kỳ ai tìm thấy bot đều có thể gửi yêu cầu tới Nagare trên máy của bạn. Hãy giữ bí mật tên bot và luôn đọc kỹ yêu cầu phê duyệt trước khi chấp nhận.

* Bot dùng long polling, nên không cần mở cổng hay cấu hình webhook.
* Nếu cuộc trò chuyện không hoạt động trong **2 giờ**, kênh được giải phóng; tin nhắn tiếp theo sẽ tự kết nối lại.
* Nhật ký của plugin nằm tại `~/.nagare/logs/plugins/nagare.plugin.builtins.telegram.log`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.