openclaw qr

یک QR جفت‌سازی موبایل و کد راه‌اندازی را از پیکربندی فعلی Gateway شما تولید می‌کند.

نحوه استفاده

openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw qr --url wss://gateway.example/ws

گزینه‌ها

• --remote: gateway.remote.url را ترجیح می‌دهد؛ اگر تنظیم نشده باشد، gateway.tailscale.mode=serve|funnel همچنان می‌تواند URL عمومی راه دور را فراهم کند
• --url <url>: URL درگاه استفاده‌شده در بار داده را بازنویسی می‌کند
• --public-url <url>: URL عمومی استفاده‌شده در بار داده را بازنویسی می‌کند
• --token <token>: مشخص می‌کند جریان راه‌اندازی اولیه با کدام توکن Gateway احراز هویت کند
• --password <password>: مشخص می‌کند جریان راه‌اندازی اولیه با کدام گذرواژه Gateway احراز هویت کند
• --setup-code-only: فقط کد راه‌اندازی را چاپ می‌کند
• --no-ascii: رندر QR به‌صورت ASCII را رد می‌کند
• --json: JSON منتشر می‌کند (setupCode, gatewayUrl, auth, urlSource)

نکات

• --token و --password ناسازگارند و نمی‌توانند هم‌زمان استفاده شوند.
• خود کد راه‌اندازی اکنون یک bootstrapToken مات و کوتاه‌عمر را حمل می‌کند، نه توکن/گذرواژه مشترک Gateway را.
• bootstrap داخلی کد راه‌اندازی یک توکن اصلی node با scopes: [] به‌همراه یک توکن تحویل محدود operator برای راه‌اندازی موبایل مورد اعتماد برمی‌گرداند.
• توکن operator تحویل‌داده‌شده به operator.approvals، operator.read، operator.talk.secrets و operator.write محدود است؛ دامنه‌های تغییر جفت‌سازی و operator.admin همچنان به یک جفت‌سازی operator جداگانه و تأییدشده یا جریان توکن نیاز دارند.
• جفت‌سازی موبایل برای URLهای Gateway از نوع Tailscale/عمومی ws:// به‌صورت بسته شکست می‌خورد. نشانی‌های LAN خصوصی و میزبان‌های Bonjour با پسوند .local همچنان روی ws:// پشتیبانی می‌شوند، اما مسیرهای موبایل Tailscale/عمومی باید از Tailscale Serve/Funnel یا یک URL Gateway از نوع wss:// استفاده کنند.
• با --remote، OpenClaw به gateway.remote.url یا gateway.tailscale.mode=serve|funnel نیاز دارد.
• با --remote، اگر اعتبارنامه‌های راه دورِ عملاً فعال به‌صورت SecretRefs پیکربندی شده باشند و شما --token یا --password را ارسال نکنید، فرمان آن‌ها را از اسنپ‌شات فعال Gateway resolve می‌کند. اگر Gateway در دسترس نباشد، فرمان سریعاً شکست می‌خورد.
• بدون --remote، وقتی هیچ بازنویسی احراز هویت CLI ارسال نشده باشد، SecretRefs احراز هویت Gateway محلی resolve می‌شوند:
  • gateway.auth.token زمانی resolve می‌شود که احراز هویت توکنی بتواند برنده شود (gateway.auth.mode="token" صریح یا حالت استنباط‌شده‌ای که در آن هیچ منبع گذرواژه‌ای برنده نمی‌شود).
  • gateway.auth.password زمانی resolve می‌شود که احراز هویت گذرواژه‌ای بتواند برنده شود (gateway.auth.mode="password" صریح یا حالت استنباط‌شده بدون توکن برنده از احراز هویت/محیط).
• اگر هم gateway.auth.token و هم gateway.auth.password پیکربندی شده باشند (از جمله SecretRefs) و gateway.auth.mode تنظیم نشده باشد، resolve کردن کد راه‌اندازی تا زمانی که mode صراحتاً تنظیم شود شکست می‌خورد.
• نکته ناهمخوانی نسخه Gateway: این مسیر فرمان به Gatewayای نیاز دارد که از secrets.resolve پشتیبانی کند؛ Gatewayهای قدیمی‌تر خطای روش ناشناخته برمی‌گردانند.
• برنامه‌های رسمی iOS و Android مربوط به OpenClaw زمانی که فراداده کد راه‌اندازی‌شان مطابقت داشته باشد، به‌صورت خودکار متصل می‌شوند. اگر درخواستی معلق بماند (برای مثال، برای یک کلاینت غیررسمی یا فراداده نامنطبق)، آن را با موارد زیر بررسی و تأیید کنید:
  • openclaw devices list
  • openclaw devices approve <requestId>

مرتبط

• مرجع CLI
• جفت‌سازی