Onboarding Wizard ma’lumotnomasi¶
Bu openclaw onboard CLI wizard uchun to‘liq ma’lumotnoma.
Yuqori darajadagi umumiy ko‘rinish uchun Onboarding Wizard sahifasiga qarang.
Jarayon tafsilotlari (local rejim)¶
~/.openclaw/openclaw.json mavjud bo‘lsa, Keep / Modify / Reset dan birini tanlang.
- Wizard’ni qayta ishga tushirish Reset ni aniq tanlamaguningizcha
(yoki --reset uzatmaguningizcha) hech narsani o‘chirmaydi.
- Agar konfiguratsiya yaroqsiz bo‘lsa yoki eski (legacy) kalitlarni o‘z ichiga olsa, wizard to‘xtaydi va
davom etishdan oldin openclaw doctor ni ishga tushirishingizni so‘raydi.
- Reset trash dan foydalanadi (rm emas) va quyidagi qamrovlarni taklif qiladi:
- Faqat konfiguratsiya
- Konfiguratsiya + credentiallar + sessiyalar
- To‘liq reset (workspace ham o‘chiriladi)
ANTHROPIC_API_KEY dan foydalanadi yoki kalitni so‘raydi, so‘ngra uni daemon foydalanishi uchun saqlaydi.
- Anthropic OAuth (Claude Code CLI): macOS’da wizard Keychain’dagi "Claude Code-credentials" elementini tekshiradi ("Always Allow" ni tanlang, shunda launchd ishga tushganda bloklanmaydi); Linux/Windows’da mavjud bo‘lsa ~/.claude/.credentials.json dan foydalanadi.
- Anthropic token (setup-token ni joylashtirish): istalgan mashinada claude setup-token ni ishga tushiring, so‘ng tokenni joylashtiring (unga nom berishingiz mumkin; bo‘sh qoldirilsa = default).
- OpenAI Code (Codex) subscription (Codex CLI): agar ~/.codex/auth.json mavjud bo‘lsa, wizard undan foydalanishi mumkin.
- OpenAI Code (Codex) subscription (OAuth): brauzer jarayoni; code#state ni joylashtiring.
- Agar model o‘rnatilmagan bo‘lsa yoki openai/* bo‘lsa, agents.defaults.model ni openai-codex/gpt-5.2 ga o‘rnatadi.
- OpenAI API key: agar mavjud bo‘lsa OPENAI_API_KEY dan foydalanadi yoki kalitni so‘raydi, so‘ng launchd o‘qishi uchun uni ~/.openclaw/.env ga saqlaydi.
- xAI (Grok) API key: XAI_API_KEY ni so‘raydi va xAI’ni model provayder sifatida sozlaydi.
- OpenCode Zen (multi-model proxy): OPENCODE_API_KEY (yoki OPENCODE_ZEN_API_KEY, uni https://opencode.ai/auth dan oling) ni so‘raydi.
- API key: kalitni siz uchun saqlaydi.
- Vercel AI Gateway (multi-model proxy): AI_GATEWAY_API_KEY ni so‘raydi.
- Batafsil: Vercel AI Gateway
- Cloudflare AI Gateway: Account ID, Gateway ID va CLOUDFLARE_AI_GATEWAY_API_KEY ni so‘raydi.
- Batafsil: Cloudflare AI Gateway
- MiniMax M2.1: konfiguratsiya avtomatik yoziladi.
- Batafsil: MiniMax
- Synthetic (Anthropic-compatible): SYNTHETIC_API_KEY ni so‘raydi.
- Batafsil: Synthetic
- Moonshot (Kimi K2): konfiguratsiya avtomatik yoziladi.
- Kimi Coding: konfiguratsiya avtomatik yoziladi.
- Batafsil: Moonshot AI (Kimi + Kimi Coding)
- Skip: hozircha auth sozlanmaydi.
- Aniqlangan variantlardan default modelni tanlang (yoki provider/model ni qo‘lda kiriting).
- Wizard modelni tekshiradi va agar sozlangan model noma’lum bo‘lsa yoki auth yetishmasa, ogohlantiradi.
- OAuth credentiallari ~/.openclaw/credentials/oauth.json da saqlanadi; auth profillari ~/.openclaw/agents/<agentId>/agent/auth-profiles.json da saqlanadi (API keylar + OAuth).
- Batafsil: /concepts/oauth
~/.openclaw/credentials/oauth.json (yoki $OPENCLAW_STATE_DIR/credentials/oauth.json) faylini
gateway hostiga ko‘chiring.
~/.openclaw/workspace (o‘zgartirilishi mumkin).
- Agent bootstrap jarayoni uchun zarur workspace fayllarini yaratadi.
- To‘liq workspace tuzilmasi + zaxira qo‘llanmasi: Agent workspace
signal-cli o‘rnatish + account konfiguratsiyasi.
- BlueBubbles: iMessage uchun tavsiya etiladi; server URL + parol + webhook.
- iMessage: eski imsg CLI yo‘li + DB kirishi.
- DM xavfsizligi: standart holatda pairing. Birinchi DM kod yuboradi; openclaw pairing approve <channel> <code> orqali tasdiqlang yoki allowlist’dan foydalaning.
loginctl enable-linger <user> ni yoqishga harakat qiladi.
- sudo so‘rashi mumkin (/var/lib/systemd/linger ga yozadi); avval sudo’siz urinib ko‘radi.
- Runtime tanlash: Node (tavsiya etiladi; WhatsApp/Telegram uchun talab qilinadi). Bun tavsiya etilmaydi.
openclaw health ni ishga tushiradi.
- Maslahat: openclaw status --deep status chiqishiga gateway health tekshiruvlarini qo‘shadi (gateway mavjud bo‘lishi kerak).
pnpm ui:build (UI bog‘liqliklarini avtomatik o‘rnatadi).
Non-interactive rejim¶
Onboarding’ni avtomatlashtirish yoki skriptlash uchun --non-interactive dan foydalaning:
openclaw onboard --non-interactive \
--mode local \
--auth-choice apiKey \
--anthropic-api-key "$ANTHROPIC_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback \
--install-daemon \
--daemon-runtime node \
--skip-skills
Mashina o‘qiy oladigan xulosa uchun --json ni qo‘shing.
--json non-interactive rejimni avtomatik yoqmaydi. Skriptlar uchun --non-interactive (va --workspace) dan foydalaning.
bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice gemini-api-key \
--gemini-api-key "$GEMINI_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice zai-api-key \
--zai-api-key "$ZAI_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice ai-gateway-api-key \
--ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice cloudflare-ai-gateway-api-key \
--cloudflare-ai-gateway-account-id "your-account-id" \
--cloudflare-ai-gateway-gateway-id "your-gateway-id" \
--cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice moonshot-api-key \
--moonshot-api-key "$MOONSHOT_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice synthetic-api-key \
--synthetic-api-key "$SYNTHETIC_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice opencode-zen \
--opencode-zen-api-key "$OPENCODE_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Agent qo‘shish (non-interactive)¶
openclaw agents add work \
--workspace ~/.openclaw/workspace-work \
--model openai/gpt-5.2 \
--bind whatsapp:biz \
--non-interactive \
--json
Gateway sozlash ustasi RPC¶
Gateway wizard jarayonini RPC orqali taqdim etadi (wizard.start, wizard.next, wizard.cancel, wizard.status).
Mijozlar (macOS ilovasi, Control UI) onboarding logikasini qayta yozmasdan qadamlarni ko‘rsatishi mumkin.
Signal sozlamasi (signal-cli)¶
Wizard signal-cli ni GitHub release’laridan o‘rnatishi mumkin:
- Mos release assetini yuklab oladi.
- Uni
~/.openclaw/tools/signal-cli/<version>/ichiga saqlaydi. - Konfiguratsiyaga
channels.signal.cliPathni yozadi.
Eslatmalar:
- JVM build’lari uchun Java 21 talab qilinadi.
- Mavjud bo‘lsa, native build’lardan foydalaniladi.
- Windows WSL2’dan foydalanadi; signal-cli o‘rnatilishi WSL ichida Linux jarayoni bo‘yicha amalga oshiriladi.
Wizard nima yozadi¶
~/.openclaw/openclaw.json ichidagi odatiy maydonlar:
agents.defaults.workspaceagents.defaults.model/models.providers(agar Minimax tanlansa)gateway.*(mode, bind, auth, tailscale)channels.telegram.botToken,channels.discord.token,channels.signal.*,channels.imessage.*- Promptlar vaqtida rozi bo‘lsangiz, channel allowlist’lari (Slack/Discord/Matrix/Microsoft Teams) (imkon bo‘lsa nomlar ID’ga aylantiriladi).
skills.install.nodeManagerwizard.lastRunAtwizard.lastRunVersionwizard.lastRunCommitwizard.lastRunCommandwizard.lastRunMode
openclaw agents add agents.list[] va ixtiyoriy bindings ni yozadi.
WhatsApp credentiallari ~/.openclaw/credentials/whatsapp/<accountId>/ ostida saqlanadi.
Sessiyalar ~/.openclaw/agents/<agentId>/sessions/ ostida saqlanadi.
Ba’zi channel’lar plugin sifatida yetkaziladi. Onboarding vaqtida ulardan birini tanlasangiz, wizard uni sozlashdan oldin o‘rnatishni (npm yoki lokal yo‘l orqali) so‘raydi.
Tegishli hujjatlar¶
- Wizard umumiy ko‘rinishi: Onboarding Wizard
- macOS ilovasi onboarding: Onboarding
- Konfiguratsiya ma’lumotnomasi: Gateway configuration
- Provayderlar: WhatsApp, Telegram, Discord, Google Chat, Signal, BlueBubbles (iMessage), iMessage (eski)
- Skills: Skills, Skills config