ریموٹ Gateway کے ساتھ OpenClaw.app چلانا¶

22. OpenClaw.app ریموٹ گیٹ وے سے کنیکٹ ہونے کے لیے SSH ٹنلنگ استعمال کرتا ہے۔ 23. یہ گائیڈ آپ کو اسے سیٹ اپ کرنے کا طریقہ دکھاتی ہے۔

جائزہ¶

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#ffffff',
    'primaryTextColor': '#000000',
    'primaryBorderColor': '#000000',
    'lineColor': '#000000',
    'secondaryColor': '#f9f9fb',
    'tertiaryColor': '#ffffff',
    'clusterBkg': '#f9f9fb',
    'clusterBorder': '#000000',
    'nodeBorder': '#000000',
    'mainBkg': '#ffffff',
    'edgeLabelBackground': '#ffffff'
  }
}}%%
flowchart TB
    subgraph Client["Client Machine"]
        direction TB
        A["OpenClaw.app"]
        B["ws://127.0.0.1:18789\n(local port)"]
        T["SSH Tunnel"]

        A --> B
        B --> T
    end
    subgraph Remote["Remote Machine"]
        direction TB
        C["Gateway WebSocket"]
        D["ws://127.0.0.1:18789"]

        C --> D
    end
    T --> C

فوری سیٹ اپ¶

مرحلہ 1: SSH کنفیگ شامل کریں¶

~/.ssh/config میں ترمیم کریں اور شامل کریں:

Host remote-gateway
    HostName <REMOTE_IP>          # e.g., 172.27.187.184
    User <REMOTE_USER>            # e.g., jefferson
    LocalForward 18789 127.0.0.1:18789
    IdentityFile ~/.ssh/id_rsa

<REMOTE_IP> اور <REMOTE_USER> کو اپنی قدروں سے بدل دیں۔

مرحلہ 2: SSH کلید کاپی کریں¶

اپنی پبلک کلید ریموٹ مشین پر کاپی کریں (ایک بار پاس ورڈ درج کریں):

ssh-copy-id -i ~/.ssh/id_rsa <REMOTE_USER>@<REMOTE_IP>

مرحلہ 3: Gateway ٹوکن سیٹ کریں¶

launchctl setenv OPENCLAW_GATEWAY_TOKEN "<your-token>"

مرحلہ 4: SSH سرنگ شروع کریں¶

ssh -N remote-gateway &

مرحلہ 5: OpenClaw.app دوبارہ شروع کریں¶

# Quit OpenClaw.app (⌘Q), then reopen:
open /path/to/OpenClaw.app

اب ایپ SSH سرنگ کے ذریعے ریموٹ گیٹ وے سے جڑ جائے گی۔

لاگ اِن پر سرنگ کو خودکار طور پر شروع کریں¶

لاگ اِن کرتے ہی SSH سرنگ خود بخود شروع کرنے کے لیے ایک Launch Agent بنائیں۔

PLIST فائل بنائیں¶

اسے ~/Library/LaunchAgents/bot.molt.ssh-tunnel.plist کے طور پر محفوظ کریں:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>bot.molt.ssh-tunnel</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/bin/ssh</string>
        <string>-N</string>
        <string>remote-gateway</string>
    </array>
    <key>KeepAlive</key>
    <true/>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

Launch Agent لوڈ کریں¶

launchctl bootstrap gui/$UID ~/Library/LaunchAgents/bot.molt.ssh-tunnel.plist

اب سرنگ یہ کرے گی:

• لاگ اِن پر خود بخود شروع ہوگی
• اگر کریش ہو جائے تو دوبارہ شروع ہوگی
• پس منظر میں چلتی رہے گی

لیگیسی نوٹ: اگر موجود ہو تو کسی بھی باقی ماندہ com.openclaw.ssh-tunnel LaunchAgent کو ہٹا دیں۔

خرابیوں کا ازالہ¶

چیک کریں کہ سرنگ چل رہی ہے یا نہیں:

ps aux | grep "ssh -N remote-gateway" | grep -v grep
lsof -i :18789

سرنگ دوبارہ شروع کریں:

launchctl kickstart -k gui/$UID/bot.molt.ssh-tunnel

سرنگ بند کریں:

launchctl bootout gui/$UID/bot.molt.ssh-tunnel

یہ کیسے کام کرتا ہے¶

OpenClaw.app connects to ws://127.0.0.1:18789 on your client machine. 25. SSH ٹنل اس کنیکشن کو ریموٹ مشین پر پورٹ 18789 کی طرف فارورڈ کرتا ہے جہاں گیٹ وے چل رہا ہوتا ہے۔