---
title: "Thêm máy Windows chạy tài khoản"
locale: vi
url: https://tlg.builera.app/docs/guides/nodes-windows
verified: 2026-10-24
app_version: "2.0"
---

# Thêm máy Windows chạy tài khoản

Tạo mã ghép nối, cài worker trên Windows và quản lý ngôn ngữ qua biểu tượng khay.


Bạn có thể dùng máy Windows hoặc VPS Windows của mình để giữ kết nối Telegram. Máy cần bật và duy trì kết nối mạng để nhận công việc.

## Ai làm được

Chủ hoặc Quản lý workspace tạo máy và mã ghép nối. Người cài cần đăng nhập vào Windows và có thể chạy PowerShell bằng tài khoản người dùng của mình.

## Cần chuẩn bị

- Máy Windows đáp ứng yêu cầu tương thích được hộp cài đặt hiển thị.
- Kết nối mạng cho phép tải bộ cài và kết nối dịch vụ.
- Quyền sử dụng máy trong thời gian tài khoản cần hoạt động.

Bộ cài chạy bằng quyền thường, không cần mở PowerShell với quyền Admin. Bộ cài tải môi trường Node riêng và kiểm tra bản phát hành.

Sức chứa mặc định là **20 tài khoản**, theo `DEFAULT_CAPACITY_WINDOWS`. Đây là cấu hình sức chứa, không phải cam kết mọi máy Windows đều chạy tốt ở mức đó.

## Bắt đầu ở đâu

**Máy chủ → Thêm máy → Máy Windows của tôi**.

## Các bước

1. Điền **Tên máy** để phân biệt máy trong workspace.
2. Bấm **Tạo mã ghép nối**.
3. Chọn **Ngôn ngữ trên máy** là **Tiếng Việt** hoặc **English**.
4. Bấm **Chép lệnh**.

   ![Hộp Thêm máy, thẻ Máy Windows của tôi, với ô tên máy và nút tạo mã ghép nối](https://tlg.builera.app/docs-media/vi/windows-pairing.webp "Đặt tên máy trước khi tạo mã")

> [!IMPORTANT]
> Lệnh cài chứa mã ghép nối. Không đưa nguyên lệnh vào ảnh, nhật ký công khai hoặc hội thoại hỗ trợ. Ảnh phải che cả vùng lệnh và mã, không chỉ che vài ký tự.

5. Mở PowerShell trên đúng máy Windows cần kết nối.
6. Dán và chạy nguyên lệnh vừa chép.

Lệnh mang lựa chọn `lang=vi` hoặc `lang=en` tương ứng với **Ngôn ngữ trên máy**. Không dùng một lệnh cũ đã hết hạn hay tự thay mã bằng mã của máy khác.

7. Theo dõi kết quả bộ cài trong PowerShell.
8. Quay về ứng dụng và chờ **Đã ghép nối máy Windows**.
9. Mở máy vừa thêm để kiểm tra trạng thái kết nối.

### Dùng biểu tượng khay

Bấm chuột phải biểu tượng Telegram-Auto để mở menu:

| Mục | Tác dụng |
|---|---|
| **Mở web** | Mở ứng dụng web |
| **Tạm dừng** / **Tiếp tục** | Điều khiển việc chạy worker trên máy |
| **Xem nhật ký** | Mở nhật ký cục bộ |
| **Ngôn ngữ** | Chọn **Tiếng Việt** hoặc **English** |
| **Ẩn biểu tượng** | Ẩn biểu tượng khay |

Đổi ngôn ngữ áp dụng ngay và được lưu vào cấu hình máy. Bộ gỡ cũng đọc lựa chọn ngôn ngữ đã lưu. **Ẩn biểu tượng** không phải thao tác gỡ phần mềm.

### Gỡ cài đặt và cài lại

> [!WARNING]
> Bộ gỡ dừng worker và xoá thư mục Telegram-Auto trên máy, gồm dữ liệu cục bộ trong thư mục đó. Chuyển tài khoản sang máy khác trước nếu cần duy trì hoạt động.

Chạy bộ gỡ theo đường dẫn bộ cài đã thông báo. Script bộ gỡ nằm tại `%LOCALAPPDATA%\TelegramAuto\uninstall.ps1`.

Xoá bản ghi máy trên web chỉ thu hồi khoá của máy Windows; không tự gỡ phần mềm cục bộ.

Để ghép nối lại, mở máy chưa ghép trong ứng dụng, tạo mã mới và chạy lệnh cài mới. Sau khi cài lại, kiểm tra trạng thái từng tài khoản; không mặc định phiên cục bộ cũ vẫn còn.

## Kết quả

Máy Windows xuất hiện trong workspace và worker nhận việc khi đang kết nối. Bạn có thể chọn máy khi thêm tài khoản.

## Kiểm tra

Kiểm tra trạng thái máy trên web và menu khay. Đừng để Windows ngủ hoặc tắt máy trong thời gian cần chạy tài khoản.

## Khi có lỗi

Mã hết hạn: bấm **Tạo mã mới** rồi chép lại lệnh. Lỗi chữ ký hoặc bản tải không khớp: dừng và kiểm tra thông báo, không tìm cách bỏ qua xác minh.

Xem [máy mất kết nối](https://tlg.builera.app/docs/troubleshooting/machine-offline).

## Làm bằng API hoặc MCP

Dùng [nodes.create_windows](https://tlg.builera.app/docs/reference/rest/nodes.create_windows) và [nodes.pairing_code](https://tlg.builera.app/docs/reference/rest/nodes.pairing_code). Tên MCP: `nodes_create_windows`, `nodes_pairing_code`.

API tạo thông tin ghép nối; bạn vẫn cần chạy bộ cài trên máy Windows.