Onboarding Sihirbazı Başvurusu¶

Bu belge, openclaw onboard CLI sihirbazının tam başvurusudur. Üst düzey bir genel bakış için Onboarding Sihirbazı sayfasına bakın.

Akış ayrıntıları (yerel mod)¶

- ~/.openclaw/openclaw.json mevcutsa Koru / Değiştir / Sıfırla seçeneklerinden biri seçilir. - Sihirbazı yeniden çalıştırmak, siz açıkça Sıfırlayı seçmedikçe (veya --reset geçmedikçe) hiçbir şeyi silmez. - Yapılandırma geçersizse veya eski anahtarlar içeriyorsa, sihirbaz durur ve devam etmeden önce openclaw doctor çalıştırmanızı ister. - Sıfırlama trash kullanır (asla rm değil) ve kapsam seçenekleri sunar: - Yalnızca yapılandırma - Yapılandırma + kimlik bilgileri + oturumlar - Tam sıfırlama (çalışma alanını da kaldırır)
- Anthropic API anahtarı (önerilir): mevcutsa ANTHROPIC_API_KEY kullanır veya bir anahtar ister, ardından daemon kullanımı için kaydeder. - Anthropic OAuth (Claude Code CLI): macOS’ta sihirbaz “Claude Code-credentials” Keychain öğesini kontrol eder (“Always Allow” seçin ki launchd başlatmaları engellenmesin); Linux/Windows’ta mevcutsa ~/.claude/.credentials.json yeniden kullanılır. - Anthropic token’ı (setup-token yapıştır): herhangi bir makinede claude setup-token çalıştırın, ardından token’ı yapıştırın (ad verebilirsiniz; boş = varsayılan). - OpenAI Code (Codex) aboneliği (Codex CLI): ~/.codex/auth.json mevcutsa sihirbaz yeniden kullanabilir. - OpenAI Code (Codex) aboneliği (OAuth): tarayıcı akışı; code#state’u yapıştırın. - Model ayarlı değilse veya openai/* ise agents.defaults.model’ı openai-codex/gpt-5.2 olarak ayarlar. - OpenAI API anahtarı: mevcutsa OPENAI_API_KEY kullanır veya anahtar ister, ardından launchd okuyabilsin diye ~/.openclaw/.env’e kaydeder. - xAI (Grok) API anahtarı: XAI_API_KEY ister ve xAI’yi bir model sağlayıcısı olarak yapılandırır. - OpenCode Zen (çoklu model proxy): OPENCODE_API_KEY (veya OPENCODE_ZEN_API_KEY, https://opencode.ai/auth adresinden alın) ister. - API anahtarı: anahtarı sizin için saklar. - Vercel AI Gateway (çoklu model proxy): AI_GATEWAY_API_KEY ister. - Daha fazla ayrıntı: Vercel AI Gateway - Cloudflare AI Gateway: Hesap Kimliği, Gateway Kimliği ve CLOUDFLARE_AI_GATEWAY_API_KEY ister. - Daha fazla ayrıntı: Cloudflare AI Gateway - MiniMax M2.1: yapılandırma otomatik olarak yazılır. - Daha fazla ayrıntı: MiniMax - Synthetic (Anthropic uyumlu): SYNTHETIC_API_KEY ister. - Daha fazla ayrıntı: Synthetic - Moonshot (Kimi K2): yapılandırma otomatik olarak yazılır. - Kimi Coding: yapılandırma otomatik olarak yazılır. - Daha fazla ayrıntı: Moonshot AI (Kimi + Kimi Coding) - Atla: henüz kimlik doğrulama yapılandırılmaz. - Algılanan seçeneklerden varsayılan bir model seçin (veya sağlayıcı/modeli manuel girin). - Sihirbaz bir model denetimi çalıştırır ve yapılandırılan model bilinmiyorsa veya kimlik doğrulama eksikse uyarır. - OAuth kimlik bilgileri ~/.openclaw/credentials/oauth.json altında; kimlik doğrulama profilleri ~/.openclaw/agents/<agentId>/agent/auth-profiles.json altında bulunur (API anahtarları + OAuth). - Daha fazla ayrıntı: /concepts/oauth
Başsız/sunucu ipucu: OAuth’u tarayıcılı bir makinede tamamlayın, ardından ~/.openclaw/credentials/oauth.json (veya $OPENCLAW_STATE_DIR/credentials/oauth.json) dosyasını gateway ana makinesine kopyalayın. - Varsayılan ~/.openclaw/workspace (yapılandırılabilir). - Ajan bootstrap ritüeli için gereken çalışma alanı dosyalarını oluşturur. - Tam çalışma alanı düzeni + yedekleme kılavuzu: Ajan çalışma alanı
- Port, bağlama, kimlik doğrulama modu, Tailscale yayını. - Kimlik doğrulama önerisi: local loopback için bile Token’ı koruyun; böylece yerel WS istemcileri kimlik doğrulamak zorunda kalır. - Kimlik doğrulamayı yalnızca tüm yerel süreçlere tamamen güveniyorsanız devre dışı bırakın. - Loopback olmayan bağlamalar yine de kimlik doğrulama gerektirir. - WhatsApp: isteğe bağlı QR ile giriş. - Telegram: bot belirteci. - Discord: bot belirteci. - Google Chat: hizmet hesabı JSON’u + webhook hedef kitlesi. - Mattermost (eklenti): bot belirteci + temel URL. - Signal: isteğe bağlı signal-cli kurulumu + hesap yapılandırması. - BlueBubbles: iMessage için önerilir; sunucu URL’si + parola + webhook. - iMessage: eski imsg CLI yolu + veritabanı erişimi. - DM güvenliği: varsayılan eşleştirmedir. İlk DM bir kod gönderir; openclaw pairing approve <channel><code> üzerinden onaylayın veya izin listeleri kullanın. üzerinden onaylayın veya izin listeleri kullanın. </Step> <Step title="Daemon kurulumu"> - macOS: LaunchAgent - Oturum açmış bir kullanıcı oturumu gerektirir; başsız kullanım için özel bir LaunchDaemon kullanın (pakete dahil değildir). - Linux (ve WSL2 üzerinden Windows): systemd kullanıcı birimi - Sihirbaz, çıkıştan sonra Gateway’in ayakta kalması içinloginctl enable-linger ile lingering’i etkinleştirmeye çalışır. - sudo isteyebilir (/var/lib/systemd/lingeryazar); önce sudo olmadan dener. - **Çalışma zamanı seçimi:** Node (önerilir; WhatsApp/Telegram için gereklidir). Bun **önerilmez**. </Step> <Step title="Sağlık denetimi"> - Gerekirse Gateway’i başlatır veopenclaw healthçalıştırır. - İpucu:openclaw status --deep`, durum çıktısına gateway sağlık yoklamaları ekler (erişilebilir bir gateway gerektirir). - Mevcut Skills’leri okur ve gereksinimleri denetler. - Bir node yöneticisi seçmenizi sağlar: npm / pnpm (bun önerilmez). - İsteğe bağlı bağımlılıkları kurar (bazıları macOS’ta Homebrew kullanır). - Ek özellikler için iOS/Android/macOS uygulamaları dahil özet + sonraki adımlar.

GUI algılanmazsa, sihirbaz tarayıcı açmak yerine Control UI için SSH port yönlendirme talimatlarını yazdırır. Control UI varlıkları eksikse, sihirbaz bunları oluşturmaya çalışır; geri dönüş seçeneği pnpm ui:build’tür (UI bağımlılıklarını otomatik kurar).

Etkileşimsiz mod¶

Onboarding’i otomatikleştirmek veya betiklemek için --non-interactive kullanın:

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

Makine tarafından okunabilir bir özet için --json ekleyin.

--json, etkileşimsiz mod anlamına gelmez. Betikler için --non-interactive (ve --workspace) kullanın.

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

Ajan ekle (etkileşimsiz)¶

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.2 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

Gateway sihirbazı RPC¶

Gateway, sihirbaz akışını RPC üzerinden sunar (wizard.start, wizard.next, wizard.cancel, wizard.status). İstemciler (macOS uygulaması, Control UI) onboarding mantığını yeniden uygulamadan adımları render edebilir.

Signal kurulumu (signal-cli)¶

Sihirbaz, GitHub sürümlerinden signal-cli kurabilir:

• Uygun sürüm varlığını indirir.
• ~/.openclaw/tools/signal-cli/<version>/ altına kaydeder.
• Yapılandırmanıza channels.signal.cliPath yazar.

Notlar:

• JVM derlemeleri Java 21 gerektirir.
• Mevcut olduğunda yerel derlemeler kullanılır.
• Windows WSL2 kullanır; signal-cli kurulumu WSL içindeki Linux akışını izler.

Sihirbazın yazdıkları¶

~/.openclaw/openclaw.json içindeki tipik alanlar:

• agents.defaults.workspace
• agents.defaults.model / models.providers (MiniMax seçildiyse)
• gateway.* (mod, bağlama, kimlik doğrulama, Tailscale)
• channels.telegram.botToken, channels.discord.token, channels.signal.*, channels.imessage.*
• İstemler sırasında tercih ettiğinizde kanal izin listeleri (Slack/Discord/Matrix/Microsoft Teams) (adlar mümkün olduğunda kimliklere çözülür).
• skills.install.nodeManager
• wizard.lastRunAt
• wizard.lastRunVersion
• wizard.lastRunCommit
• wizard.lastRunCommand
• wizard.lastRunMode

openclaw agents add, agents.list[] ve isteğe bağlı bindings yazar.

WhatsApp kimlik bilgileri ~/.openclaw/credentials/whatsapp/<accountId>/ altında bulunur. Oturumlar ~/.openclaw/agents/<agentId>/sessions/ altında saklanır.

Bazı kanallar eklenti olarak sunulur. Onboarding sırasında birini seçtiğinizde, sihirbaz yapılandırılabilmesi için önce onu kurmayı (npm veya yerel bir yol) ister.

İlgili belgeler¶

• Sihirbaz genel bakışı: Onboarding Sihirbazı
• macOS uygulaması onboarding: Onboarding
• Yapılandırma başvurusu: Gateway yapılandırması
• Sağlayıcılar: WhatsApp, Telegram, Discord, Google Chat, Signal, BlueBubbles (iMessage), iMessage (eski)
• Skills: Skills, Skills yapılandırması