First steps
İlk katılım genel bakışı
OpenClaw, terminal ve macOS uygulaması üzerinden ilk kuruluma sahiptir. Her ikisi de önce çıkarımı hazırlar: mevcut yapay zekâ erişimini algılar, canlı bir tamamlamayı zorunlu tutar ve ancak bundan sonra kalan kurulumu yapılandırmak üzere Crestodian'ı başlatır. Erişilebilir ve yapılandırılmış bir Gateway'in varsayılan aracısında zaten yapılandırılmış bir model varsa ilk kurulum atlanır ve normal aracı kullanıcı arayüzü açılır. Terminal akışı ayrıca ayrıntılı kurulum için tam klasik sihirbazı sunar.
Hangi yolu kullanmalıyım?
| CLI ilk kurulumu | macOS uygulaması ilk kurulumu | |
|---|---|---|
| Platformlar | macOS, Linux, Windows (yerel veya WSL2) | Yalnızca macOS |
| Arayüz | Çıkarım kurulumu, ardından Crestodian | Çıkarım kurulumu, ardından Crestodian |
| En uygun kullanım | Sunucular, ekransız sistemler, tam denetim | Masaüstü Mac, görsel kurulum |
| Otomasyon | Betikler için --non-interactive |
Yalnızca elle |
| Komut | openclaw onboard |
Uygulamayı başlatın |
Çoğu kullanıcı CLI ilk kurulumu ile başlamalıdır; her yerde çalışır ve size en fazla denetimi sağlar.
İlk kurulumun yapılandırdıkları
Yönlendirmeli çıkarım aşaması yalnızca şunları hazırlar:
- Model sağlayıcısı ve kimlik doğrulama — algılanan erişim veya doğrulanmış bir API anahtarı
- Doğrulanmış çıkarım — varsayılan aracının etkin modelinde gerçek bir tamamlama
Bu tamamlama başarılı olduktan sonra Crestodian; çalışma alanını, Gateway'i, Gateway hizmetini, kanalları, aracıları, plugin'leri ve diğer isteğe bağlı özellikleri yapılandırabilir.
Klasik CLI sihirbazı ek olarak şunları yapılandırabilir:
- Kanallar (isteğe bağlı) — Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, Telegram, WhatsApp ve diğerleri gibi yerleşik ve paketlenmiş sohbet kanalları
- Gelişmiş Gateway denetimleri — uzak mod, ağ ayarları ve arka plan hizmeti seçenekleri
CLI ilk kurulumu
Herhangi bir terminalde çalıştırın:
openclaw onboardYönlendirmeli akış mevcut yapay zekâ erişimini algılar, adayları sırayla canlı olarak
sınar, başarısızlık durumunda sonraki adaya geçer ve maskelenmiş elle anahtar girişi sunar.
Modeli ve kimlik bilgisini yalnızca başarılı bir tamamlamadan sonra kaydeder; ardından
çalışma alanını, Gateway'i, kanalları, aracıları, plugin'leri ve diğer
isteğe bağlı özellikleri yapılandırmak üzere Crestodian'ı başlatır. Çıkarım öncesi Crestodian,
yapay zekâyı atlama yolu veya akış içinde klasik kuruluma geçiş yoktur. Bunun yerine klasik
sihirbazı kullanmak istediğinizde çıkın ve openclaw onboard --classic komutunu çalıştırın.
Çıkarım başarılı olduktan sonra Crestodian, kanal kurulumunu maskelenmiş bir terminal
sihirbazına devredebilir. Yönlendirmeli veya klasik sağlayıcı kurulumunu açmaz; model
sağlayıcısını ya da kimlik doğrulamasını değiştirmek için Crestodian'dan çıkın ve
openclaw onboard komutunu çalıştırın.
Ayrıntılı model/kimlik doğrulama, kanal, beceri, uzak Gateway veya içe aktarma kurulumu için
openclaw onboard --classic kullanın. --install-daemon eklemek de klasik akışı seçer
ve arka plan hizmetini tek adımda kurar. Konuşmaya dayalı, çıkarım dışı kurulum ve onarım
için openclaw crestodian kullanın. openclaw onboard --modern, aynı canlı çıkarım
geçidini kullanan bir uyumluluk diğer adıdır.
Tam başvuru: İlk kurulum (CLI)
CLI komut belgeleri: openclaw onboard
macOS uygulaması ilk kurulumu
OpenClaw uygulamasını açın. Yapılandırılmış yerel veya uzak Gateway'i erişilebilirse ve varsayılan aracıda zaten yapılandırılmış bir model varsa uygulama ilk kurulumu ve Crestodian'ı atlayarak normal aracı kullanıcı arayüzünü hemen açar.
Yeni veya eksik bir Gateway için ilk çalıştırma akışı mevcut yapay zekâ erişimini (Claude Code, Codex veya API anahtarları) algılar, en iyi seçeneği canlı olarak sınar ve yalnızca gerçek bir yanıttan sonra kaydeder; otomatik olarak yedek seçeneklere geçer ve hiçbir şey bulunamadığında doğrulanmış bir elle API anahtarı girme adımı sunar. Hassas kimlik bilgileri maskelenmiş giriş kullanır. Çıkarım başarılı olduğunda Crestodian başlar ve geri kalan yapılandırmaya yardımcı olur.
Gemini CLI, kurulumdan sonra normal aracılar için kullanılabilir olmaya devam eder ancak araçsız yoklamayı zorunlu kılamadığı için bu çıkarım geçidinde sunulmaz.
Tam başvuru: İlk kurulum (macOS uygulaması)
Özel veya listelenmemiş sağlayıcılar
Sağlayıcınız listelenmemişse openclaw onboard --classic komutunu çalıştırın,
Özel Sağlayıcı seçeneğini belirleyin ve şunları girin:
- Uç nokta uyumluluğu: OpenAI uyumlu (
/chat/completions), OpenAI Responses uyumlu (/responses), Anthropic uyumlu (/messages) veya bilinmiyor (üçünü de yoklar ve otomatik algılar) - Temel URL ve API anahtarı (uç nokta gerektirmiyorsa API anahtarı isteğe bağlıdır)
- Model kimliği ve isteğe bağlı model diğer adı
Birden fazla özel uç nokta birlikte kullanılabilir; her biri kendi uç nokta kimliğini alır.
