First steps
شروع کار
OpenClaw را نصب کنید، راهاندازی اولیه را اجرا کنید، و با دستیار هوش مصنوعی خود چت کنید — همه در حدود ۵ دقیقه. در پایان، یک Gateway در حال اجرا، احراز هویت پیکربندیشده، و یک جلسه چت فعال خواهید داشت.
آنچه نیاز دارید
- Node.js — Node 24 توصیه میشود (Node 22.19+ نیز پشتیبانی میشود)
- یک کلید 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 همراهی میکند. شروع سریع معمولا فقط چند دقیقه طول میکشد، اما
ورود به ارائهدهنده، جفتسازی کانال، نصب daemon، دانلودهای شبکه، Skills،
یا Pluginهای اختیاری میتوانند باعث شوند راهاندازی کامل بیشتر طول بکشد. میتوانید مراحل
اختیاری را رد کنید و بعدا با openclaw configure برگردید.
برای مرجع کامل، راهاندازی اولیه (CLI) را ببینید.
بررسی کنید Gateway در حال اجرا است
openclaw gateway statusباید ببینید Gateway روی پورت 18789 در حال گوش دادن است.
باز کردن داشبورد
openclaw dashboardاین کار Control UI را در مرورگر شما باز میکند. اگر بارگذاری شود، همه چیز کار میکند.
ارسال نخستین پیام
در چت Control UI یک پیام تایپ کنید و باید پاسخی از هوش مصنوعی دریافت کنید.
میخواهید بهجای آن از تلفن خود چت کنید؟ سریعترین کانال برای راهاندازی Telegram است (فقط یک توکن ربات). برای همه گزینهها کانالها را ببینید.
پیشرفته: نصب یک ساخت سفارشی Control UI
اگر یک ساخت داشبورد بومیسازیشده یا سفارشی را نگهداری میکنید،
gateway.controlUi.root را به دایرکتوریای اشاره دهید که شامل assets ایستای ساختهشده
و index.html شما است.
mkdir -p "$HOME/.openclaw/control-ui-custom"# Copy your built static files into that directory.سپس تنظیم کنید:
{"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 و موارد بیشتر.
کنترل کنید چه کسی میتواند به عامل شما پیام بدهد.
مدلها، ابزارها، sandbox، و تنظیمات پیشرفته.
مرورگر، exec، جستوجوی وب، Skills و Pluginها.
پیشرفته: متغیرهای محیطی
اگر OpenClaw را بهعنوان حساب سرویس اجرا میکنید یا مسیرهای سفارشی میخواهید:
OPENCLAW_HOME— دایرکتوری خانه برای تفکیک مسیرهای داخلیOPENCLAW_STATE_DIR— بازنویسی دایرکتوری وضعیتOPENCLAW_CONFIG_PATH— بازنویسی مسیر فایل پیکربندی
مرجع کامل: متغیرهای محیطی.
