First steps
شروع به کار
OpenClaw را نصب کنید، فرایند راهاندازی اولیه را اجرا کنید و در حدود ۵ دقیقه با دستیار هوش مصنوعی خود گفتگو کنید. در پایان، یک Gateway در حال اجرا، احراز هویت پیکربندیشده و یک جلسه گفتگوی فعال خواهید داشت.
آنچه نیاز دارید
- Node.js 22.19+، 23.11+ یا 24+ (نسخه 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 همراهی میکند. راهاندازی سریع معمولاً فقط چند دقیقه طول میکشد، اما
ورود به حساب ارائهدهنده، جفتسازی کانال، نصب دیمون، بارگیریهای شبکه، Skills
یا Pluginهای اختیاری میتوانند راهاندازی اولیه کامل را طولانیتر کنند. از مراحل اختیاری
صرفنظر کنید و بعداً با openclaw configure به آنها بازگردید.
برای مرجع کامل، به راهاندازی اولیه (CLI) مراجعه کنید.
بررسی اجرای Gateway
openclaw gateway statusباید مشاهده کنید که Gateway روی درگاه 18789 در حال گوشدادن است.
باز کردن داشبورد
openclaw dashboardاین فرمان رابط کنترل را در مرورگر شما باز میکند. اگر بارگیری شود، همهچیز بهدرستی کار میکند.
ارسال نخستین پیام
پیامی را در گفتگوی رابط کنترل تایپ کنید؛ باید پاسخی از هوش مصنوعی دریافت کنید.
ترجیح میدهید از تلفن خود گفتگو کنید؟ سریعترین کانال برای راهاندازی Telegram است (فقط به یک توکن ربات نیاز دارد). برای مشاهده همه گزینهها، به کانالها مراجعه کنید.
پیشرفته: سوار کردن یک ساخت سفارشی رابط کنترل
اگر از یک ساخت محلیسازیشده یا سفارشی داشبورد نگهداری میکنید،
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— بازنویسی مسیر فایل پیکربندی
مرجع کامل: متغیرهای محیطی.
