# Google Antigravity Remote Control: كيفية التحكم في الوكيل من هاتفك

> كيفية تفعيل Remote Control في Google Antigravity على سطح المكتب وفي CLI: المفتاح، وبرنامج agy remote-control الخفي، وما يجب فعله عند مواجهة مشكلات في الاتصال.

Source: https://ailoot.ai/blog/ar/antigravity-remote-control-phone/
Canonical: https://ailoot.ai/blog/ar/antigravity-remote-control-phone/
Language: ar
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-009
Revision: sha256-26b24ed9c01e8a4bb936ddc252d708e23e8574b8693ae740087b8a6af4623dd9


<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Ailoot documentation">

[وثائق Ailoot](https://ailoot.ai/docs/) — مواد مرجعية حول استخدام الخدمة.

</div>

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

أبرز النقاط

في 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، فيُستأنف تشغيله عند تسجيل الدخول التالي. يجب أن يكون الكمبيوتر قيد التشغيل ومتصلًا بالإنترنت. قد لا تتوفر الميزة بسبب سياسة الحساب أو المؤسسة أو شروط الخطة.

</div>

إذا لم تثبّت Antigravity بعد، فابدأ بنظرة عامة على [ما هو Google Antigravity وكيفية تثبيته](https://ailoot.ai/blog/ar/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](https://antigravity.google.com). ويمكنك أيضًا تثبيت تطبيق الويب على الشاشة الرئيسية في الهاتف لتلقي إشعارات فورية عند انتهاء الوكيل من مهمة أو طلبه ردًا منك.
2. سجّل الدخول باستخدام حساب Google نفسه الذي تستخدمه على سطح المكتب.
3. اختر الجهاز المطلوب من مبدّل الأجهزة.
4. بعد الاتصال، يمكنك رؤية المحادثات النشطة، وبدء مهام جديدة للوكيل، وعرض خطط التنفيذ والمواد الناتجة.

إذا لم يظهر الجهاز في واجهة الويب، فتوصي التعليمات الرسمية بالتحقق من ثلاثة أمور: أن مفتاح **Enable Remote Control** مفعّل على الكمبيوتر الذي يعمل عليه Antigravity؛ وأن الكمبيوتر متصل بالإنترنت ولم يدخل في وضع السكون؛ وأن تطبيق سطح المكتب والمتصفح يستخدمان حساب Google نفسه.

إذا انقطع اتصال الشبكة مؤقتًا على الجهاز الذي تستخدمه للاتصال، فستحاول واجهة الويب إعادة الاتصال تلقائيًا. وتستمر مهام الوكيل في الخلفية والأوامر التي شُغّلت من الطرفية على الكمبيوتر الذي يعمل عليه Antigravity من دون انقطاع، ما دام متصلًا بالإنترنت.

<figure>
رسم توضيحي: ينقل مفتاح Remote Control التحكم من الكمبيوتر المحمول إلى الهاتف عند تسجيل الدخول بالحساب نفسه
<figcaption>طريقة عمل Remote Control على سطح المكتب: فعّل المفتاح على الكمبيوتر، ثم سجّل الدخول من الهاتف باستخدام حساب Google نفسه.</figcaption>
</figure>



## وضعا Remote Control في Antigravity CLI

يتضمن CLI وضعين: وضعًا تفاعليًا مرتبطًا بعملية طرفية محددة، وبرنامجًا خفيًا في الخلفية دون واجهة يعمل من دون طرفية مفتوحة.

### الوضع التفاعلي: `/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 تفاعلية معرّف جلسة واسم مضيف خاصان بها، لذا يمكنك تشغيل `agy --remote-control` في الوقت نفسه ضمن عدة علامات تبويب طرفية أو أدلة عمل.

عند الاتصال بجلسة CLI تفاعلية من متصفح، تتم مزامنة الجانبين في الوقت الفعلي. تنتقل الطلبات من الجهاز البعيد مباشرة إلى الطرفية المحلية، بينما يظهر استدلال الوكيل واستدعاءاته للأدوات وتغييرات الشيفرة في الواجهة البعيدة. إذا توقف الوكيل لطلب التأكيد (`y`/`n`) أو طرح سؤال متابعة، فيمكنك الرد من هاتفك أو الطرفية المحلية. الإعدادات هي الاستثناء: لا يمكنك تغييرها من واجهة الويب البعيدة، بل من CLI نفسه فقط.

### البرنامج الخفي دون واجهة: `agy remote-control start`

الوضع الثاني هو برنامج خفي دائم في الخلفية يُسجَّل كخدمة لنظام التشغيل. يتوفر ما دام الكمبيوتر قيد التشغيل ومتصلًا بالإنترنت؛ ويعتمد سلوكه بعد تسجيل الخروج وإعادة التشغيل على النظام الأساسي.

```
agy remote-control start
```

يسجّل البرنامج الخفي نفسه كخدمة لنظام التشغيل (خدمة systemd للمستخدم في Linux، أو LaunchAgent في macOS، أو مهمة مجدولة في Windows) ويبدأ فورًا من دون الحاجة إلى نافذة طرفية مفتوحة.

استخدم `agy remote-control status` لمعرفة اسم الإدخال. ثم اختر هذا الكمبيوتر من [لوحة تحكم Antigravity Remote Control](https://antigravity.google.com) وواصل العمل عبر واجهة Antigravity على الويب.

تتحكم ثلاثة أوامر في البرنامج الخفي:

```
agy remote-control start     تسجيل البرنامج الخفي وبدؤه
agy remote-control status    عرض حالة البرنامج الخفي واسم مثيله
agy remote-control stop      إيقاف البرنامج الخفي وإلغاء تسجيله
```

يستخدم البرنامج الخفي بيانات الاعتماد التي استخدمتها لتسجيل الدخول إلى CLI. تسجيل الدخول إلى CLI منفصل عن تسجيل الدخول إلى محرر Antigravity لسطح المكتب على الكمبيوتر نفسه؛ وفي المتصفح، استخدم حساب Google نفسه المستخدم في CLI.

يمكنك تعيين اسم جهاز البرنامج الخفي دون واجهة باستخدام الخيار `--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**.

### سلوك البرنامج الخفي بعد تسجيل الخروج وإعادة التشغيل

يعتمد السلوك على نظام التشغيل:

| السلوك | 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، افحص أحدث ملف `cli-*.log` في `%USERPROFILE%\.gemini\antigravity-cli\log`.

يوفر البرنامج الخفي دون واجهة إمكانية الوصول من دون طرفية مفتوحة، بما في ذلك أثناء ابتعادك، وفقًا لظروف تشغيل الكمبيوتر ونظام التشغيل. إذا لم تعد بحاجة إلى الوصول المستمر، فأوقف البرنامج الخفي باستخدام `agy remote-control stop`.

هناك مقال منفصل عن [التحكم عن بُعد في Claude Code](https://ailoot.ai/blog/ar/claude-code-remote-control-phone/). للتحكم في وكيل آخر عبر Telegram، راجع [إعداد Hermes Agent في Telegram](https://ailoot.ai/blog/ar/hermes-agent-telegram-setup/).

## ما الخطوة التالية؟

إذا كنت تعمل في CLI وتريد الابتعاد عن المهمة الحالية، فابدأ بالوضع التفاعلي. اترك الطرفية مفتوحة: إذا أغلقتها، ينقطع النفق ويختفي إدخال الجلسة من لوحة التحكم. للوصول إلى الجهاز من دون طرفية مفتوحة، استخدم البرنامج الخفي وفقًا لقيود نظام التشغيل لديك.

<div class="section" role="doc-bibliography" aria-label="Sources">

### المصادر

- [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/).

## أسئلة شائعة

### لماذا تختفي الجلسة البعيدة عند إغلاق الطرفية؟

يتبع Remote Control التفاعلي عملية agy الجارية، ولذلك يغلق الخروج منها النفق. للوصول دون طرفية مفتوحة، استخدم الخدمة الخلفية دون واجهة وافحص شروط بدئها في نظام التشغيل.

### ماذا أفحص إذا غاب جهازي عن لوحة التحكم؟

تحقق من أن الجهاز مستيقظ ومتصل، ومن تفعيل Remote Control، ومن استخدام المتصفح حساب Google نفسه المستخدم في تطبيق سطح المكتب أو CLI. ولجلسة الخدمة الخلفية، افحص agy remote-control status لمشكلات الدخول أو الخدمة.


## Ailoot · الشركة ومحفظة مشاريعها

تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.