برنامه لینوکس

Gateway در Linux به‌طور کامل پشتیبانی می‌شود. Node محیط اجرای پیشنهادی است. Bun برای Gateway توصیه نمی‌شود (باگ‌های WhatsApp/Telegram).

اپلیکیشن‌های همراه بومی Linux برنامه‌ریزی شده‌اند. اگر می‌خواهید در ساخت یکی کمک کنید، مشارکت‌ها پذیرفته می‌شوند.

# مسیر سریع مبتدیان (VPS)

1. Node 24 را نصب کنید (توصیه‌شده؛ Node 22 LTS، در حال حاضر 22.16+، همچنان برای سازگاری کار می‌کند)
2. npm i -g openclaw@latest
3. openclaw onboard --install-daemon
4. از لپ‌تاپ خود: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. http://127.0.0.1:18789/ را باز کنید و با راز مشترک پیکربندی‌شده احراز هویت کنید (به‌طور پیش‌فرض token؛ اگر gateway.auth.mode: "password" را تنظیم کرده‌اید، password)

راهنمای کامل سرور Linux: سرور Linux. نمونه گام‌به‌گام VPS: exe.dev

# نصب

• شروع به کار
• نصب و به‌روزرسانی‌ها
• جریان‌های اختیاری: Bun (آزمایشی)، Nix، Docker

# Gateway

• راهنمای عملیاتی Gateway
• پیکربندی

# نصب سرویس Gateway (CLI)

یکی از این‌ها را استفاده کنید:

openclaw onboard --install-daemon

یا:

openclaw gateway install

یا:

openclaw configure

وقتی درخواست شد، سرویس Gateway را انتخاب کنید.

تعمیر/مهاجرت:

openclaw doctor

# کنترل سیستم (واحد کاربری systemd)

OpenClaw به‌طور پیش‌فرض یک سرویس systemd از نوع کاربر نصب می‌کند. برای سرورهای اشتراکی یا همیشه‌روشن از سرویس سیستم استفاده کنید. openclaw gateway install و openclaw onboard --install-daemon از قبل واحد canonical فعلی را برای شما تولید می‌کنند؛ فقط وقتی به یک راه‌اندازی سفارشی system/service-manager نیاز دارید، آن را دستی بنویسید. راهنمای کامل سرویس در راهنمای عملیاتی Gateway قرار دارد.

راه‌اندازی حداقلی:

~/.config/systemd/user/openclaw-gateway[-<profile>].service را ایجاد کنید:

[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
KillMode=control-group

[Install]
WantedBy=default.target

آن را فعال کنید:

systemctl --user enable --now openclaw-gateway[-<profile>].service

# فشار حافظه و خاتمه‌های OOM

در Linux، وقتی حافظه یک میزبان، VM یا cgroup کانتینر تمام می‌شود، kernel یک قربانی OOM انتخاب می‌کند. Gateway می‌تواند قربانی نامناسبی باشد، چون مالک نشست‌های بلندمدت و اتصال‌های کانال است. بنابراین OpenClaw در صورت امکان فرایندهای فرزند گذرا را طوری اولویت‌بندی می‌کند که پیش از Gateway خاتمه داده شوند.

برای spawnهای فرزند واجد شرایط در Linux، OpenClaw فرزند را از طریق یک wrapper کوتاه /bin/sh شروع می‌کند که oom_score_adj خود فرزند را به 1000 افزایش می‌دهد، سپس فرمان واقعی را exec می‌کند. این یک عملیات بدون امتیاز ویژه است، چون فرزند فقط احتمال خاتمه OOM خودش را افزایش می‌دهد.

سطح‌های فرایند فرزند پوشش‌داده‌شده شامل این‌ها هستند:

• فرزندان فرمان مدیریت‌شده توسط supervisor،
• فرزندان shell مربوط به PTY،
• فرزندان سرور stdio مربوط به MCP،
• فرایندهای مرورگر/Chrome که توسط OpenClaw اجرا شده‌اند.

این wrapper فقط مخصوص Linux است و وقتی /bin/sh در دسترس نباشد، رد می‌شود. همچنین اگر env فرزند OPENCLAW_CHILD_OOM_SCORE_ADJ=0، false، no یا off را تنظیم کند، رد می‌شود.

برای بررسی یک فرایند فرزند:

cat /proc/<child-pid>/oom_score_adj

مقدار مورد انتظار برای فرزندان پوشش‌داده‌شده 1000 است. فرایند Gateway باید امتیاز عادی خود را حفظ کند، که معمولاً 0 است.

این جایگزین تنظیم معمول حافظه نیست. اگر یک VPS یا کانتینر به‌طور مکرر فرزندان را خاتمه می‌دهد، محدودیت حافظه را افزایش دهید، همزمانی را کاهش دهید، یا کنترل‌های منابع قوی‌تری مانند MemoryMax= در systemd یا محدودیت‌های حافظه در سطح کانتینر اضافه کنید.

# مرتبط

• نمای کلی نصب
• سرور Linux
• Raspberry Pi