Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

İlk kez kurulum yapıyorsanız Başlarken ile başlayın. Onboarding ayrıntıları için bkz. Onboarding (CLI).

​
Kısa Özet

Güncellemeleri ne sıklıkla istediğinize ve Gateway’i kendiniz çalıştırmak isteyip istemediğinize göre bir kurulum iş akışı seçin:
  • Özelleştirme repo dışında yaşar: yapılandırmanızı ve çalışma alanınızı ~/.openclaw/openclaw.json ve ~/.openclaw/workspace/ içinde tutun; böylece repo güncellemeleri bunlara dokunmaz.
  • Kararlı iş akışı (çoğu kişi için önerilir): macOS uygulamasını kurun ve paketle gelen Gateway’i çalıştırmasına izin verin.
  • En güncel iş akışı (dev): Gateway’i pnpm gateway:watch üzerinden kendiniz çalıştırın, ardından macOS uygulamasının Local modda bağlanmasına izin verin.

​
Ön koşullar (kaynaktan)

  • Node 24 önerilir (Node 22 LTS, şu anda 22.16+, hâlâ desteklenir)
  • Kaynak checkout’ları için pnpm gerekir. OpenClaw, dev modunda paketle gelen Plugin’leri extensions/* pnpm workspace paketlerinden yükler; bu nedenle kökte npm install çalıştırmak tam kaynak ağacını hazırlamaz.
  • Docker (isteğe bağlı; yalnızca container tabanlı kurulum/e2e için - bkz. Docker)

​
Özelleştirme stratejisi (güncellemelerin sorun çıkarmaması için)

Hem “tamamen bana göre özelleştirilmiş” hem de kolay güncellemeler istiyorsanız, özelleştirmenizi şurada tutun:
  • Yapılandırma: ~/.openclaw/openclaw.json (JSON/JSON5 benzeri)
  • Çalışma alanı: ~/.openclaw/workspace (skills, prompt’lar, bellekler; bunu özel bir git reposu yapın)
Bir kez bootstrap yapın: 
openclaw setup
Bu reponun içinden yerel CLI girdisini kullanın: 
openclaw setup
Henüz global kurulumunuz yoksa pnpm openclaw setup ile çalıştırın.

​
Gateway’i bu repodan çalıştırma

pnpm build sonrasında paketlenmiş CLI’yi doğrudan çalıştırabilirsiniz: 
node openclaw.mjs gateway --port 18789 --verbose

​
Kararlı iş akışı (önce macOS uygulaması)

  1. OpenClaw.app uygulamasını kurun ve başlatın (menü çubuğu).
  2. Onboarding/izinler kontrol listesini tamamlayın (TCC istemleri).
  3. Gateway’in Local olduğundan ve çalıştığından emin olun (uygulama bunu yönetir).
  4. Yüzeyleri bağlayın (örnek: WhatsApp):
openclaw channels login
  1. Sağlamlık kontrolü:
openclaw health
Onboarding derlemenizde mevcut değilse:
  • openclaw setup çalıştırın, ardından openclaw channels login çalıştırın, sonra Gateway’i manuel olarak başlatın (openclaw gateway).

​
En güncel iş akışı (Gateway bir terminalde)

Amaç: TypeScript Gateway üzerinde çalışmak, hot reload almak, macOS uygulama UI’ını bağlı tutmak.

​
0) (İsteğe bağlı) macOS uygulamasını da kaynaktan çalıştırın

macOS uygulamasını da en güncel halde istiyorsanız: 
./scripts/restart-mac.sh

​
1) Dev Gateway’i başlatın

pnpm install
# Yalnızca ilk çalıştırmada (veya yerel OpenClaw yapılandırmasını/çalışma alanını sıfırladıktan sonra)
pnpm openclaw setup
pnpm gateway:watch
gateway:watch, Gateway watch sürecini adlandırılmış bir tmux oturumunda başlatır veya yeniden başlatır ve etkileşimli terminallerden otomatik bağlanır. Etkileşimsiz shell’ler ayrık kalır ve tmux attach -t openclaw-gateway-watch-main yazdırır; etkileşimli bir çalıştırmayı ayrık tutmak için OPENCLAW_GATEWAY_WATCH_ATTACH=0 pnpm gateway:watch, ön plan watch modu için pnpm gateway:watch:raw kullanın. Watcher, ilgili kaynak, yapılandırma ve paketle gelen Plugin metadata değişikliklerinde yeniden yükler. İzlenen Gateway başlangıç sırasında çıkarsa, gateway:watch bir kez openclaw doctor --fix --non-interactive çalıştırır ve tekrar dener; bu yalnızca dev’e özgü onarım geçişini devre dışı bırakmak için OPENCLAW_GATEWAY_WATCH_AUTO_DOCTOR=0 ayarlayın. pnpm openclaw setup, yeni bir checkout için tek seferlik yerel yapılandırma/çalışma alanı ilklendirme adımıdır. pnpm gateway:watch, dist/control-ui yeniden derlemez; bu nedenle ui/ değişikliklerinden sonra pnpm ui:build komutunu yeniden çalıştırın veya Control UI geliştirirken pnpm ui:dev kullanın.

​
2) macOS uygulamasını çalışan Gateway’inize yönlendirin

OpenClaw.app içinde:
  • Bağlantı Modu: Local Uygulama, yapılandırılmış portta çalışan gateway’e bağlanır.

​
3) Doğrulayın

  • Uygulama içi Gateway durumu “Mevcut gateway kullanılıyor …” yazmalıdır
  • Veya CLI üzerinden:
openclaw health

​
Yaygın tuzaklar

  • Yanlış port: Gateway WS varsayılanı ws://127.0.0.1:18789; uygulama + CLI’yi aynı portta tutun.
  • Durumun bulunduğu yer:
    • Kanal/provider durumu: ~/.openclaw/credentials/
    • Model auth profilleri: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
    • Oturumlar: ~/.openclaw/agents/<agentId>/sessions/
    • Loglar: /tmp/openclaw/

​
Kimlik bilgisi depolama haritası

Auth hata ayıklarken veya neyin yedekleneceğine karar verirken bunu kullanın:
  • WhatsApp: ~/.openclaw/credentials/whatsapp/<accountId>/creds.json
  • Telegram bot token’ı: config/env veya channels.telegram.tokenFile (yalnızca normal dosya; symlink’ler reddedilir)
  • Discord bot token’ı: config/env veya SecretRef (env/file/exec provider’ları)
  • Slack token’ları: config/env (channels.slack.*)
  • Eşleştirme allowlist’leri:
    • ~/.openclaw/credentials/<channel>-allowFrom.json (varsayılan hesap)
    • ~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json (varsayılan olmayan hesaplar)
  • Model auth profilleri: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Dosya destekli secrets payload’u (isteğe bağlı): ~/.openclaw/secrets.json
  • Eski OAuth içe aktarımı: ~/.openclaw/credentials/oauth.json Daha fazla ayrıntı: Güvenlik.

​
Güncelleme (kurulumunuzu bozmadan)

  • ~/.openclaw/workspace ve ~/.openclaw/ dizinlerini “size ait şeyler” olarak tutun; kişisel prompt’ları/yapılandırmayı openclaw reposuna koymayın.
  • Kaynağı güncelleme: git pull + pnpm install + pnpm gateway:watch kullanmaya devam edin.

​
Linux (systemd kullanıcı servisi)

Linux kurulumları bir systemd user servisi kullanır. Varsayılan olarak systemd, çıkışta/idle durumunda kullanıcı servislerini durdurur; bu da Gateway’i sonlandırır. Onboarding sizin için lingering’i etkinleştirmeye çalışır (sudo isteyebilir). Hâlâ kapalıysa şunu çalıştırın: 
sudo loginctl enable-linger $USER
Her zaman açık veya çok kullanıcılı sunucular için bir user servisi yerine system servisi düşünün (lingering gerekmez). systemd notları için Gateway runbook bölümüne bakın.

​
İlgili belgeler