O‘rnatish¶

Agar birinchi marta o‘rnatayotgan bo‘lsangiz, Getting Started sahifasidan boshlang. Wizard tafsilotlari uchun Onboarding Wizard ga qarang.

Oxirgi yangilanish: 2026-01-01

Qisqacha¶

• Moslashtirish repodan tashqarida saqlanadi: ~/.openclaw/workspace (workspace) + ~/.openclaw/openclaw.json (config).
• Barqaror ish jarayoni: macOS ilovasini o‘rnating; u o‘rnatilgan Gateway’ni o‘zi ishga tushiradi.
• Eng so‘nggi (bleeding edge) ish jarayoni: Gateway’ni pnpm gateway:watch orqali o‘zingiz ishga tushiring, so‘ng macOS ilovasi Local rejimida ulanadi.

Talablar (manbadan yig‘ish uchun)¶

• Node >=22
• pnpm
• Docker (ixtiyoriy; faqat container asosidagi o‘rnatish/e2e uchun — qarang Docker)

Moslashtirish strategiyasi (yangilanishlar zarar qilmasligi uchun)¶

Agar “100% o‘zimga mos” sozlashni va oson yangilanishlarni xohlasangiz, sozlamalaringizni quyida saqlang:

• Config: ~/.openclaw/openclaw.json (JSON/JSON5-ga o‘xshash)
• Workspace: ~/.openclaw/workspace (skills, promptlar, xotiralar; uni shaxsiy git repo qiling)

Bir marta ishga tushiring:

openclaw setup

Ushbu repodan foydalanayotganda, lokal CLI kirish nuqtasidan foydalaning:

openclaw setup

Agar global o‘rnatish hali bo‘lmasa, pnpm openclaw setup orqali ishga tushiring.

Gateway’ni ushbu repodan ishga tushirish¶

pnpm build dan so‘ng, paketlangan CLI’ni to‘g‘ridan-to‘g‘ri ishga tushirishingiz mumkin:

node openclaw.mjs gateway --port 18789 --verbose

Barqaror ish jarayoni (macOS ilovasi birinchi)¶

1. OpenClaw.app ni o‘rnating va ishga tushiring (menyu paneli).
2. Onboarding/ruxsatlar ro‘yxatini yakunlang (TCC so‘rovlari).
3. Gateway Local rejimida va ishga tushganligiga ishonch hosil qiling (ilova boshqaradi).
4. Kanallarni ulang (masalan: WhatsApp):

openclaw channels login

5. Tekshiruv:

openclaw health

Agar onboarding sizning build versiyangizda mavjud bo‘lmasa:

• openclaw setup, so‘ng openclaw channels login ni ishga tushiring, keyin Gateway’ni qo‘lda ishga tushiring (openclaw gateway).

Eng so‘nggi (bleeding edge) ish jarayoni (Gateway terminalda)¶

Maqsad: TypeScript Gateway ustida ishlash, hot reload olish va macOS ilovasi UI’sini ulangan holda saqlash.

0) (Ixtiyoriy) macOS ilovasini ham manbadan ishga tushirish¶

Agar macOS ilovasini ham eng so‘nggi versiyada ishlatmoqchi bo‘lsangiz:

./scripts/restart-mac.sh

1) Dev Gateway’ni ishga tushiring¶

pnpm install
pnpm gateway:watch

gateway:watch gateway’ni watch rejimida ishga tushiradi va TypeScript o‘zgarishlarida qayta yuklaydi.

2) macOS ilovasini ishlayotgan Gateway’ga yo‘naltiring¶

OpenClaw.app ichida:

• Ulanish rejimi: Mahalliy Ilova sozlangan port orqali ishlayotgan gateway’ga ulanadi.

3) Tekshirish¶

• Ilova ichida Gateway holati “Using existing gateway …” deb ko‘rsatilishi kerak.
• Yoki CLI orqali:

openclaw health

Keng tarqalgan xatolar¶

• Noto‘g‘ri port: Gateway WS odatda ws://127.0.0.1:18789; ilova va CLI bir xil portdan foydalanayotganini tekshiring.
• Holat (state) qayerda saqlanadi:
• Credential’lar: ~/.openclaw/credentials/
• Sessiyalar: ~/.openclaw/agents/<agentId>/sessions/
• Loglar: /tmp/openclaw/

Credential saqlash xaritasi¶

Autentifikatsiya muammolarini tekshirish yoki nimani zaxiralash kerakligini aniqlashda foydalaning:

• WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
• Telegram bot tokeni: config/env yoki channels.telegram.tokenFile
• Discord bot tokeni: config/env (token fayli hali qo‘llab-quvvatlanmaydi)
• Slack tokenlari: config/env (channels.slack.*)
• Pairing allowlist’lar: ~/.openclaw/credentials/<channel>-allowFrom.json
• Model auth profillari: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Eski OAuth importi: ~/.openclaw/credentials/oauth.json Batafsil: Security.

Yangilash (sozlamalaringizni buzmasdan)¶

• ~/.openclaw/workspace va ~/.openclaw/ ni “o‘zingizga tegishli ma’lumotlar” sifatida saqlang; shaxsiy prompt/config’ni openclaw reposiga joylamang.
• Manbani yangilash: git pull + pnpm install (agar lockfile o‘zgargan bo‘lsa) + pnpm gateway:watch dan foydalanishda davom eting.

Linux (systemd user xizmati)¶

Linux o‘rnatishlari systemd user xizmatidan foydalanadi. Odatda, systemd logout/idle vaqtida user xizmatlarini to‘xtatadi, bu esa Gateway’ni o‘chiradi. Onboarding siz uchun lingering’ni yoqishga harakat qiladi (sudo so‘rashi mumkin). Agar hali ham o‘chiq bo‘lsa, quyidagini bajaring:

sudo loginctl enable-linger $USER

Doimiy ishlash yoki ko‘p foydalanuvchili serverlar uchun system xizmati user xizmatidan ko‘ra ma’qul (lingering talab qilinmaydi). systemd bo‘yicha eslatmalar uchun Gateway runbook ga qarang.

Bog‘liq hujjatlar¶

• Gateway runbook (flaglar, nazorat, portlar)
• Gateway configuration (config sxemasi + misollar)
• Discord va Telegram (reply teglari + replyToMode sozlamalari)
• OpenClaw assistantini sozlash
• macOS app (gateway hayotiy sikli)