در این صفحه
در این صفحه
macOS companion app
راه‌اندازی محیط توسعه در macOS
راه‌اندازی توسعه در macOS
برنامهٔ macOS متعلق به OpenClaw را از کد منبع بسازید و اجرا کنید.
پیش‌نیازها
- Xcode 26.2+ (زنجیره‌ابزار Swift 6.2)، روی جدیدترین نسخهٔ macOS موجود در Software Update.
- Node.js 24.15+ و pnpm برای Gateway، CLI و اسکریپت‌های بسته‌بندی. Node 22.22.3+ نیز کار می‌کند.
1. نصب وابستگی‌ها
2. ساخت و بسته‌بندی برنامه
خروجی در dist/OpenClaw.app قرار می‌گیرد. بدون گواهی Apple Developer ID،
اسکریپت از امضای موقت استفاده می‌کند.
برای حالت‌های اجرای توسعه، پرچم‌های امضا و عیب‌یابی Team ID، به
apps/macos/README.md مراجعه کنید.
چرخهٔ سریع توسعه از ریشهٔ مخزن: scripts/restart-mac.sh (برای امضای موقت،
--no-sign را اضافه کنید؛ مجوزهای TCC با --no-sign حفظ نمی‌شوند).
3. نصب CLI و Gateway
برنامهٔ بسته‌بندی‌شده، نصب‌کنندهٔ استاندارد scripts/install-cli.sh را در خود دارد. در یک
پروفایل تازه، هنگام راه‌اندازی اولیه This Mac را انتخاب کنید؛ برنامه پیش از شروع
جادوگر Gateway، CLI و محیط اجرای همسان را در فضای کاربر نصب می‌کند.
برای بازیابی دستی محیط توسعه، CLI همسان را خودتان نصب کنید:
pnpm add -g openclaw@<version> و bun add -g openclaw@<version> نیز
کار می‌کنند. Node همچنان محیط اجرای پیشنهادی برای خود Gateway است.
عیب‌یابی
شکست ساخت: ناهماهنگی زنجیره‌ابزار یا SDK
ساخت برنامهٔ macOS به جدیدترین SDK مربوط به macOS و زنجیره‌ابزار Swift 6.2 (Xcode 26.2+) نیاز دارد.
اگر نسخه‌ها مطابقت ندارند، macOS/Xcode را به‌روزرسانی و ساخت را دوباره اجرا کنید.
از کار افتادن برنامه هنگام اعطای مجوز
اگر برنامه هنگام تلاش برای اجازه‌دادن دسترسی Speech Recognition یا Microphone از کار می‌افتد، ممکن است حافظهٔ نهان TCC خراب یا امضا ناهماهنگ باشد.
-
مجوزهای TCC را برای شناسهٔ بستهٔ اشکال‌زدایی بازنشانی کنید:
bash -
اگر این روش ناموفق بود،
BUNDLE_IDرا به‌طور موقت درscripts/package-mac-app.shتغییر دهید تا macOS از یک وضعیت پاک شروع کند.
باقی‌ماندن Gateway روی "Starting..." برای مدتی نامحدود
بررسی کنید آیا فرایندی زامبی پورت را در اختیار دارد:
اگر یک اجرای دستی پورت را در اختیار دارد، آن را متوقف کنید (Ctrl+C)، یا در آخرین راه‌حل، PID یافت‌شده در بالا را خاتمه دهید.
