Katılım (CLI)

CLI ile ilk kurulum, macOS, Linux veya Windows üzerinde OpenClaw için önerilen terminal kurulum yoludur. Windows masaüstü kullanıcıları ayrıca Windows Hub ile başlayabilir. Tek bir yönlendirmeli akışta yerel bir Gateway veya uzak Gateway bağlantısını, ayrıca kanalları, Skills'i ve çalışma alanı varsayılanlarını yapılandırır.

openclaw onboard

QuickStart genellikle yalnızca birkaç dakika sürer, ancak sağlayıcı oturumu açma, kanal eşleştirme, daemon kurulumu, ağ indirmeleri, Skills veya isteğe bağlı Plugin'ler ek kurulum gerektirdiğinde tam ilk kurulum daha uzun sürebilir. Sihirbaz bu zaman çizelgesini baştan gösterir ve isteğe bağlı adımlar atlanıp daha sonra openclaw configure ile yeniden ele alınabilir.

Yerel ayar

CLI sihirbazı sabit ilk kurulum metinlerini yerelleştirir. Yerel ayarı sırasıyla OPENCLAW_LOCALE, ardından LC_ALL, ardından LC_MESSAGES, ardından LANG üzerinden çözer ve İngilizceye geri döner. Desteklenen sihirbaz yerel ayarları en, zh-CN ve zh-TW değerleridir.

OPENCLAW_LOCALE=zh-CN openclaw onboard

Adlar ve kararlı tanımlayıcılar olduğu gibi kalır: OpenClaw, Gateway, Tailscale, komutlar, yapılandırma anahtarları, URL'ler, sağlayıcı kimlikleri, model kimlikleri ve plugin/kanal etiketleri çevrilmez.

Daha sonra yeniden yapılandırmak için:

openclaw configureopenclaw agents add <name>

QuickStart ve Gelişmiş

İlk kurulum QuickStart (varsayılanlar) ile Gelişmiş (tam kontrol) seçenekleriyle başlar.

İlk kurulumun yapılandırdıkları

Yerel mod (varsayılan) sizi şu adımlardan geçirir:

1. Model/Kimlik doğrulama — Custom Provider dahil, desteklenen herhangi bir sağlayıcı/kimlik doğrulama akışını (API anahtarı, OAuth veya sağlayıcıya özgü manuel kimlik doğrulama) seçin (OpenAI uyumlu, Anthropic uyumlu veya Unknown otomatik algılama). Varsayılan bir model seçin. Güvenlik notu: Bu agent araç çalıştıracaksa veya Webhook/hooks içeriği işleyecekse, mevcut en güçlü en yeni nesil modeli tercih edin ve araç politikasını sıkı tutun. Daha zayıf/eski katmanlara prompt injection uygulamak daha kolaydır. Etkileşimsiz çalıştırmalarda --secret-input-mode ref, düz metin API anahtarı değerleri yerine auth profillerinde ortam destekli başvurular depolar. Etkileşimsiz ref modunda sağlayıcı env var ayarlanmış olmalıdır; bu env var olmadan satır içi anahtar bayrakları geçirmek hızlıca başarısız olur. Etkileşimli çalıştırmalarda gizli başvuru modunu seçmek, kaydetmeden önce hızlı bir ön doğrulamayla bir ortam değişkenine veya yapılandırılmış sağlayıcı başvurusuna (file veya exec) işaret etmenizi sağlar. Anthropic için etkileşimli ilk kurulum/configure, tercih edilen yerel yol olarak Anthropic Claude CLI'yi ve önerilen üretim yolu olarak Anthropic API key'i sunar. Anthropic setup-token da desteklenen bir token-auth yolu olarak kullanılabilir kalır.
2. Çalışma alanı — Agent dosyaları için konum (varsayılan ~/.openclaw/workspace). Bootstrap dosyalarını ekler.
3. Gateway — Port, bağlama adresi, kimlik doğrulama modu, Tailscale erişimi. Etkileşimli token modunda varsayılan düz metin token depolamasını seçin veya SecretRef'e geçin. Etkileşimsiz token SecretRef yolu: --gateway-token-ref-env <ENV_VAR>.
4. Kanallar — iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp ve daha fazlası gibi yerleşik ve resmi Plugin sohbet kanalları.
5. Daemon — Bir LaunchAgent (macOS), systemd kullanıcı birimi (Linux/WSL2) veya kullanıcı başına Startup-folder geri dönüşüyle yerel Windows Scheduled Task kurar. Token kimlik doğrulaması bir token gerektiriyorsa ve gateway.auth.token SecretRef tarafından yönetiliyorsa, daemon kurulumu bunu doğrular ancak çözümlenen token'ı supervisor servis ortamı meta verilerine kalıcı olarak yazmaz. Token kimlik doğrulaması bir token gerektiriyorsa ve yapılandırılmış token SecretRef çözümlenemiyorsa, daemon kurulumu uygulanabilir yönlendirmeyle engellenir. Hem gateway.auth.token hem de gateway.auth.password yapılandırılmışsa ve gateway.auth.mode ayarlanmamışsa, mod açıkça ayarlanana kadar daemon kurulumu engellenir.
6. Sağlık kontrolü — Gateway'i başlatır ve çalıştığını doğrular.
7. Skills — Önerilen Skills'i ve isteğe bağlı bağımlılıkları kurar.

Uzak mod yalnızca yerel istemciyi başka bir yerdeki Gateway'e bağlanacak şekilde yapılandırır. Uzak ana makineye hiçbir şey kurmaz veya orada hiçbir şeyi değiştirmez.

Başka bir agent ekleme

Kendi çalışma alanı, oturumları ve auth profilleri olan ayrı bir agent oluşturmak için openclaw agents add <name> kullanın. --workspace olmadan çalıştırmak ilk kurulumu başlatır.

Ayarladıkları:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

Notlar:

• Varsayılan çalışma alanları ~/.openclaw/workspace-<agentId> biçimini izler.
• Gelen mesajları yönlendirmek için bindings ekleyin (ilk kurulum bunu yapabilir).
• Etkileşimsiz bayraklar: --model, --agent-dir, --bind, --non-interactive.

Tam başvuru

Ayrıntılı adım adım açıklamalar ve yapılandırma çıktıları için CLI Kurulum Başvurusu sayfasına bakın. Etkileşimsiz örnekler için CLI Otomasyonu sayfasına bakın. RPC ayrıntıları dahil daha derin teknik başvuru için İlk Kurulum Başvurusu sayfasına bakın.

İlgili dokümanlar

• CLI komut başvurusu: openclaw onboard
• İlk kurulum genel bakışı: İlk Kurulum Genel Bakışı
• macOS uygulaması ilk kurulumu: İlk Kurulum
• Agent ilk çalıştırma ritüeli: Agent Bootstrap