# openclaw proxy

مسیریابی پراکسی مدیریت‌شده توسط اپراتور را اعتبارسنجی کنید، یا پراکسی اشکال‌زدایی صریح محلی را اجرا کنید و ترافیک ضبط‌شده را بررسی کنید.

از validate برای پیش‌بررسی یک پراکسی فوروارد مدیریت‌شده توسط اپراتور پیش از فعال‌سازی مسیریابی پراکسی OpenClaw استفاده کنید. دستورهای دیگر ابزارهای اشکال‌زدایی برای بررسی در سطح انتقال هستند: می‌توانند یک پراکسی محلی را راه‌اندازی کنند، یک دستور فرزند را با ضبط فعال اجرا کنند، نشست‌های ضبط را فهرست کنند، الگوهای رایج ترافیک را پرس‌وجو کنند، blobهای ضبط‌شده را بخوانند، و داده‌های ضبط محلی را پاک‌سازی کنند.

# دستورات

openclaw proxy start [--host <host>] [--port <port>]
openclaw proxy run [--host <host>] [--port <port>] -- <cmd...>
openclaw proxy validate [--json] [--proxy-url <url>] [--allowed-url <url>] [--denied-url <url>] [--apns-reachable] [--apns-authority <url>] [--timeout-ms <ms>]
openclaw proxy coverage
openclaw proxy sessions [--limit <count>]
openclaw proxy query --preset <name> [--session <id>]
openclaw proxy blob --id <blobId>
openclaw proxy purge

# اعتبارسنجی

openclaw proxy validate نشانی مؤثر پراکسی مدیریت‌شده توسط اپراتور را از --proxy-url، پیکربندی، یا OPENCLAW_PROXY_URL بررسی می‌کند. وقتی هیچ پراکسی‌ای فعال و پیکربندی نشده باشد، یک مشکل پیکربندی گزارش می‌کند؛ برای یک پیش‌بررسی موردی پیش از تغییر پیکربندی، از --proxy-url استفاده کنید. به‌طور پیش‌فرض تأیید می‌کند که یک مقصد عمومی از طریق پراکسی موفق می‌شود و پراکسی نمی‌تواند به یک نشانگر بازگشتی موقت برسد. مقصدهای منع‌شده سفارشی fail-closed هستند: پاسخ‌های HTTP و خطاهای مبهم انتقال هر دو شکست محسوب می‌شوند، مگر اینکه بتوانید یک نشانه منع مخصوص استقرار را جداگانه تأیید کنید. --apns-reachable را اضافه کنید تا همچنین یک تونل HTTP/2 CONNECT برای APNs را از طریق پراکسی باز کند و تأیید کند APNs محیط سندباکس پاسخ می‌دهد؛ این کاوش از یک توکن ارائه‌دهنده عمداً نامعتبر استفاده می‌کند، بنابراین پاسخ APNs با 403 InvalidProviderToken نشانه موفق دسترس‌پذیری است.

گزینه‌ها:

• --json: JSON قابل‌خواندن برای ماشین چاپ می‌کند.
• --proxy-url <url>: این نشانی پراکسی را به‌جای پیکربندی یا محیط اعتبارسنجی می‌کند.
• --allowed-url <url>: مقصدی را اضافه می‌کند که انتظار می‌رود از طریق پراکسی موفق شود. برای بررسی چند مقصد تکرار کنید.
• --denied-url <url>: مقصدی را اضافه می‌کند که انتظار می‌رود توسط پراکسی مسدود شود. برای بررسی چند مقصد تکرار کنید.
• --apns-reachable: همچنین تأیید می‌کند HTTP/2 مربوط به APNs محیط سندباکس از طریق پراکسی در دسترس است.
• --apns-authority <url>: مرجع APNs برای کاوش با --apns-reachable (https://api.sandbox.push.apple.com به‌طور پیش‌فرض؛ محیط تولید https://api.push.apple.com است).
• --timeout-ms <ms>: مهلت زمانی هر درخواست بر حسب میلی‌ثانیه.

برای راهنمایی استقرار و معناشناسی منع، پراکسی شبکه را ببینید.

# پیش‌تنظیم‌های پرس‌وجو

openclaw proxy query --preset <name> این موارد را می‌پذیرد:

• double-sends
• retry-storms
• cache-busting
• ws-duplicate-frames
• missing-ack
• error-bursts

# نکات

• start به‌طور پیش‌فرض از 127.0.0.1 استفاده می‌کند، مگر اینکه --host تنظیم شده باشد.
• run یک پراکسی اشکال‌زدایی محلی را راه‌اندازی می‌کند و سپس دستور پس از -- را اجرا می‌کند.
• فوروارد مستقیم بالادستی در پراکسی اشکال‌زدایی، سوکت‌های بالادستی را برای عیب‌یابی باز می‌کند. وقتی حالت پراکسی مدیریت‌شده OpenClaw فعال است، فوروارد مستقیم برای درخواست‌های پراکسی و تونل‌های CONNECT به‌طور پیش‌فرض غیرفعال است؛ OPENCLAW_DEBUG_PROXY_ALLOW_DIRECT_CONNECT_WITH_MANAGED_PROXY=1 را فقط برای عیب‌یابی محلی تأییدشده تنظیم کنید.
• validate وقتی پیکربندی پراکسی یا بررسی‌های مقصد شکست بخورند، با کد 1 خارج می‌شود.
• ضبط‌ها داده‌های اشکال‌زدایی محلی هستند؛ پس از پایان کار از openclaw proxy purge استفاده کنید.

# مرتبط

• مرجع CLI
• پراکسی شبکه
• احراز هویت پراکسی مورد اعتماد