First steps
شروع به کار
OpenClaw را نصب کنید، راهاندازی اولیه را اجرا کنید و در حدود 5 دقیقه با دستیار هوش مصنوعی خود گفتگو کنید. در پایان، یک Gateway در حال اجرا، احراز هویت پیکربندیشده و یک نشست گفتگوی فعال خواهید داشت.
آنچه نیاز دارید
- Node.js 22.22.3+، 24.15+ یا 25.9+ (24 پیشفرض پیشنهادی است)
- یک کلید API از یک ارائهدهنده مدل (Anthropic، OpenAI، Google و غیره) — هنگام راهاندازی اولیه از شما درخواست میشود
راهاندازی سریع
نصب OpenClaw
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexاجرای راهاندازی اولیه
openclaw onboard --install-daemonراهنما شما را در انتخاب ارائهدهنده مدل، تنظیم کلید API
و پیکربندی Gateway همراهی میکند. QuickStart معمولاً فقط چند دقیقه طول میکشد، اما
ورود به حساب ارائهدهنده، جفتسازی کانال، نصب دیمون، بارگیریهای شبکه، Skills
یا Pluginهای اختیاری میتوانند راهاندازی اولیه کامل را طولانیتر کنند. مراحل اختیاری را
رد کنید و بعداً با openclaw configure بازگردید.
برای مرجع کامل، راهاندازی اولیه (CLI) را ببینید.
بررسی اجرای Gateway
openclaw gateway statusباید ببینید که Gateway روی پورت 18789 در حال گوشدادن است.
باز کردن داشبورد
openclaw dashboardاین فرمان Control UI را در مرورگر شما باز میکند. اگر بارگذاری شود، همهچیز بهدرستی کار میکند.
ارسال نخستین پیام
پیامی در گفتگوی Control UI تایپ کنید؛ باید پاسخی از هوش مصنوعی دریافت کنید.
ترجیح میدهید بهجای آن از تلفن خود گفتگو کنید؟ سریعترین کانال برای راهاندازی Telegram است (فقط یک توکن ربات). برای مشاهده همه گزینهها، کانالها را ببینید.
پیشرفته: سوار کردن یک بیلد سفارشی Control UI
اگر یک بیلد بومیسازیشده یا سفارشی از داشبورد را نگهداری میکنید،
gateway.controlUi.root را به دایرکتوری حاوی داراییهای استاتیک
بیلدشده و index.html اشاره دهید.
mkdir -p "$HOME/.openclaw/control-ui-custom"# فایلهای استاتیک بیلدشده خود را در آن دایرکتوری کپی کنید.سپس تنظیم کنید:
{"gateway": { "controlUi": { "enabled": true, "root": "$HOME/.openclaw/control-ui-custom" }}}Gateway را مجدداً راهاندازی و داشبورد را دوباره باز کنید:
openclaw gateway restartopenclaw dashboardگامهای بعدی
Discord، Feishu، iMessage، Matrix، Microsoft Teams، Signal، Slack، Telegram، WhatsApp، Zalo و موارد دیگر.
کنترل کنید چه کسانی میتوانند به عامل شما پیام دهند.
مدلها، ابزارها، محیط ایزوله و تنظیمات پیشرفته.
مرورگر، اجرا، جستوجوی وب، Skills و Pluginها.
پیشرفته: متغیرهای محیطی
اگر OpenClaw را بهعنوان حساب سرویس اجرا میکنید یا مسیرهای سفارشی میخواهید:
OPENCLAW_HOME— دایرکتوری خانه برای تفکیک مسیرهای داخلیOPENCLAW_STATE_DIR— بازنویسی دایرکتوری وضعیتOPENCLAW_CONFIG_PATH— بازنویسی مسیر فایل پیکربندی
مرجع کامل: متغیرهای محیطی.
