Platforms overview
برنامه macOS
اپ macOS همراه نوار منوی OpenClaw است. وقتی به یک رابط کاربری بومی در tray، درخواستهای مجوز macOS، اعلانها، WebChat، ورودی صوتی، Canvas، یا ابزارهای Node میزبانیشده روی Mac مانند system.run نیاز دارید، از آن استفاده کنید.
اگر فقط به CLI و Gateway نیاز دارید، از شروع به کار آغاز کنید.
دانلود
بیلدهای اپ macOS را از انتشارهای GitHub OpenClaw دانلود کنید. وقتی یک انتشار شامل داراییهای اپ macOS باشد، به دنبال این موارد بگردید:
OpenClaw-<version>.dmg(ترجیحی)OpenClaw-<version>.zip
برخی انتشارها فقط شامل CLI، شواهد، یا داراییهای Windows هستند. اگر جدیدترین انتشار دارایی اپ macOS ندارد، از جدیدترین انتشاری که دارد استفاده کنید، یا اپ را با راهاندازی توسعه macOS از سورس بسازید.
اولین اجرا
- OpenClaw.app را نصب و اجرا کنید.
- برای یک Gateway محلی، این Mac را انتخاب کنید، یا به یک Gateway راه دور وصل شوید.
- برای حالت محلی، صبر کنید تا اپ runtime فضای کاربر و Gateway خود را نصب کند.
- راهاندازی provider و فهرست بررسی مجوزهای macOS را کامل کنید.
- پیام آزمایشی onboarding را ارسال کنید.
برای مسیر راهاندازی CLI/Gateway، از شروع به کار استفاده کنید. برای بازیابی مجوزها، از مجوزهای macOS استفاده کنید.
انتخاب حالت Gateway
| حالت | چه زمانی از آن استفاده کنید | صفحه جزئیات |
|---|---|---|
| محلی | این Mac باید Gateway را اجرا کند و با launchd آن را زنده نگه دارد. | Gateway روی macOS |
| راه دور | میزبان دیگری Gateway را اجرا میکند و این Mac باید آن را از طریق SSH، LAN، یا Tailnet کنترل کند. | کنترل از راه دور |
حالت محلی به CLI نصبشده openclaw نیاز دارد. روی یک Mac تازه، اپ پیش از شروع
جادوگر Gateway، CLI و runtime منطبق را بهصورت خودکار نصب میکند.
برای بازیابی دستی، Gateway روی macOS را ببینید.
مالکیتهای اپ
- وضعیت نوار منو، اعلانها، سلامت، و WebChat.
- درخواستهای مجوز macOS برای صفحهنمایش، میکروفون، گفتار، automation، و accessibility.
- ابزارهای Node محلی مانند Canvas، ضبط دوربین/صفحهنمایش، اعلانها، و
system.run. - درخواستهای تأیید Exec برای فرمانهای میزبانیشده روی Mac.
- تونلهای SSH حالت راه دور یا اتصالهای مستقیم Gateway.
اپ جایگزین Gateway یا مستندات عمومی CLI در OpenClaw نمیشود. پیکربندی اصلی Gateway، providerها، Pluginها، کانالها، ابزارها، و امنیت در مستندات خودشان قرار دارند.
صفحههای جزئیات macOS
| کار | بخوانید |
|---|---|
| نصب یا اشکالزدایی سرویس CLI/Gateway | Gateway روی macOS |
| خارج نگه داشتن state از پوشههای همگامسازیشده با ابر | Gateway روی macOS |
| اشکالزدایی کشف اپ و اتصالپذیری | Gateway روی macOS |
| درک رفتار launchd | چرخه عمر Gateway |
| رفع مشکلات مجوزها یا signing/TCC | مجوزهای macOS |
| اتصال به یک Gateway راه دور | کنترل از راه دور |
| خواندن وضعیت نوار منو و بررسیهای سلامت | نوار منو, بررسیهای سلامت |
| استفاده از رابط گفتوگوی embedded | WebChat |
| استفاده از بیدارباش صوتی یا push-to-talk | بیدارباش صوتی |
| استفاده از Canvas و deep linkهای Canvas | Canvas |
| میزبانی PeekabooBridge برای automation رابط کاربری | پل Peekaboo |
| پیکربندی تأییدهای فرمان | تأییدهای Exec, جزئیات پیشرفته |
| بررسی فرمانهای Node در Mac و IPC اپ | IPC در macOS |
| ضبط لاگها | لاگگیری macOS |
| ساخت از سورس | راهاندازی توسعه macOS |
