Gateway در macOS

OpenClaw.app دیگر Node/Bun یا زمان اجرای Gateway را همراه خود بسته‌بندی نمی‌کند. برنامه macOS انتظار دارد CLI openclaw به‌صورت خارجی نصب شده باشد، Gateway را به‌عنوان فرآیند فرزند اجرا نمی‌کند، و یک سرویس launchd مختص هر کاربر را مدیریت می‌کند تا Gateway در حال اجرا بماند (یا اگر یک Gateway محلی از قبل در حال اجرا باشد، به همان متصل می‌شود).

# نصب CLI (برای حالت محلی الزامی است)

Node 24 زمان اجرای پیش‌فرض در Mac است. Node 22 LTS، در حال حاضر 22.16+، همچنان برای سازگاری کار می‌کند. سپس openclaw را به‌صورت سراسری نصب کنید:

npm install -g openclaw@<version>

دکمه Install CLI در برنامه macOS همان جریان نصب سراسری را اجرا می‌کند که برنامه در داخل از آن استفاده می‌کند: ابتدا npm را ترجیح می‌دهد، سپس pnpm، و بعد bun را اگر تنها مدیر بسته شناسایی‌شده باشد. Node همچنان زمان اجرای توصیه‌شده برای Gateway است.

# Launchd (Gateway به‌عنوان LaunchAgent)

برچسب:

• ai.openclaw.gateway (یا ai.openclaw.<profile>؛ قالب قدیمی com.openclaw.* ممکن است باقی بماند)

محل Plist (مختص هر کاربر):

• ~/Library/LaunchAgents/ai.openclaw.gateway.plist (یا ~/Library/LaunchAgents/ai.openclaw.<profile>.plist)

مدیر:

• برنامه macOS نصب/به‌روزرسانی LaunchAgent را در حالت محلی بر عهده دارد.
• CLI نیز می‌تواند آن را نصب کند: openclaw gateway install.

رفتار:

• «OpenClaw Active»‏ LaunchAgent را فعال/غیرفعال می‌کند.
• خروج از برنامه Gateway را متوقف نمی‌کند (launchd آن را زنده نگه می‌دارد).
• اگر یک Gateway از قبل روی پورت پیکربندی‌شده در حال اجرا باشد، برنامه به‌جای شروع نمونه‌ای جدید، به همان متصل می‌شود.

ثبت رخداد:

• خروجی استاندارد/خطای launchd: /tmp/openclaw/openclaw-gateway.log

# سازگاری نسخه

برنامه macOS نسخه Gateway را با نسخه خودش بررسی می‌کند. اگر ناسازگار باشند، CLI سراسری را به‌روزرسانی کنید تا با نسخه برنامه مطابقت داشته باشد.

# بررسی Smoke

openclaw --version

OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback

سپس:

openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000

# مرتبط

• برنامه macOS
• راهنمای عملیاتی Gateway