English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Platforms overview

Windows

OpenClaw یک برنامه همراه بومی Windows Hub به‌همراه پشتیبانی CLI ویندوز ارائه می‌کند. وقتی یک برنامه دسکتاپ با راه‌اندازی، وضعیت tray، چت، عیب‌یابی Command Center و قابلیت‌های Node ویندوز می‌خواهید، از Windows Hub استفاده کنید. وقتی CLI/Gateway را مستقیم می‌خواهید، از نصب‌کننده PowerShell استفاده کنید. وقتی سازگارترین runtime Gateway با لینوکس را می‌خواهید، از WSL2 استفاده کنید.

پیشنهادی: Windows Hub

Windows Hub برنامه همراه بومی WinUI برای Windows 10 20H2+ و Windows 11 است. بدون دسترسی administrator نصب می‌شود و با نصب‌کننده‌های امضاشده x64 و ARM64 در نسخه‌های منتشرشده OpenClaw ارائه می‌شود.

آخرین نصب‌کننده پایدار را از صفحه انتشارهای OpenClaw دانلود کنید:

اگر یکی از پیوندهای دانلود بالا خطای 404 داد، به صفحه انتشارها بروید و در آخرین انتشار به‌دنبال دارایی‌های OpenClawCompanion-Setup-* بگردید.

پس از نصب، OpenClaw Companion را از منوی Start یا system tray اجرا کنید. نصب‌کننده همچنین میان‌برهایی برای Gateway Setup، Chat، Settings، Check for Updates و حذف نصب اضافه می‌کند.

Windows Hub شامل چه چیزهایی است

  • وضعیت system tray و اجرا هنگام ورود
  • راه‌اندازی اولین اجرا برای یک WSL Gateway محلی متعلق به برنامه
  • تنظیمات اتصال برای Gatewayهای محلی، راه دور و تونل‌شده با SSH
  • پنجره چت بومی به‌همراه دسترسی به Control UI مرورگر
  • عیب‌یابی Command Center برای نشست‌ها، مصرف، کانال‌ها، Nodeها، pairing و دستورهای تعمیر
  • حالت Node ویندوز برای canvas، صفحه‌نمایش، دوربین، اعلان‌ها، وضعیت دستگاه، متن‌به‌گفتار، گفتاربه‌متن و system.run کنترل‌شده توسط agent
  • حالت سرور MCP محلی برای مشتریان MCP مانند Claude Desktop، Claude Code و Cursor

اولین اجرا

در اولین اجرا، وقتی Gateway ذخیره‌شده قابل‌استفاده‌ای وجود نداشته باشد، Windows Hub راه‌اندازی را باز می‌کند. سریع‌ترین مسیر Set up locally است، که یک توزیع WSL متعلق به برنامه با نام OpenClawGateway فراهم می‌کند، Gateway را داخل آن نصب می‌کند، و برنامه را pair می‌کند. این کار توزیع Ubuntu موجود شما را export یا تغییر نمی‌دهد.

وقتی از قبل Gateway دارید، Advanced setup را انتخاب کنید یا زبانه Connections را باز کنید. می‌توانید به این موارد متصل شوید:

  • یک Gateway محلی روی همین PC
  • یک WSL Gateway روی همین PC
  • یک Gateway راه دور با URL و token یا setup code
  • یک Gateway که از طریق تونل SSH در دسترس است

وقتی راه‌اندازی تمام شد، نماد tray سبز می‌شود. Command Center را از tray باز کنید تا اتصال، pairing، وضعیت Node و سلامت کانال را تأیید کنید.

حالت Node ویندوز

Windows Hub می‌تواند به‌عنوان یک Node درجه‌یک OpenClaw ثبت شود. سپس agent می‌تواند از قابلیت‌های بومی ویندوز که از طریق Gateway اعلام شده‌اند استفاده کند.

دستورهای رایج شامل این موارد هستند:

  • canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot
  • screen.snapshot و، با opt-in صریح، screen.record
  • camera.list و، با opt-in صریح، camera.snap, camera.clip
  • system.notify, system.run, system.run.prepare, system.which
  • location.get, device.info, device.status
  • stt.transcribe, tts.speak

حالت Node به pairing با Gateway نیاز دارد. اگر برنامه درخواست pairing نشان داد، آن را از میزبان Gateway تأیید کنید:

powershell
openclaw devices listopenclaw devices approve <request-id>openclaw nodes status

Gateway فقط دستورهایی را عبور می‌دهد که Node اعلام کرده و سیاست سرور اجازه داده است. دستورهای حساس به حریم خصوصی مانند screen.record، camera.snap و camera.clip به opt-in صریح gateway.nodes.allowCommands نیاز دارند.

حالت MCP محلی

Windows Hub می‌تواند همان رجیستری قابلیت بومی ویندوز را به‌صورت یک سرور MCP محلی روی loopback ارائه کند. این زمانی مفید است که بخواهید مشتریان MCP محلی قابلیت‌های ویندوز را بدون یک OpenClaw Gateway در حال اجرا کنترل کنند.

آن را در Settings ویندوز هاب، زیر بخش developer/advanced فعال کنید. پس از فعال‌شدن سرور، برنامه endpoint loopback و bearer token را نشان می‌دهد.

ماتریس حالت‌ها:

حالت Node سرور MCP رفتار
خاموش خاموش برنامه دسکتاپ فقط برای operator
روشن خاموش Node ویندوز متصل به Gateway
خاموش روشن فقط سرور MCP محلی
روشن روشن Node Gateway به‌همراه سرور MCP محلی

CLI و Gateway بومی ویندوز

برای استفاده terminal-first، OpenClaw را از PowerShell نصب کنید:

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex

بررسی کنید:

powershell
openclaw --versionopenclaw doctoropenclaw gateway status --json

جریان‌های CLI و Gateway بومی ویندوز پشتیبانی می‌شوند و همچنان در حال بهبود هستند. راه‌اندازی مدیریت‌شده، وقتی در دسترس باشد، از Windows Scheduled Tasks استفاده می‌کند. task اسکریپت خوانای gateway.cmd را در دایرکتوری state مربوط به OpenClaw نگه می‌دارد، اما آن را از طریق یک wrapper تولیدشده gateway.vbs برای WScript اجرا می‌کند تا Gateway پس‌زمینه یک پنجره console قابل‌مشاهده باز نکند. اگر ساخت task رد شود، OpenClaw به یک آیتم ورود پوشه Startup برای هر کاربر fallback می‌کند.

برای نصب سرویس Gateway:

powershell
openclaw gateway installopenclaw gateway status --json

اگر فقط استفاده CLI بدون سرویس Gateway مدیریت‌شده می‌خواهید:

powershell
openclaw onboard --non-interactive --skip-healthopenclaw gateway run

WSL2 Gateway

WSL2 همچنان سازگارترین runtime Gateway با لینوکس روی ویندوز است. Windows Hub می‌تواند یک WSL Gateway متعلق به برنامه را برای شما راه‌اندازی کند، یا می‌توانید به‌صورت دستی داخل توزیع خودتان نصب کنید.

راه‌اندازی دستی:

powershell
wsl --install# Or pick a distro explicitly:wsl --list --onlinewsl --install -d Ubuntu-24.04

systemd را داخل WSL فعال کنید:

bash
sudo tee /etc/wsl.conf >/dev/null <<'EOF'[boot]systemd=trueEOF

WSL را از PowerShell دوباره راه‌اندازی کنید:

powershell
wsl --shutdown

سپس OpenClaw را داخل WSL با quickstart لینوکس نصب کنید:

bash
curl -fsSL https://openclaw.ai/install.sh | bashopenclaw gateway status

شروع خودکار Gateway پیش از ورود به ویندوز

برای راه‌اندازی‌های WSL بدون نمایشگر، مطمئن شوید زنجیره کامل boot حتی وقتی کسی وارد ویندوز نشده اجرا می‌شود.

داخل WSL:

bash
sudo apt-get install -y dbus-x11sudo loginctl enable-linger "$(whoami)"openclaw gateway install

در PowerShell به‌عنوان Administrator:

powershell
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

Ubuntu را با نام توزیع خود از این دستور جایگزین کنید:

powershell
wsl --list --verbose

نکته: دو تغییر نسبت به دستورالعمل‌های قدیمی‌تر:

  • dbus-launch true به‌جای /bin/true — در WSL ≥ 2.6.1.0 یک regression (microsoft/WSL #13416) باعث می‌شود توزیع 15 تا 20 ثانیه پس از خروج آخرین client، حتی با فعال بودن linger، به‌علت بیکاری terminate شود. dbus-launch true به‌عنوان workaround یک فرایند child-of-init را زنده نگه می‌دارد (بحث جامعه، microsoft/WSL #9245).
  • /ru "$env:USERNAME" به‌جای /ru SYSTEM — توزیع‌های WSL هر کاربر (راه‌اندازی پیش‌فرض) برای حساب SYSTEM قابل‌مشاهده نیستند؛ task ظاهراً اجرا می‌شود اما توزیع هرگز شروع نمی‌شود. اجرا با حساب خودتان از این مشکل جلوگیری می‌کند. هنگام ساخت task، ویندوز گذرواژه شما را درخواست می‌کند.

پس از reboot، از WSL بررسی کنید:

bash
systemctl --user is-enabled openclaw-gateway.servicesystemctl --user status openclaw-gateway.service --no-pager

در دسترس قراردادن سرویس‌های WSL روی LAN

WSL شبکه مجازی خودش را دارد. اگر دستگاه دیگری باید به سرویسی داخل WSL دسترسی داشته باشد، یک پورت ویندوز را به IP فعلی WSL forward کنید. IP مربوط به WSL ممکن است پس از راه‌اندازی‌های مجدد تغییر کند، بنابراین در صورت نیاز rule مربوط به forwarding را refresh کنید.

نمونه در PowerShell به‌عنوان Administrator:

powershell
$Distro = "Ubuntu-24.04"$ListenPort = 2222$TargetPort = 22 $WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]if (-not $WslIp) { throw "WSL IP not found." } netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `  connectaddress=$WslIp connectport=$TargetPort New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `  -Protocol TCP -LocalPort $ListenPort -Action Allow

نکته‌ها:

  • SSH از دستگاه دیگر، IP میزبان ویندوز را هدف می‌گیرد، برای مثال ssh user@windows-host -p 2222.
  • Nodeهای راه دور باید به URL قابل‌دسترسی Gateway اشاره کنند، نه 127.0.0.1.
  • برای دسترسی LAN از listenaddress=0.0.0.0 استفاده کنید. برای دسترسی فقط محلی از 127.0.0.1 استفاده کنید.

عیب‌یابی

نماد tray ظاهر نمی‌شود

Task Manager را برای OpenClaw.Tray.WinUI.exe بررسی کنید. اگر در حال اجراست، ناحیه نمادهای پنهان tray را باز کنید و آن را pin کنید. اگر در حال اجرا نیست، OpenClaw Companion را از منوی Start اجرا کنید.

راه‌اندازی محلی ناموفق است

لاگ راه‌اندازی را از Windows Hub باز کنید یا این مسیر را بررسی کنید:

powershell
notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"

علت‌های رایج عبارت‌اند از WSL غیرفعال، virtualization مسدودشده، state کهنه WSL متعلق به برنامه، یا خطای شبکه هنگام نصب بسته Gateway.

برنامه می‌گوید pairing لازم است

درخواست operator یا Node را از Gateway تأیید کنید:

powershell
openclaw devices listopenclaw devices approve <request-id>

اگر دستگاه از قبل token داشت، پس از تأیید از زبانه Connections دوباره متصل شوید.

چت وب نمی‌تواند به Gateway راه دور دسترسی پیدا کند

چت وب راه دور به HTTPS یا localhost نیاز دارد. برای گواهی‌های self-signed، گواهی را در ویندوز trust کنید، یا از یک تونل SSH به URL localhost استفاده کنید.

دستورهای screen.snapshot، دوربین، یا صدا ناموفق هستند

مجوزهای ویندوز برای دوربین، میکروفون، screen capture و اعلان‌ها را تأیید کنید. نصب‌های packaged قابلیت‌های محافظت‌شده را declare می‌کنند، اما ویندوز ممکن است در اولین استفاده یک دستور از آن‌ها همچنان prompt نشان دهد.

اتصال Git یا GitHub ناموفق است

برخی شبکه‌ها HTTPS به GitHub را مسدود یا throttle می‌کنند. اگر git clone یا gh auth login ناموفق بود، یک شبکه دیگر، VPN، یا proxy HTTP/HTTPS را امتحان کنید.

برای auth مبتنی بر token در gh در نشست فعلی:

powershell
$env:GH_TOKEN="<your-token>"gh auth statusgh auth setup-git

هرگز tokenها را commit نکنید یا آن‌ها را در issueها یا pull requestها paste نکنید.

مرتبط

Was this useful?
On this page

On this page