# Google Antigravity Remote Control：如何用手機控制代理程式

> 如何在桌面版 Google Antigravity 和 CLI 中啟用 Remote Control：設定開關、agy remote-control daemon，以及遇到連線問題時的處理方式。

Source: https://ailoot.ai/blog/zh-hant-tw/antigravity-remote-control-phone/
Canonical: https://ailoot.ai/blog/zh-hant-tw/antigravity-remote-control-phone/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-009
Revision: sha256-664f634216bab73bb0323d30160daa05ed5bc67c412ac1777df78057c0cef129


<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Ailoot 說明文件">

[Ailoot 說明文件](https://ailoot.ai/docs/) — 使用此服務的參考資料。

</div>

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="本節重點摘要">

重點摘要

在桌面版 Antigravity 2.0 中，可在 Settings → App 裡切換開關來啟用 Remote Control。使用相同的 Google 帳戶，即可在 antigravity.google.com 連線至工作階段。Antigravity CLI 有兩種模式：`/remote-control`（或 `--remote-control` 旗標）會在終端機工作階段期間開啟通道，而 `agy remote-control start` 會啟動背景守護程序，不需要開啟終端機。在 Linux 上，登出後守護程序仍會持續執行，並在重新開機後啟動；在 Windows 上，這需要由管理員安裝；在 macOS 和標準 Windows 安裝環境中，則會在下次登入時恢復執行。電腦必須保持開機並連上網際網路。帳戶或組織政策，或方案條件，都可能導致此功能無法使用。

</div>

如果你尚未安裝 Antigravity，請先閱讀 [Google Antigravity 是什麼，以及如何安裝](https://ailoot.ai/blog/zh-hant-tw/google-antigravity/)的概覽。這份指南適用於代理程式正在處理長時間任務（重構、執行測試、遷移相依套件），而你需要離開座位但仍想掌控工作階段的情況。

## Remote Control 是什麼，以及為什麼需要它

Remote Control 是 Google Antigravity 的一項功能，讓你能透過任何網頁瀏覽器，安全地連線並控制你電腦上的桌面與 CLI 工作階段。根據官方說明，大型任務可能需要很長時間，例如完整重構子系統、長時間執行測試，或複雜的相依套件遷移。Remote Control 讓你在離開電腦時仍能管理工作階段，同時將整個開發環境留在本機。

此功能適用於桌面應用程式 2.0 和 CLI（Antigravity 的終端機版本 `agy`），但兩者的啟用方式和運作方式不同。

## 在桌面版 Antigravity 2.0 啟用 Remote Control

你可以在應用程式設定中啟用 Remote Control：

1. 按 `Cmd + ,`（Linux 和 Windows 上按 `Ctrl + ,`）開啟 **Settings** 面板，或點選左側面板底部的 **Settings** 按鈕。
2. 前往 **App** 區段。
3. 將 **Enable Remote Control** 切換為 **On**。
4. *(選填)* 設定 **Nickname**，例如 `workstation-primary` 或 `server-machine`，方便你在已連線裝置清單中辨認這台電腦。

### 從手機或其他瀏覽器連線

若要開啟遠端工作階段：

1. 在任何裝置上開啟瀏覽器，前往 [Antigravity Remote Control Dashboard](https://antigravity.google.com)。在手機上，你也可以將網頁應用程式安裝到主畫面；代理程式完成任務或要求你回覆時，就會收到推播通知。
2. 使用你在桌面版上使用的相同 Google 帳戶登入。
3. 在裝置切換器中選取所需的電腦。
4. 連線後，你可以查看進行中的對話、為代理程式開始新任務，以及檢視實作計畫和成果。

如果網頁介面中沒有顯示該電腦，官方說明建議檢查三件事：執行 Antigravity 的電腦上已開啟 **Enable Remote Control** 開關；該電腦已連上網際網路且沒有進入睡眠；桌面應用程式和瀏覽器使用相同的 Google 帳戶。

如果你用來連線的裝置暫時失去網路連線，網頁介面會嘗試自動重新連線。只要執行 Antigravity 的電腦仍連上網際網路，代理程式的背景任務和從終端機啟動的命令就會在該電腦上不受影響地繼續執行。

<figure>
圖示：在筆電上切換 Remote Control 開關後，使用相同帳戶登入的手機即可接手控制
<figcaption>桌面版 Remote Control 的運作方式：在電腦上開啟開關，接著在手機上使用相同的 Google 帳戶登入。</figcaption>
</figure>



## Antigravity CLI 中的兩種 Remote Control 模式

CLI 有兩種模式：與特定終端機程序綁定的互動模式，以及不需要開啟終端機即可執行的背景無頭守護程序。

### 互動模式：`/remote-control`

你可以在目前的互動式 `agy` 工作階段中啟用 Remote Control，不必重新啟動 CLI。在輸入列執行：

```
/remote-control
```

根據官方說明，CLI 會為目前的工作階段開啟連線（反向通道），並印出主機名稱和連結，讓其他裝置開啟進行中的對話：

```
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.
```

在筆電、平板或手機的瀏覽器中開啟此連結，使用你在 CLI 中使用的相同 Google 帳戶登入，接著便可透過 Antigravity 網頁介面繼續這個工作階段。

若要在不結束本機終端機工作階段的情況下停用通道：

```
/remote-control off
```

你也可以在啟動時使用旗標，讓 CLI 一開始就啟用 Remote Control：

```
agy --remote-control
```

互動模式與 `agy` 程序綁定：退出 CLI（`/exit`、`Ctrl+C`、`Ctrl+D`）或關閉終端機視窗時，Remote Control 通道會自動結束，工作階段項目也會從儀表板消失。每個互動式 CLI 程序都有自己的工作階段 ID 和主機名稱，因此你可以在數個終端機分頁或工作目錄中同時執行 `agy --remote-control`。

從瀏覽器連線至互動式 CLI 工作階段時，兩端會即時同步。遠端裝置送出的要求會直接傳到本機終端機，而代理程式的推理、工具呼叫和程式碼變更則會顯示在遠端介面中。如果代理程式暫停並要求確認（`y`/`n`）或提出後續問題，你可以用手機或本機終端機回覆。設定是例外：你無法透過遠端網頁介面變更設定，只能在 CLI 本身操作。

### 無頭守護程序：`agy remote-control start`

第二種模式是持續執行的背景守護程序，會註冊為作業系統服務。只要電腦開機並連上網際網路，就能使用此服務；登出和重新開機後的行為則依平台而異。

```
agy remote-control start
```

守護程序會註冊為作業系統服務（Linux 上為 systemd 使用者服務、macOS 上為 LaunchAgent，或 Windows 上為排程工作），並立即啟動，不需要開啟終端機視窗。

使用 `agy remote-control status` 查看項目名稱。接著在 [Antigravity Remote Control Dashboard](https://antigravity.google.com) 選取這台電腦，並透過 Antigravity 網頁介面繼續操作。

以下三個命令可控制守護程序：

```
agy remote-control start     註冊並啟動守護程序
agy remote-control status    顯示守護程序狀態和執行個體名稱
agy remote-control stop      停止守護程序並取消註冊
```

守護程序會使用你登入 CLI 時所用的憑證。在同一台電腦上，登入 CLI 和登入 Antigravity 桌面編輯器是分開的；在瀏覽器中，請使用與 CLI 相同的 Google 帳戶。

你可以在啟動時使用 `--name` 旗標設定無頭守護程序的電腦名稱：

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

再次使用新的值執行 `start --name`，即可重新命名電腦。

如果你沒有設定名稱，守護程序會在首次啟動時產生一個易記的名稱（例如 `my-machine-distant-plume`）；`agy remote-control status` 會顯示目前名稱。你也可以在設定檔中重新命名：在 Linux/macOS 上開啟 `~/.gemini/config/config.json`，或在 Windows 上開啟 `%USERPROFILE%\\.gemini\\config\\config.json`，修改 `cliRemoteControlHostname` 的值、儲存檔案，再執行 `agy remote-control start` 重新啟動守護程序。服務重新啟動後，新名稱就會出現在儀表板上；守護程序執行期間，檔案變更不會生效。

檔案中有兩個相似欄位。`cliRemoteControlHostname` 是此處所說的 CLI 守護程序名稱。`remoteControlHostname` 則是同一台電腦上的 Antigravity 桌面編輯器所用的獨立欄位；在 Antigravity 2.0 中，你可以於 **Settings → App** 修改此值。

### 守護程序在登出和重新開機後的行為

行為依作業系統而異：

| 行為 | Linux | macOS | Windows |
|----|----|----|----|
| 啟動時機 | 開機時；不需登入 | 登入時 | 開機時（由管理員安裝時）；否則於登入時 |
| 登出後是否執行 | 是 | 否；下次登入時恢復 | 是，若已設定為開機時啟動 |
| 失敗後是否自動復原 | 是 | 是 | 是，最多嘗試重新啟動三次，之後會在下次開機或再次執行 `agy remote-control start` 時啟動 |

### Windows 專屬細節

若要在**系統開機時**註冊守護程序以便自動啟動，必須以管理員身分執行。你可以使用 PowerShell 或一般命令提示字元。一般視窗也能執行 `start` 命令，但登出或重新開機後，守護程序只會在下次登入時恢復，不會在開機時啟動。使用一般視窗且不提升權限，也能執行 `status` 和 `stop` 命令。

### 要選擇哪種模式

| 條件 | 互動模式（`/remote-control` / `agy --remote-control`） | 無頭守護程序（`agy remote-control start`）|
|----|----|----|
| 範圍 | 單一互動式終端機工作階段 | 整台電腦（背景作業系統服務） |
| 生命週期 | Remote Control 啟用期間且終端機工作階段正在執行時保持有效 | 在 Linux 和由管理員安裝的 Windows 上，登出和重新開機後仍持續執行；在 macOS 和標準 Windows 安裝環境中，會於下次登入時恢復 |
| 項目名稱 | 每個工作階段都不同（例如 `host-swift-falcon`） | 固定的電腦名稱（使用 `--name` 或 `cliRemoteControlHostname`） |
| 同時執行 | 同一台電腦上可同時執行多個終端機工作階段 | 每台電腦一個守護程序服務 |
| 直接連結 | CLI 會印出進行中對話的連結 | 透過 antigravity.google.com 的裝置切換器存取 |
| 適用情況 | 暫時離開正在處理任務的終端機，並從手機或瀏覽器繼續操作 | 電腦開機並連上網際網路時，持續遠端存取工作站或伺服器；須符合作業系統條件 |

互動模式足以讓你用手機管理目前的任務。如果你需要在沒有開啟終端機的情況下遠端存取，請依照作業系統條件使用無頭守護程序。

<figure>
圖示：關閉終端機後，工作階段通道會消失；背景守護程序則可在沒有開啟終端機的情況下執行
<figcaption>CLI 模式差異：互動式通道只會在終端機開啟時執行；無頭守護程序則可在沒有開啟終端機的情況下執行（須符合上表中的作業系統條件）。</figcaption>
</figure>

## 遇到連線問題時的處理方式

官方說明文件中的問題與解決方式：

| 看到的情況 | 原因 | 處理方式 |
|----|----|----|
| `Remote control is not enabled for your account` | 你的帳戶或組織政策尚未啟用 Remote Control 功能 | 聯絡你的工作區管理員，或確認你的方案是否支援 Remote Control |
| 儀表板中的項目消失（CLI） | `/remote-control` 和 `agy --remote-control` 建立的通道，會在你退出互動式工作階段（`/exit`、`Ctrl+C`）或執行 `/remote-control off` 時自動中斷連線 | 如果你需要在沒有開啟終端機的情況下讓電腦保持可用，請使用 `agy remote-control start` 安裝無頭守護程序 |
| 儀表板上出現來自同一台電腦的多個 CLI 項目 | 每個互動式 CLI 工作階段都有自己的主機名稱；開啟多個終端機時出現這種情況是正常的 | 不需採取任何動作；這是預期行為 |
| 儀表板上沒有顯示該電腦（守護程序） | CLI 登入可能有問題 | 執行 `agy remote-control status`；如果顯示登入問題，請執行 `agy`、重新登入，然後再次執行 `agy remote-control start` |
| 重新命名沒有生效 | 守護程序會在啟動時讀取名稱 | 再次執行 `agy remote-control start` 重新啟動守護程序 |
| Windows 上的守護程序只在登入時啟動，不在開機時啟動 | 執行 `start` 命令時沒有管理員權限 | 在提升權限的視窗中再次執行 `agy remote-control start` |
| 連線持續中斷並重新連線 | 透過安裝指令碼安裝的舊守護程序可能仍已註冊，並與新的守護程序競爭連線 | 再次執行 `agy remote-control start`；舊服務會自動移除 |
| 儀表板上同一台電腦出現兩個相似項目 | 一個項目是編輯器，另一個是 CLI 守護程序；它們刻意分開 | 重新命名其中一個，以便區分 |
| 網頁儀表板上沒有顯示該電腦（桌面版） | 開關可能已關閉、沒有網際網路連線、電腦可能在睡眠，或使用了不同的 Google 帳戶 | 檢查 **Enable Remote Control** 開關、電腦的網際網路連線、電腦是否處於睡眠狀態，以及兩端使用的帳戶是否相同 |

若要進行更深入的診斷，請查看守護程序記錄：Linux 上執行 `journalctl --user -u antigravity-cli-daemon -n 50`；macOS 上查看 `~/Library/Logs/antigravity-cli-daemon.log`；Windows 上查看 `%USERPROFILE%\\.gemini\\antigravity-cli\\log` 中最新的 `cli-*.log`。

無頭守護程序可讓你在沒有開啟終端機時存取電腦，包括人在外出時；但仍須符合電腦和作業系統的執行條件。如果你不再需要持續存取，請用 `agy remote-control stop` 停止守護程序。

另有一篇介紹 [Claude Code 中的遠端控制](https://ailoot.ai/blog/zh-hant-tw/claude-code-remote-control-phone/)的文章。若要透過 Telegram 控制另一個代理程式，請參閱[在 Telegram 中設定 Hermes Agent](https://ailoot.ai/blog/zh-hant-tw/hermes-agent-telegram-setup/)。

## 接下來

如果你使用 CLI 並想暫時離開目前的任務，請先使用互動模式。保持終端機開啟：如果將它關閉，通道就會中斷，工作階段項目也會從儀表板消失。若要在沒有開啟終端機的情況下存取電腦，請依照作業系統限制使用守護程序。

<div class="section" role="doc-bibliography" aria-label="資料來源">

### 資料來源

- [Antigravity Remote Control：官方說明文件](https://antigravity.google/docs/remote-control.md)
- [Antigravity Features：2.0 功能概覽](https://antigravity.google/docs/features.md)
- [Antigravity Getting Started：CLI 安裝](https://antigravity.google/docs/getting-started.md)

</div>



更多資料請見 [Ailoot](https://ailoot.ai/)。

## 常見問題：Google Antigravity Remote Control：如何用手機控制代理程式

### 關掉終端機，遠端工作階段為什麼消失？

互動 Remote Control 屬於執行中的 agy，結束程序會關隧道。不要開終端機也要可用時，請用 headless daemon 並檢查作業系統啟動條件。

### 儀表板找不到機器，先查什麼？

確認機器喚醒且上網、Remote Control 開啟，瀏覽器與桌面／CLI 為同 Google 帳戶。daemon 則用 agy remote-control status 查登入或服務問題。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。