First steps
شروع به کار
OpenClaw را نصب کنید، onboarding را اجرا کنید و با دستیار هوش مصنوعی خود گپ بزنید — همه در حدود ۵ دقیقه. در پایان، یک Gateway در حال اجرا، احراز هویت پیکربندیشده و یک نشست گفتوگوی فعال خواهید داشت.
آنچه نیاز دارید
- Node.js — Node 24 توصیه میشود (Node 22.14+ نیز پشتیبانی میشود)
- یک کلید API از یک ارائهدهنده مدل (Anthropic، OpenAI، Google و غیره) — onboarding از شما درخواست میکند
راهاندازی سریع
نصب OpenClaw
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
اجرای onboarding
openclaw onboard --install-daemon
راهنما شما را در انتخاب ارائهدهنده مدل، تنظیم کلید API و پیکربندی Gateway هدایت میکند. حدود ۲ دقیقه طول میکشد.
برای مرجع کامل، Onboarding (CLI) را ببینید.
بررسی اجرای Gateway
openclaw gateway status
باید ببینید که Gateway روی پورت 18789 گوش میدهد.
باز کردن داشبورد
openclaw dashboard
این کار Control UI را در مرورگر شما باز میکند. اگر بارگذاری شد، همه چیز کار میکند.
ارسال نخستین پیام
پیامی را در گفتوگوی Control UI تایپ کنید و باید پاسخی از هوش مصنوعی دریافت کنید.
میخواهید بهجای آن از تلفن خود گپ بزنید؟ سریعترین کانال برای راهاندازی Telegram است (فقط یک توکن ربات). برای همه گزینهها، کانالها را ببینید.
پیشرفته: mount کردن یک ساخت Control UI سفارشی
اگر یک ساخت داشبورد بومیسازیشده یا سفارشی را نگهداری میکنید،
gateway.controlUi.root را به دایرکتوریای اشاره دهید که شامل داراییهای استاتیک
ساختهشده و 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 restart
openclaw dashboard
کارهای بعدی
Discord، Feishu، iMessage، Matrix، Microsoft Teams، Signal، Slack، Telegram، WhatsApp، Zalo و موارد بیشتر.
کنترل کنید چه کسی میتواند به agent شما پیام بدهد.
مدلها، ابزارها، sandbox و تنظیمات پیشرفته.
مرورگر، exec، جستوجوی وب، Skills و Pluginها.
پیشرفته: متغیرهای محیطی
اگر OpenClaw را بهعنوان حساب سرویس اجرا میکنید یا مسیرهای سفارشی میخواهید:
OPENCLAW_HOME— دایرکتوری خانه برای حل مسیر داخلیOPENCLAW_STATE_DIR— بازنویسی دایرکتوری وضعیتOPENCLAW_CONFIG_PATH— بازنویسی مسیر فایل پیکربندی
مرجع کامل: متغیرهای محیطی.