Astăzi am reușit să rulez „Racul” (OpenClaw AI Agent) pe Mac Mini M4. Din teste, nu recomand utilizarea M4 pentru a rula modele locale mici (raționamentele logice sunt ușor greșite), de exemplu, pentru modelele de 7B sau 8B; cea mai utilă arhitectură este: un Mac local care rulează cadrul Agent (acționând ca mâini și picioare) + apelarea API-ului Gemini 3 Flash în cloud (acționând ca creier).
Notez procesul specific de implementare și punctele de problemă, pentru referință:
1. Completează mediul de bază
Mac-ul vine cu Git, dar lipsește mediul Node.js. Am descărcat direct pachetul .pkg v24.13.1 (LTS) de pe site-ul oficial, am instalat cu opțiunile implicite, rezolvând automat mediul Node și npm.
Adresa de descărcare a mediului de bază (potrivit pentru Mac Mini M4)
Recomand descărcarea directă a pachetului .pkg pentru instalare ușoară Node.js (care va configura automat npm):
https://nodejs.org/dist/v24.13.1/node-v24.13.1.pkg
2. Trage sursa de cod și dependențele
Clonează biblioteca de cod și intră în director:
După ce ai terminat instalarea, arată astfel:
2. Trage sursa de cod și dependențele
Trage sursa de cod și dependențele
Clonează biblioteca de cod și intră în director: git clone https://github.com/OpenClaw/openclaw.git
Intră în directorul Racului: cd openclaw
Instalează pachetul de dependențe: npm install
Execută git clone pentru a trage biblioteca oficială, apoi intră în director și rulează npm install.
Punct de problemă: eroare la pornire Error: spawn pnpm ENOENT. Motivul este că compilarea de bază necesită pnpm.
Eroare la pornire, se indică faptul că lipsește pachetul pnpm
Soluție: rulează npm install -g pnpm pentru a completa acest component.
3. Configurează API-ul Google
Cererea și configurarea cheii API
Google AI Studio (aplică gratuit pentru cheia API a dezvoltatorului Gemini aici):
https://aistudio.google.com/app/apikey
Credeam că pot folosi direct serviciul Pro Google pe care l-am cumpărat pentru un an (Gemini Advanced) pentru a rula Racul, dar am realizat că există o confuzie logică: abonamentul anual pentru utilizatori și API-ul pentru dezvoltatori sunt două sisteme independente.
Abonamentul Pro este pentru utilizatori, iar dacă folosești scripturi simulate pentru a face apeluri frecvente în fundal, este foarte ușor să declanșezi mecanismul de protecție împotriva spamului de pe pagina web, riscând restricții sau chiar suspendarea contului.
Racii, ca programe de automatizare, trebuie să utilizeze sistemul API al dezvoltatorului. Calea corectă este: aplică direct la Google AI Studio pentru a obține o cheie API legitimă. În prezent, Google oferă un nivel gratuit foarte generos (Free Tier), de exemplu, pentru modelul Gemini-3-flash, limita de token-uri gratuite este complet suficientă pentru a rula monitorizarea automată pentru utilizatorii individuali, fără a fi necesară cheltuirea de bani.
Execută comanda: cp .env.example .env (acest fișier de configurare este un fișier ascuns, normal nu îl putem vedea)
După ce ai obținut cheia, copiază fișierul de configurare .env și completează-l. Atenție: simbolul # din fișierul de configurare este un comentariu, când completezi GOOGLE_API_KEY= trebuie să ștergi # de la început, altfel programul nu va putea citi.
4. Proces de supraveghere în fundal PM2
Agentul trebuie să fie disponibil 24 de ore. Dacă folosești direct npm start, programul se va termina când închizi fereastra terminalului.
Soluție: instalează pm2 global (sudo npm install -g pm2), folosește-l pentru a rula Racul în fundal. Verifică starea, iar dacă apare online, poți închide fereastra fără probleme. Atenție, starea de watching trebuie să rămână disabled, altfel programul va intra într-o buclă infinită de repornire când scrie în jurnal.
Comanda de pornire: pm2 start npm --name "longxia" -- start
Salvează procesul din fundal (pentru a evita pierderea după repornire): pm2 save
În prezent, cadrul de bază funcționează stabil în fundal, iar următorul pas este să conectăm interfața Telegram și să configurăm agregarea știrilor hardcore și monitorizarea automată a structurii tranzacțiilor de pe partea dreaptă.
Atașez anteriorul ghid de învățare pentru Rac, prietenii interesați pot să-l ia.