บล็อก

Google Antigravity Remote Control: วิธีควบคุมเอเจนต์จากโทรศัพท์

Markdown

วิธีเปิดใช้ Remote Control ใน Google Antigravity บนเดสก์ท็อปและใน CLI: สวิตช์, เดมอน agy remote-control และวิธีแก้ปัญหาการเชื่อมต่อ

อ่านบทความฉบับเต็ม

เอกสารประกอบ Ailoot — เอกสารอ้างอิงเกี่ยวกับการใช้บริการ

ประเด็นสำคัญ

ใน Antigravity 2.0 บนเดสก์ท็อป ให้เปิดใช้ Remote Control ด้วยสวิตช์ใน Settings → App คุณสามารถเชื่อมต่อกับเซสชันที่ antigravity.google.com โดยใช้บัญชี Google เดียวกัน Antigravity CLI มีสองโหมด: /remote-control (หรือแฟล็ก --remote-control) จะเปิดอุโมงค์ไว้ตลอดช่วงที่เซสชันเทอร์มินัลทำงาน ส่วน agy remote-control start จะเปิดเดมอนเบื้องหลังโดยไม่ต้องเปิดเทอร์มินัล บน Linux เดมอนจะทำงานต่อหลังจากคุณออกจากระบบ และเริ่มทำงานหลังรีบูต; บน Windows ต้องติดตั้งโดยผู้ดูแลระบบ; บน macOS และการติดตั้ง Windows แบบมาตรฐาน เดมอนจะกลับมาทำงานเมื่อเข้าสู่ระบบครั้งถัดไป คอมพิวเตอร์ต้องเปิดอยู่และเชื่อมต่ออินเทอร์เน็ต ฟีเจอร์นี้อาจใช้งานไม่ได้เนื่องจากนโยบายบัญชีหรือองค์กร หรือข้อกำหนดของแพ็กเกจ

หากคุณยังไม่ได้ติดตั้ง Antigravity ให้เริ่มจากภาพรวมของ Google Antigravity คืออะไรและติดตั้งอย่างไร คู่มือนี้เหมาะสำหรับกรณีที่เอเจนต์กำลังทำงานยาวอยู่ (ปรับโครงสร้างโค้ด รันทดสอบ ย้ายไลบรารีที่ต้องพึ่งพา) และคุณต้องออกจากโต๊ะทำงานแต่ยังต้องการควบคุมเซสชัน

Remote Control คืออะไรและทำไมจึงจำเป็น

Remote Control เป็นฟีเจอร์ของ Google Antigravity ที่ช่วยให้คุณเชื่อมต่อกับเซสชันบนเดสก์ท็อปและ CLI ในเครื่องของคุณอย่างปลอดภัย และควบคุมเซสชันเหล่านั้นจากเว็บเบราว์เซอร์ใดก็ได้ ตามคำอธิบายอย่างเป็นทางการ งานขนาดใหญ่ เช่น การปรับโครงสร้างระบบย่อยทั้งหมด การรันทดสอบที่ใช้เวลานาน หรือการย้ายไลบรารีที่ต้องพึ่งพาซึ่งซับซ้อน อาจใช้เวลานาน Remote Control ช่วยให้คุณจัดการเซสชันขณะอยู่ห่างจากคอมพิวเตอร์ โดยสภาพแวดล้อมการพัฒนาทั้งหมดยังคงอยู่ในเครื่องของคุณ

ฟีเจอร์นี้ใช้ได้ทั้งในแอปเดสก์ท็อปเวอร์ชัน 2.0 และใน CLI ซึ่งเป็น Antigravity เวอร์ชันเทอร์มินัล (agy) แต่การเปิดใช้และการทำงานแตกต่างกันในแต่ละแบบ

เปิดใช้ Remote Control ใน Antigravity 2.0 บนเดสก์ท็อป

คุณสามารถเปิดใช้ Remote Control ได้ในการตั้งค่าแอป:

  1. เปิดแผง Settings ด้วย Cmd + , (หรือ Ctrl + , บน Linux และ Windows) หรือคลิกปุ่ม Settings ที่ด้านล่างของแผงด้านซ้าย
  2. ไปที่ส่วน App
  3. สลับ Enable Remote Control เป็น On
  4. (ไม่บังคับ) ตั้ง Nickname เช่น workstation-primary หรือ server-machine เพื่อให้จดจำเครื่องนี้ในรายการอุปกรณ์ที่เชื่อมต่อได้ง่าย

เชื่อมต่อจากโทรศัพท์หรือเบราว์เซอร์อื่น

วิธีเปิดเซสชันระยะไกล:

  1. เปิดเบราว์เซอร์บนอุปกรณ์ใดก็ได้ แล้วไปที่ แดชบอร์ด Antigravity Remote Control บนโทรศัพท์ คุณยังติดตั้งเว็บแอปไว้บนหน้าจอหลักเพื่อรับการแจ้งเตือนแบบพุชเมื่อเอเจนต์ทำงานเสร็จหรือขอคำตอบจากคุณได้ด้วย
  2. เข้าสู่ระบบด้วยบัญชี Google เดียวกับที่ใช้บนเดสก์ท็อป
  3. เลือกเครื่องที่ต้องการในตัวสลับอุปกรณ์
  4. เมื่อเชื่อมต่อแล้ว คุณจะเห็นบทสนทนาที่กำลังใช้งาน เริ่มงานใหม่ให้เอเจนต์ และดูแผนการทำงานกับชิ้นงานได้

หากเครื่องไม่ปรากฏในหน้าเว็บ คำแนะนำอย่างเป็นทางการระบุให้ตรวจสอบสามอย่าง: สวิตช์ Enable Remote Control บนคอมพิวเตอร์ที่ใช้ Antigravity เปิดอยู่; คอมพิวเตอร์เชื่อมต่ออินเทอร์เน็ตและไม่ได้เข้าสู่โหมดพัก; และแอปเดสก์ท็อปกับเบราว์เซอร์ใช้บัญชี Google เดียวกัน

หากการเชื่อมต่อเครือข่ายบนอุปกรณ์ที่คุณใช้เชื่อมต่อขาดหายชั่วคราว หน้าเว็บจะพยายามเชื่อมต่อใหม่โดยอัตโนมัติ งานเบื้องหลังของเอเจนต์และคำสั่งที่เปิดจากเทอร์มินัลจะทำงานต่อบนคอมพิวเตอร์ที่ใช้ Antigravity โดยไม่หยุดชะงัก ตราบใดที่เครื่องยังเชื่อมต่ออินเทอร์เน็ต

แผนภาพ: สวิตช์ Remote Control บนแล็ปท็อปจะถ่ายโอนการควบคุมไปยังโทรศัพท์เมื่อเข้าสู่ระบบด้วยบัญชีเดียวกัน
วิธีทำงานของ Remote Control บนเดสก์ท็อป: เปิดสวิตช์บนคอมพิวเตอร์ จากนั้นเข้าสู่ระบบบนโทรศัพท์ด้วยบัญชี Google เดียวกัน

Remote Control สองโหมดใน Antigravity CLI

CLI มีสองโหมด ได้แก่ โหมดโต้ตอบที่ผูกกับกระบวนการเทอร์มินัลหนึ่งชุด และเดมอนแบบ headless เบื้องหลังที่ทำงานโดยไม่ต้องเปิดเทอร์มินัล

โหมดโต้ตอบ: /remote-control

คุณสามารถเปิดใช้ Remote Control ในเซสชัน agy แบบโต้ตอบที่กำลังใช้อยู่ได้โดยไม่ต้องเริ่ม 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.

เปิดลิงก์นี้ในเบราว์เซอร์บนแล็ปท็อป แท็บเล็ต หรือโทรศัพท์ เข้าสู่ระบบด้วยบัญชี Google เดียวกับที่ใช้ใน CLI แล้วทำงานต่อในเซสชันผ่านหน้าเว็บ Antigravity

วิธีปิดอุโมงค์โดยไม่จบเซสชันเทอร์มินัลในเครื่อง:

/remote-control off

คุณสามารถเริ่ม CLI โดยเปิด Remote Control ไว้แล้วได้ด้วยการใช้แฟล็กเมื่อเริ่มทำงาน:

agy --remote-control

โหมดโต้ตอบผูกอยู่กับกระบวนการ agy: เมื่อคุณออกจาก CLI (/exit, Ctrl+C, Ctrl+D) หรือปิดหน้าต่างเทอร์มินัล อุโมงค์ Remote Control จะสิ้นสุดโดยอัตโนมัติ และรายการเซสชันจะหายไปจากแดชบอร์ด กระบวนการ CLI แบบโต้ตอบแต่ละชุดมี session ID และชื่อโฮสต์ของตัวเอง คุณจึงเรียก agy --remote-control พร้อมกันได้ในแท็บเทอร์มินัลหรือไดเรกทอรีทำงานหลายแห่ง

เมื่อคุณเชื่อมต่อกับเซสชัน CLI แบบโต้ตอบจากเบราว์เซอร์ ทั้งสองฝั่งจะซิงก์แบบเรียลไทม์ คำขอจากอุปกรณ์ระยะไกลจะส่งตรงไปยังเทอร์มินัลในเครื่อง ขณะที่การให้เหตุผล การเรียกใช้เครื่องมือ และการเปลี่ยนแปลงโค้ดของเอเจนต์จะแสดงในหน้าเว็บระยะไกล หากเอเจนต์หยุดเพื่อขอการยืนยัน (y/n) หรือถามคำถามต่อ คุณตอบจากโทรศัพท์หรือเทอร์มินัลในเครื่องได้ การตั้งค่าเป็นข้อยกเว้น: คุณเปลี่ยนจากหน้าเว็บระยะไกลไม่ได้ ต้องเปลี่ยนจาก CLI เท่านั้น

เดมอนแบบ headless: agy remote-control start

โหมดที่สองคือเดมอนเบื้องหลังที่ทำงานต่อเนื่องและลงทะเบียนเป็นบริการของระบบปฏิบัติการ โดยจะใช้งานได้เมื่อเครื่องเปิดอยู่และเชื่อมต่ออินเทอร์เน็ต ส่วนการทำงานหลังออกจากระบบและรีบูตขึ้นอยู่กับแพลตฟอร์ม

agy remote-control start

เดมอนลงทะเบียนเป็นบริการของระบบปฏิบัติการ (บริการ systemd ระดับผู้ใช้บน Linux, LaunchAgent บน macOS หรือ Scheduled Task บน Windows) และเริ่มทำงานทันทีโดยไม่ต้องเปิดหน้าต่างเทอร์มินัล

ใช้ agy remote-control status เพื่อดูชื่อรายการ จากนั้นเลือกเครื่องนี้ใน แดชบอร์ด Antigravity Remote Control แล้วทำงานต่อผ่านหน้าเว็บ Antigravity

คำสั่งสามรายการใช้ควบคุมเดมอน:

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

เดมอนใช้ข้อมูลรับรองที่คุณใช้เข้าสู่ระบบ CLI การเข้าสู่ระบบ CLI แยกต่างหากจากการเข้าสู่ระบบตัวแก้ไขเดสก์ท็อป Antigravity บนเครื่องเดียวกัน ในเบราว์เซอร์ให้ใช้บัญชี Google เดียวกับใน CLI

คุณตั้งชื่อเครื่องของเดมอนแบบ headless ได้ด้วยแฟล็ก --name เมื่อเริ่มทำงาน:

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

การรัน start --name อีกครั้งด้วยค่าใหม่จะเปลี่ยนชื่อเครื่อง

หากไม่ตั้งชื่อ เดมอนจะสร้างชื่อที่จำง่าย (เช่น my-machine-distant-plume) ในการเริ่มทำงานครั้งแรก; agy remote-control status จะแสดงชื่อปัจจุบัน คุณยังเปลี่ยนชื่อได้ในไฟล์การตั้งค่า: เปิด ~/.gemini/config/config.json บน Linux/macOS หรือ %USERPROFILE%\.gemini\config\config.json บน Windows เปลี่ยนค่าของ cliRemoteControlHostname บันทึกไฟล์ แล้วรัน agy remote-control start อีกครั้งเพื่อเริ่มเดมอนใหม่ ชื่อใหม่จะปรากฏบนแดชบอร์ดหลังจากเริ่มบริการใหม่; การเปลี่ยนแปลงไฟล์จะไม่มีผลขณะที่เดมอนกำลังทำงาน

ในไฟล์มีฟิลด์สองรายการที่คล้ายกัน cliRemoteControlHostname คือชื่อเดมอน CLI ที่กล่าวถึงในที่นี้ ส่วน remoteControlHostname เป็นฟิลด์แยกต่างหากสำหรับตัวแก้ไขเดสก์ท็อป Antigravity บนเครื่องเดียวกัน; ใน Antigravity 2.0 คุณเปลี่ยนได้ที่ Settings → App

เดมอนทำงานอย่างไรหลังออกจากระบบและรีบูต

การทำงานขึ้นอยู่กับระบบปฏิบัติการ:

การทำงานLinuxmacOSWindows
การเริ่มทำงานตอนบูต; ไม่ต้องเข้าสู่ระบบเมื่อเข้าสู่ระบบตอนบูต (หากผู้ดูแลระบบติดตั้งไว้); มิฉะนั้นเมื่อเข้าสู่ระบบ
ทำงานต่อหลังออกจากระบบใช่ไม่; กลับมาทำงานเมื่อเข้าสู่ระบบครั้งถัดไปใช่ หากกำหนดให้เริ่มตอนบูต
กู้คืนอัตโนมัติหลังเกิดข้อผิดพลาดใช่ใช่ใช่ โดยพยายามเริ่มใหม่ได้สูงสุดสามครั้ง จากนั้นจะเริ่มในการบูตครั้งถัดไปหรือเมื่อรัน agy remote-control start อีกครั้ง

รายละเอียดเฉพาะของ Windows

การลงทะเบียนเดมอนให้เริ่มอัตโนมัติ ตอนบูตระบบ ต้องดำเนินการในฐานะผู้ดูแลระบบ คุณใช้ได้ทั้ง PowerShell หรือพรอมต์คำสั่งปกติ คำสั่ง start ใช้ได้จากหน้าต่างปกติเช่นกัน แต่หลังออกจากระบบหรือรีบูต เดมอนจะกลับมาทำงานเมื่อเข้าสู่ระบบครั้งถัดไปเท่านั้น ไม่ใช่ตอนบูต คำสั่ง status และ stop ใช้จากหน้าต่างปกติได้โดยไม่ต้องใช้สิทธิ์ยกระดับ

ควรเลือกโหมดใด

เกณฑ์โหมดโต้ตอบ (/remote-control / agy --remote-control)เดมอนแบบ headless (agy remote-control start)
ขอบเขตเซสชันเทอร์มินัลแบบโต้ตอบหนึ่งเซสชันทั้งเครื่อง (บริการระบบปฏิบัติการเบื้องหลัง)
วงจรการทำงานทำงานขณะที่เปิด Remote Control และเซสชันเทอร์มินัลยังทำงานอยู่ทำงานต่อหลังออกจากระบบและรีบูตบน Linux และ Windows เมื่อติดตั้งโดยผู้ดูแลระบบ; บน macOS และการติดตั้ง Windows แบบมาตรฐาน จะกลับมาทำงานเมื่อเข้าสู่ระบบครั้งถัดไป
ชื่อรายการสร้างใหม่ในแต่ละเซสชัน (เช่น host-swift-falcon)ชื่อเครื่องถาวรหนึ่งชื่อ (--name หรือ cliRemoteControlHostname)
การทำงานพร้อมกันหลายเซสชันเทอร์มินัลพร้อมกันบนเครื่องเดียวบริการเดมอนหนึ่งชุดต่อเครื่อง
ลิงก์โดยตรงCLI แสดงลิงก์ไปยังบทสนทนาที่กำลังใช้งานเข้าถึงผ่านตัวสลับอุปกรณ์ที่ antigravity.google.com
เหมาะสำหรับเดินออกจากงานที่กำลังทำในเทอร์มินัล แล้วทำต่อจากโทรศัพท์หรือเบราว์เซอร์เข้าถึงเวิร์กสเตชันหรือเซิร์ฟเวอร์จากระยะไกลได้ต่อเนื่องขณะที่เครื่องเปิดอยู่และเชื่อมต่ออินเทอร์เน็ต โดยขึ้นอยู่กับเงื่อนไขของระบบปฏิบัติการ

โหมดโต้ตอบเพียงพอสำหรับจัดการงานปัจจุบันจากโทรศัพท์ หากต้องการเข้าถึงจากระยะไกลโดยไม่ต้องเปิดเทอร์มินัล ให้ใช้เดมอนแบบ headless โดยขึ้นอยู่กับเงื่อนไขของระบบปฏิบัติการ

แผนภาพ: อุโมงค์เซสชันจะหายไปเมื่อปิดเทอร์มินัล ส่วนเดมอนเบื้องหลังทำงานได้โดยไม่ต้องเปิดเทอร์มินัล
ความแตกต่างระหว่างโหมด CLI: อุโมงค์แบบโต้ตอบทำงานเฉพาะขณะที่เปิดเทอร์มินัล ส่วนเดมอนแบบ headless ทำงานได้โดยไม่ต้องเปิดเทอร์มินัล (ขึ้นอยู่กับเงื่อนไขของระบบปฏิบัติการในตารางด้านบน)

วิธีแก้ปัญหาการเชื่อมต่อ

ปัญหาและวิธีแก้จากเอกสารประกอบอย่างเป็นทางการ:

สิ่งที่พบสาเหตุวิธีแก้
Remote control is not enabled for your accountบัญชีหรือนโยบายองค์กรของคุณยังไม่ได้เปิดใช้ฟีเจอร์ Remote Controlติดต่อผู้ดูแลระบบพื้นที่ทำงาน หรือตรวจสอบว่าแพ็กเกจของคุณรองรับ Remote Control หรือไม่
รายการหายไปจากแดชบอร์ด (CLI)/remote-control และ agy --remote-control สร้างอุโมงค์ที่ตัดการเชื่อมต่อโดยอัตโนมัติเมื่อออกจากเซสชันแบบโต้ตอบ (/exit, Ctrl+C) หรือรัน /remote-control offหากต้องการให้เครื่องยังพร้อมใช้งานโดยไม่ต้องเปิดเทอร์มินัล ให้ติดตั้งเดมอนแบบ headless ด้วย 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 ตรวจสอบไฟล์ cli-*.log ล่าสุดใน %USERPROFILE%\.gemini\antigravity-cli\log

เดมอนแบบ headless ช่วยให้เข้าถึงได้โดยไม่ต้องเปิดเทอร์มินัล รวมถึงขณะคุณอยู่ห่างจากเครื่อง โดยขึ้นอยู่กับสภาพการทำงานของคอมพิวเตอร์และระบบปฏิบัติการ หากไม่ต้องการการเข้าถึงแบบต่อเนื่องอีกต่อไป ให้หยุดเดมอนด้วย agy remote-control stop

มีบทความแยกเกี่ยวกับ การควบคุมระยะไกลใน Claude Code หากต้องการควบคุมเอเจนต์อีกตัวผ่าน Telegram ดู วิธีตั้งค่า Hermes Agent ใน Telegram

ขั้นตอนถัดไป

หากคุณทำงานใน CLI และต้องการออกห่างจากงานปัจจุบัน ให้เริ่มด้วยโหมดโต้ตอบและเปิดเทอร์มินัลทิ้งไว้: หากปิดเทอร์มินัล อุโมงค์จะตัดการเชื่อมต่อและรายการเซสชันจะหายไปจากแดชบอร์ด หากต้องการเข้าถึงเครื่องโดยไม่ต้องเปิดเทอร์มินัล ให้ใช้เดมอนโดยคำนึงถึงข้อจำกัดของระบบปฏิบัติการ

ดูเนื้อหาเพิ่มเติมได้ที่ Ailoot

รายละเอียดเพิ่มเติม

คำถามที่พบบ่อย

ทำไมปิดเทอร์มินัลแล้วเซสชันระยะไกลหาย?

Remote Control แบบโต้ตอบผูกกับกระบวนการ agy ที่รันอยู่ เมื่อออกก็ปิด tunnel หากต้องเข้าถึงโดยไม่เปิดเทอร์มินัลให้ใช้ headless daemon และตรวจเงื่อนไขเริ่มอัตโนมัติของ OS

เครื่องไม่ขึ้นใน dashboard ควรตรวจอะไร?

ตรวจว่าเครื่องตื่นและออนไลน์ เปิด Remote Control และเบราว์เซอร์ใช้บัญชี Google เดียวกับเดสก์ท็อปหรือ CLI หากใช้ daemon ให้ดู agy remote-control status เรื่องเข้าสู่ระบบหรือบริการ

บทความทั้งหมด