OpenClaw چیست؟ آموزش نصب امن در ویندوز و راه‌اندازی Gateway محلی
OpenClaw یک دستیار هوش مصنوعی متن‌باز با Gateway محلی، Channelها و ابزارهای قابل توسعه است. در این راهنما آن را روی ویندوز نصب، وضعیت Gateway را بررسی و دسترسی‌ها را با رویکرد حداقل مجوز ایمن می‌کنیم.
OpenClaw یک دستیار هوش مصنوعی متن‌باز است که از طریق یک Gateway، مدل، ابزارها، رابط وب و Channelهای پیام‌رسان را به هم متصل می‌کند. این معماری انعطاف زیادی دارد، اما به همان اندازه نیازمند کنترل دسترسی است؛ چون Agent می‌تواند فایل بخواند، فرمان اجرا کند یا از طرف شما با سرویس‌های دیگر ارتباط بگیرد.
راه‌اندازی درست از انتخاب مدل شروع نمی‌شود؛ از تعیین مرز اعتماد آغاز می‌شود. برای اولین تجربه، Gateway را فقط روی سیستم محلی و Loopback نگه دارید، هیچ Port عمومی باز نکنید و تنها یک پوشه آزمایشی بدون داده حساس در اختیار Agent بگذارید.
OpenClaw چیست و معماری آن چگونه کار می‌کند؟
Gateway هسته ارتباطی OpenClaw است. رابط‌ها، Deviceها، Nodeها، Channelها و Sessionهای Agent از طریق آن هماهنگ می‌شوند. مدل زبانی تصمیم می‌گیرد چه کاری لازم است، اما Tool policy، Sandbox و Approval تعیین می‌کنند کدام اقدام واقعاً اجازه اجرا دارد.
این جداسازی مهم است: Prompt یا Skill فقط رفتار مطلوب را توصیف می‌کند و کنترل امنیتی قطعی نیست. اگر یک Tool اجازه حذف فایل یا دسترسی شبکه داشته باشد، دستور متنی به‌تنهایی مانع سوءاستفاده یا Prompt Injection نمی‌شود. مرز فنی باید در Policy و محیط اجرا نیز اعمال شود.
| جزء | وظیفه | کنترل امنیتی |
|---|---|---|
| Gateway | هماهنگی Session، Client و Channel | Bind محلی، Authentication و Rate limit |
| Agent | برنامه‌ریزی و انتخاب Tool | Scope روشن و Permission حداقلی |
| Node | ارائه قابلیت‌های یک Device | Pairing و Allowlist فرمان |
| Channel | دریافت و ارسال پیام | Allowlist فرستنده و Mention gate |
| Sandbox | جداسازی اجرای Tool | Workspace access و Network policy |
| Skill یا Plugin | افزودن Workflow و قابلیت | بازبینی منبع، Script و نسخه |
سه روش نصب OpenClaw در ویندوز
مستندات رسمی سه مسیر اصلی پیشنهاد می‌کنند: Windows Hub برای تجربه دسکتاپ، نصب PowerShell برای CLI و Gateway بومی، و WSL2 برای سازگاری بیشتر با محیط Linux. انتخاب مسیر به نوع کار و سطح مدیریت موردنیاز بستگی دارد.
Windows Hub؛ مسیر ساده برای دسکتاپ
Windows Hub یک برنامه همراه WinUI برای Windows 10 20H2 و Windows 11 است. نصب‌کننده امضاشده، Setup اولیه، Tray status، Chat و Command Center را فراهم می‌کند و می‌تواند یک Gateway مبتنی بر WSL را بدون تغییر دادن توزیع Ubuntu موجود شما ایجاد کند.
فایل نصب را فقط از صفحه Releases رسمی دریافت و معماری x64 یا ARM64 صحیح را انتخاب کنید. پس از نخستین اجرا، گزینه راه‌اندازی محلی برای آزمایش مناسب است. وقتی Tray سبز شد، در Command Center وضعیت Connection، Pairing، Node و Channel را بررسی کنید.
PowerShell؛ مسیر مستقیم CLI و Gateway
اگر محیط ترمینال را ترجیح می‌دهید، نصب‌کننده رسمی PowerShell می‌تواند Runtime لازم را بررسی و OpenClaw را نصب کند. در محیط سازمانی، اجرای مستقیم Script دانلودشده ممکن است خلاف Policy باشد؛ در این حالت ابتدا Script را دریافت، امضا و محتوا را بررسی و سپس طبق فرایند داخلی اجرا کنید.
iwr -useb https://openclaw.ai/install.ps1 | iexopenclaw --versionopenclaw doctoropenclaw gateway status --jsonopenclaw security auditموفق‌بودن نصب فقط با نمایش Banner اثبات نمی‌شود. نسخه، Doctor و وضعیت Gateway را جداگانه بررسی کنید. اگر Status سالم نیست، پیش از Onboarding یا اتصال Channel علت را از Log و خروجی JSON پیدا کنید.
WSL2؛ مسیر سازگارتر با ابزارهای Linux
برای Workflowهایی که به ابزار Linux، Systemd یا اسکریپت‌های Bash وابسته‌اند، WSL2 انتخاب طبیعی‌تری است. Windows Hub می‌تواند توزیع مدیریت‌شده خودش را بسازد یا می‌توانید نصب را داخل یک توزیع جدا انجام دهید. WSL مرز کامل امنیتی نیست؛ دسترسی Mountهای ویندوز و شبکه آن را بررسی کنید.
پیش‌نیازها و آماده‌سازی محیط آزمایشی
نسخه‌های پشتیبانی‌شده Node ممکن است با انتشارهای بعدی تغییر کنند، بنابراین عدد نسخه را از صفحه Install همان روز بررسی کنید. اگر از نصب‌کننده رسمی استفاده می‌کنید، Runtime مناسب را تشخیص یا فراهم می‌کند. ساخت از Source به ابزارهای بیشتری مانند Git و pnpm نیاز دارد و برای شروع ضروری نیست.
- یک حساب کاربری عادی و بدون دسترسی Administrator دائمی انتخاب کنید.
- یک پوشه آزمایشی جدا از Documents، Desktop و Sourceهای حساس بسازید.
- از فایل تنظیمات و State موجود Backup بگیرید.
- Firewall ویندوز و وضعیت Portهای Listening را پیش از نصب ثبت کنید.
- Secret واقعی، Wallet، SSH key و Browser profile را از Scope خارج کنید.
- نسخه نصب‌کننده و منبع Download را ثبت کنید.
Onboarding امن؛ Quick start یا Custom setup؟
Quick start برای محیط شخصی و کم‌ریسک مناسب است و تلاش می‌کند دسترسی مدل موجود را تشخیص دهد. Custom setup برای زمانی بهتر است که Provider، Workspace، Gateway یا Permission باید دقیق انتخاب شود. هیچ Credential را در Prompt یا فایل قابل Commit قرار ندهید.
در Onboarding ابتدا فقط یک Model route، یک Workspace آزمایشی و رابط محلی را فعال کنید. افزودن هم‌زمان Channel، Browser، Device command و Plugin تشخیص علت خطا و کنترل سطح دسترسی را دشوار می‌کند.
Gateway را عمومی نکنید
نصب عادی Gateway روی Host به‌طور پیش‌فرض به Loopback متصل می‌شود. همین حالت را برای شروع نگه دارید. Bind روی 0.0.0.0 یا Port forwarding ساده می‌تواند رابط مدیریتی را در شبکه یا اینترنت قابل دسترس کند. اگر Remote access نیاز دارید، از VPN خصوصی یا SSH tunnel همراه Authentication استفاده کنید.
تصویرهای Container ممکن است Default متفاوتی برای Bind داشته باشند؛ بنابراین تصور نکنید Docker به‌تنهایی سرویس را خصوصی می‌کند. Published port، Firewall میزبان و زنجیره DOCKER-USER را بررسی کنید. روی VPS عمومی، سطح حمله را از بیرون Host نیز Scan کنید.
| روش | ریسک | کاربرد پیشنهادی |
|---|---|---|
| Loopback | کمترین سطح شبکه | آزمایش و استفاده روی همان سیستم |
| SSH tunnel | وابسته به امنیت SSH | مدیریت محدود از یک Client مورداعتماد |
| VPN خصوصی | نیازمند Policy اعضا و Deviceها | دسترسی چند دستگاه مورداعتماد |
| LAN bind | قابل مشاهده برای شبکه محلی | فقط با Firewall و Authentication دقیق |
| Public internet | بالاترین سطح حمله | برای شروع توصیه نمی‌شود |
Security Audit و Doctor چه تفاوتی دارند؟
openclaw doctor سلامت نصب، Configuration، Service و Provider را بررسی می‌کند. openclaw security audit روی Driftهای امنیتی و تنظیمات پرخطر تمرکز دارد. هر دو را بعد از نصب، تغییر Gateway، افزودن Channel و Update اجرا کنید.
خروجی Audit را صرفاً پاک نکنید. ابتدا Severity، مسیر Configuration و اثر اصلاح را بخوانید. گزینه Fix خودکار می‌تواند مناسب باشد، اما تغییر آن نیز باید در Backup و Review ثبت شود. اگر Audit درباره Exposure یا Token هشدار داد، تا رفع کامل Channel یا Remote access را فعال نکنید.
Sandbox، Tool policy و Elevated چه فرقی دارند؟
Sandbox محل اجرای Tool را جدا می‌کند؛ Tool policy مشخص می‌کند چه Toolی مجاز است؛ و Elevated می‌تواند محدودیت‌های Sandbox را برای یک اقدام خاص تغییر دهد. امن‌بودن یکی به معنی درست‌بودن دو مورد دیگر نیست.
- برای شروع، Workspace access را فقط به پوشه آزمایشی محدود کنید.
- نوشتن فایل را فقط برای Taskهایی که واقعاً نیاز دارند فعال کنید.
- Shell، Browser و Network را Allowlist کنید.
- Elevated را پیش‌فرض نکنید و برای هر استفاده Approval بخواهید.
- Container را با Mount فقط‌خواندنی و Network محدود اجرا کنید.
- بعد از تغییر Policy، یک آزمون منفی برای مسیر ممنوع انجام دهید.
Pairing دستگاه و Node commandها
اتصال Device به Gateway و اجازه اجرای Command دو تصمیم جدا هستند. Pairing فقط ارتباط Device را می‌پذیرد؛ سطح فرمان‌های Node باید جداگانه Declared، Allowed و Approved شود. قابلیت‌هایی مانند ضبط صفحه یا Camera به Opt-in صریح نیاز دارند.
Request ID هر مرحله را بررسی کنید و درخواست ناشناس را تأیید نکنید. اگر یک Device بعداً Command تازه‌ای اعلام کرد، توسعه سطح دسترسی باید دوباره Review شود. Device قدیمی یا گم‌شده را از فهرست Pairing حذف کنید.
اتصال Channel بدون بازکردن درِ ورودی
Channel پیام‌رسان ورودی جدیدی برای Prompt فراهم می‌کند. فرستنده ناشناس می‌تواند محتوای مخرب ارسال کند یا Agent را به استفاده نادرست از Tool ترغیب کند. برای شروع فقط یک Channel، حساب آزمایشی و Allowlist محدود فعال کنید.
- Direct message ناشناس را با Pairing code یا Deny policy متوقف کنید.
- در Group، Mention gate و Allowlist عضو را فعال نگه دارید.
- هیچ Channel عمومی را به Agent دارای Shell یا فایل حساس وصل نکنید.
- فایل پیوست و لینک را Untrusted input در نظر بگیرید.
- ارسال پیام، حذف فایل و اقدام مالی را نیازمند Approval کنید.
- Log را از Token و محتوای حساس پاک نگه دارید.
Skill و Plugin را مانند Dependency بررسی کنید
Skill می‌تواند Agent را به خواندن Reference یا اجرای Script هدایت کند و Plugin ممکن است Tool یا اتصال تازه اضافه کند. قبل از نصب، Repository، Maintainer، Release، Permission و فایل‌های اجرایی را بررسی و نسخه را Pin کنید. برای طراحی Skill داخلی، راهنمای Agent Skills و SKILL.md را ببینید.
اگر Plugin به API یا سرویس بیرونی وصل می‌شود، Secret را در Store امن قرار دهید و Scope Token را حداقلی کنید. راهنمای امنیت MCP Server برای تعیین مرز Tool و داده مکمل خوبی است.
اولین سناریوی آزمایشی پیشنهادی
- Gateway را فقط روی Loopback اجرا کنید.
- یک پوشه شامل چند فایل ساختگی ایجاد کنید.
- Agent را فقط به خواندن همان پوشه محدود کنید.
- از آن بخواهید فایل‌ها را فهرست و خلاصه کند.
- تلاش کنترل‌شده برای خواندن مسیر بیرون Scope انجام دهید و ردشدن را تأیید کنید.
- نوشتن یک فایل خروجی را با Approval فعال کنید.
- Diff و Log را بررسی و سپس فایل آزمایشی را حذف کنید.
- Doctor و Security Audit را دوباره اجرا کنید.
- فقط پس از موفقیت، یک قابلیت را به‌صورت مرحله‌ای اضافه کنید.
اشتباه‌های رایج در راه‌اندازی OpenClaw
- اجرای Gateway با Administrator: اثر هر فرمان یا آسیب احتمالی بزرگ‌تر می‌شود.
- انتشار مستقیم Port: رابط مدیریتی ناخواسته در دسترس شبکه قرار می‌گیرد.
- اعتماد کامل به Docker: Bind و Volume و شبکه ممکن است هنوز پرخطر باشند.
- افزودن چند Channel هم‌زمان: تشخیص منبع Prompt و Incident دشوار می‌شود.
- نصب Skill ناشناس: دستور و Script غیرقابل اعتماد وارد زنجیره اجرا می‌شود.
- نادیده‌گرفتن Audit بعد از Update: Default یا Policy جدید بررسی نمی‌شود.
- قرار دادن Secret در Chat: Credential ممکن است در History یا Log باقی بماند.
چک‌لیست پیش از استفاده واقعی
- Gateway فقط از مسیر مورد انتظار قابل دسترسی است.
- Authentication و Pairing برای همه Clientها فعال است.
- Workspace به پوشه‌های لازم محدود شده است.
- Toolهای پرخطر Approval دارند.
- Sandbox و Network policy با آزمون منفی بررسی شده‌اند.
- Security Audit بدون هشدار بحرانی است.
- Backup تنظیمات و مسیر Rollback وجود دارد.
- نسخه OpenClaw و Pluginها ثبت و Pin شده‌اند.
- Channelها Allowlist و Mention gate مناسب دارند.
جمع‌بندی
OpenClaw انعطاف یک دستیار خودمیزبان را با Gateway، Node، Channel، Skill و Tool ترکیب می‌کند. همین انعطاف باعث می‌شود نصب صرف کافی نباشد. امنیت واقعی از Loopback، حساب کم‌اختیار، Scope کوچک، Pairing، Tool policy و بازبینی منظم آغاز می‌شود.
در ویندوز می‌توانید از Windows Hub، CLI بومی یا WSL2 استفاده کنید. برای نخستین اجرا ساده‌ترین مسیر سازگار با نیازتان را انتخاب کنید، ولی هیچ دسترسی شبکه یا Device را پیش از Doctor، Audit و آزمون منفی گسترش ندهید.
امروز OpenClaw را فقط در یک محیط آزمایشی با Gateway محلی و پوشه بدون داده حساس راه‌اندازی کنید؛ سپس Doctor و Security Audit را اجرا کنید و پیش از افزودن هر Channel یا Plugin، نتیجه و سطح دسترسی آن را بازبینی کنید.