Google Antigravity Remote Control: Cách điều khiển tác nhân từ điện thoại

Nếu bạn chưa cài Antigravity, hãy bắt đầu với phần tổng quan về Google Antigravity là gì và cách cài đặt. Hướng dẫn này dành cho trường hợp tác nhân đang xử lý một tác vụ kéo dài (tái cấu trúc, chạy kiểm thử, di chuyển các gói phụ thuộc) và bạn cần rời bàn làm việc nhưng vẫn muốn kiểm soát phiên.

Remote Control là gì và vì sao bạn cần tính năng này#

Remote Control là một tính năng của Google Antigravity cho phép bạn kết nối an toàn với các phiên desktop và CLI trên máy của mình, rồi điều khiển chúng từ bất kỳ trình duyệt web nào. Theo mô tả chính thức, các tác vụ lớn—chẳng hạn như tái cấu trúc toàn bộ một hệ thống con, chạy kiểm thử lâu hoặc di chuyển các gói phụ thuộc phức tạp—có thể mất nhiều thời gian. Remote Control cho phép bạn quản lý phiên khi không ở gần máy tính, trong khi toàn bộ môi trường phát triển vẫn nằm trên máy của bạn.

Tính năng này hoạt động cả trong ứng dụng desktop 2.0 lẫn CLI—phiên bản Antigravity chạy trong terminal (agy)—nhưng cách bật và cách hoạt động khác nhau ở mỗi phiên bản.

Bật Remote Control trong Antigravity 2.0 trên máy tính để bàn#

Bạn có thể bật Remote Control trong phần cài đặt ứng dụng:

1. Mở bảng Settings bằng Cmd + , (hoặc Ctrl + , trên Linux và Windows), hoặc nhấp vào nút Settings ở cuối bảng bên trái.
2. Chuyển đến mục App.
3. Gạt Enable Remote Control sang On.
4. (Không bắt buộc) Đặt Nickname, chẳng hạn workstation-primary hoặc server-machine, để dễ nhận ra máy này trong danh sách thiết bị đã kết nối.

Kết nối từ điện thoại hoặc trình duyệt khác

Để mở phiên từ xa:

1. Mở trình duyệt trên bất kỳ thiết bị nào và truy cập Bảng điều khiển Antigravity Remote Control. Trên điện thoại, bạn cũng có thể cài ứng dụng web vào màn hình chính để nhận thông báo đẩy khi tác nhân hoàn thành tác vụ hoặc cần bạn phản hồi.
2. Đăng nhập bằng cùng tài khoản Google mà bạn dùng trên máy tính để bàn.
3. Chọn máy mong muốn trong bộ chuyển đổi thiết bị.
4. Sau khi kết nối, bạn có thể xem các cuộc trò chuyện đang hoạt động, bắt đầu tác vụ mới cho tác nhân và xem kế hoạch triển khai cùng các thành phẩm.

Nếu máy không xuất hiện trên giao diện web, hướng dẫn chính thức yêu cầu kiểm tra ba điều: nút Enable Remote Control trên máy tính đang chạy Antigravity đã được bật; máy tính đó có kết nối Internet và chưa chuyển sang chế độ ngủ; ứng dụng desktop và trình duyệt sử dụng cùng một tài khoản Google.

Nếu kết nối mạng trên thiết bị bạn đang dùng để kết nối tạm thời bị ngắt, giao diện web sẽ thử tự động kết nối lại. Các tác vụ chạy nền của tác nhân và lệnh được khởi chạy từ terminal vẫn tiếp tục chạy trên máy tính có Antigravity mà không bị gián đoạn, miễn là máy vẫn kết nối Internet.

Hai chế độ Remote Control trong Antigravity CLI#

CLI có hai chế độ: chế độ tương tác gắn với một tiến trình terminal cụ thể và daemon headless chạy nền mà không cần terminal đang mở.

Chế độ tương tác: /remote-control

Bạn có thể bật Remote Control trong phiên agy tương tác hiện tại mà không cần khởi động lại CLI. Chạy lệnh này trong dòng nhập:

/remote-control

Theo mô tả chính thức, CLI mở một kết nối—đường hầm ngược—cho phiên hiện tại và in tên máy chủ cùng liên kết đến cuộc trò chuyện đang hoạt động để mở trên thiết bị khác:

Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.

Mở liên kết này trong trình duyệt trên máy tính xách tay, máy tính bảng hoặc điện thoại, đăng nhập bằng cùng tài khoản Google mà bạn dùng trong CLI, rồi tiếp tục làm việc trong phiên thông qua giao diện web Antigravity.

Để tắt đường hầm mà không kết thúc phiên terminal cục bộ:

/remote-control off

Bạn có thể khởi chạy CLI với Remote Control đã được bật bằng cách dùng cờ khi khởi động:

agy --remote-control

Chế độ tương tác gắn với tiến trình agy: khi bạn thoát CLI (/exit, Ctrl+C, Ctrl+D) hoặc đóng cửa sổ terminal, đường hầm Remote Control tự động kết thúc và mục phiên biến mất khỏi bảng điều khiển. Mỗi tiến trình CLI tương tác có session ID và tên máy chủ riêng, vì vậy bạn có thể chạy đồng thời agy --remote-control trong nhiều tab terminal hoặc thư mục làm việc.

Khi kết nối với phiên CLI tương tác từ trình duyệt, hai phía đồng bộ theo thời gian thực. Yêu cầu từ thiết bị từ xa được chuyển thẳng đến terminal cục bộ, trong khi quá trình suy luận, lời gọi công cụ và thay đổi mã của tác nhân hiển thị trên giao diện từ xa. Nếu tác nhân tạm dừng để yêu cầu xác nhận (y/n) hoặc đặt câu hỏi tiếp theo, bạn có thể trả lời từ điện thoại hoặc terminal cục bộ. Cài đặt là ngoại lệ: bạn không thể thay đổi chúng từ giao diện web từ xa mà chỉ có thể thay đổi trong CLI.

Daemon headless: agy remote-control start

Chế độ thứ hai là daemon chạy nền liên tục và đăng ký dưới dạng dịch vụ của hệ điều hành. Dịch vụ khả dụng khi máy đang bật và kết nối Internet; hành vi sau khi đăng xuất và khởi động lại phụ thuộc vào nền tảng.

agy remote-control start

Daemon đăng ký dưới dạng dịch vụ của hệ điều hành (dịch vụ systemd cấp người dùng trên Linux, LaunchAgent trên macOS hoặc Scheduled Task trên Windows) và khởi động ngay mà không cần mở cửa sổ terminal.

Dùng agy remote-control status để xem tên mục. Sau đó chọn máy này trên Bảng điều khiển Antigravity Remote Control và tiếp tục làm việc qua giao diện web Antigravity.

Ba lệnh dùng để điều khiển daemon:

agy remote-control start     Register and start the daemon
agy remote-control status    Show the daemon's status and instance name
agy remote-control stop      Stop the daemon and unregister it

Daemon sử dụng thông tin xác thực bạn đã dùng để đăng nhập CLI. Đăng nhập CLI tách biệt với đăng nhập vào trình chỉnh sửa desktop Antigravity trên cùng máy; trong trình duyệt, hãy dùng cùng tài khoản Google như trong CLI.

Bạn có thể đặt tên máy cho daemon headless bằng cờ --name khi khởi động:

agy remote-control start --name "my-workstation"

Chạy lại start --name với một giá trị mới sẽ đổi tên máy.

Nếu không đặt tên, daemon sẽ tạo một tên dễ nhớ (chẳng hạn my-machine-distant-plume) trong lần khởi chạy đầu tiên; agy remote-control status hiển thị tên hiện tại. Bạn cũng có thể đổi tên trong tệp cài đặt: mở ~/.gemini/config/config.json trên Linux/macOS hoặc %USERPROFILE%\.gemini\config\config.json trên Windows, thay đổi giá trị của cliRemoteControlHostname, lưu tệp rồi chạy lại agy remote-control start để khởi động lại daemon. Tên mới sẽ xuất hiện trên bảng điều khiển sau khi dịch vụ khởi động lại; các thay đổi trong tệp không có hiệu lực khi daemon đang chạy.

Trong tệp có hai trường tương tự nhau. cliRemoteControlHostname là tên daemon CLI được nói đến ở đây. remoteControlHostname là trường riêng dành cho trình chỉnh sửa desktop Antigravity trên cùng máy; trong Antigravity 2.0, bạn có thể đổi trường này trong Settings → App.

Daemon hoạt động thế nào sau khi đăng xuất và khởi động lại

Hành vi tùy thuộc vào hệ điều hành:

Chi tiết dành riêng cho Windows

Để đăng ký daemon tự khởi động khi hệ thống khởi động, cần chạy với quyền quản trị viên. Bạn có thể dùng PowerShell hoặc Command Prompt thông thường. Lệnh start cũng chạy được từ cửa sổ thông thường, nhưng sau khi đăng xuất hoặc khởi động lại, daemon chỉ tiếp tục chạy ở lần đăng nhập tiếp theo chứ không phải khi máy khởi động. Các lệnh status và stop chạy được từ cửa sổ thông thường mà không cần quyền nâng cao.

Nên chọn chế độ nào

Chế độ tương tác đủ để quản lý tác vụ hiện tại từ điện thoại. Nếu cần truy cập từ xa mà không phải mở terminal, hãy dùng daemon headless, tùy theo điều kiện của hệ điều hành.

Cách xử lý sự cố kết nối#

Các sự cố và cách giải quyết theo tài liệu chính thức:

Để chẩn đoán sâu hơn, hãy kiểm tra nhật ký daemon: trên Linux, chạy journalctl --user -u antigravity-cli-daemon -n 50; trên macOS, kiểm tra ~/Library/Logs/antigravity-cli-daemon.log; trên Windows, kiểm tra tệp cli-*.log mới nhất trong %USERPROFILE%\.gemini\antigravity-cli\log.

Daemon headless cho phép truy cập mà không cần terminal đang mở, kể cả khi bạn ở xa, tùy thuộc vào điều kiện hoạt động của máy tính và hệ điều hành. Nếu không còn cần quyền truy cập liên tục, hãy dừng daemon bằng agy remote-control stop.

Có bài viết riêng về điều khiển từ xa trong Claude Code. Để điều khiển một tác nhân khác qua Telegram, xem cách thiết lập Hermes Agent trong Telegram.

Tiếp theo#

Nếu làm việc trong CLI và muốn rời khỏi tác vụ hiện tại, hãy bắt đầu bằng chế độ tương tác. Để terminal mở: nếu đóng terminal, đường hầm sẽ ngắt kết nối và mục phiên biến mất khỏi bảng điều khiển. Để truy cập máy mà không cần terminal đang mở, hãy dùng daemon tùy theo giới hạn của hệ điều hành.

Xem thêm tài liệu trên Ailoot.