Guides

Kişisel asistan kurulumu

OpenClaw; Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo ve daha fazlasını AI ajanlarına bağlayan, kendi barındırdığınız bir Gateway'dir. Bu kılavuz "kişisel asistan" kurulumunu kapsar: her zaman açık AI asistanınız gibi davranan özel bir WhatsApp numarası.

⚠️ Önce güvenlik

Bir ajanı şu konumlara getiriyorsunuz:

makinenizde komut çalıştırma (araç politikanıza bağlı olarak)
çalışma alanınızdaki dosyaları okuma/yazma
WhatsApp/Telegram/Discord/Mattermost ve diğer birlikte gelen kanallar üzerinden dışarı mesaj gönderme

Temkinli başlayın:

Her zaman channels.whatsapp.allowFrom ayarlayın (kişisel Mac'inizde dünyaya açık şekilde asla çalıştırmayın).
Asistan için özel bir WhatsApp numarası kullanın.
Heartbeat'ler artık varsayılan olarak her 30 dakikada birdir. Kuruluma güvenene kadar agents.defaults.heartbeat.every: "0m" ayarlayarak devre dışı bırakın.

Önkoşullar

OpenClaw kurulmuş ve başlangıç kurulumu yapılmış olmalı - bunu henüz yapmadıysanız Başlarken bölümüne bakın
Asistan için ikinci bir telefon numarası (SIM/eSIM/ön ödemeli)

İki telefonlu kurulum (önerilir)

İstediğiniz yapı şu:

flowchart TB
    A["<b>Your Phone (personal)
</b>
Your WhatsApp
+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)
</b>
Assistant WA
+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)
</b>
AI agent"]

Kişisel WhatsApp'ınızı OpenClaw'a bağlarsanız, size gelen her mesaj "ajan girdisi" haline gelir. Bu nadiren istediğiniz şeydir.

5 dakikalık hızlı başlangıç

WhatsApp Web'i eşleştirin (QR gösterir; asistan telefonuyla tarayın):

openclaw channels login

Gateway'i başlatın (çalışır durumda bırakın):

openclaw gateway --port 18789

~/.openclaw/openclaw.json içine minimal bir yapılandırma koyun:

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

Şimdi izin listesine alınmış telefonunuzdan asistan numarasına mesaj gönderin.

Başlangıç kurulumu tamamlandığında OpenClaw panoyu otomatik olarak açar ve temiz (tokenlaştırılmamış) bir bağlantı yazdırır. Pano kimlik doğrulaması isterse, yapılandırılmış paylaşılan gizli anahtarı Control UI ayarlarına yapıştırın. Başlangıç kurulumu varsayılan olarak bir token kullanır (gateway.auth.token), ancak gateway.auth.mode değerini password olarak değiştirdiyseniz parola kimlik doğrulaması da çalışır. Daha sonra yeniden açmak için: openclaw dashboard.

Ajanınıza bir çalışma alanı verin (AGENTS)

OpenClaw, çalışma talimatlarını ve "belleği" çalışma alanı dizininden okur.

Varsayılan olarak OpenClaw, ajan çalışma alanı olarak ~/.openclaw/workspace kullanır ve kurulumda/ilk ajan çalıştırmasında bunu (artı başlangıç AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) otomatik olarak oluşturur. BOOTSTRAP.md yalnızca çalışma alanı yepyeniyken oluşturulur (sildikten sonra geri gelmemelidir). MEMORY.md isteğe bağlıdır (otomatik oluşturulmaz); mevcut olduğunda normal oturumlar için yüklenir. Alt ajan oturumları yalnızca AGENTS.md ve TOOLS.md enjekte eder.

openclaw setup

Tam çalışma alanı düzeni + yedekleme kılavuzu: Ajan çalışma alanı Bellek iş akışı: Bellek

İsteğe bağlı: agents.defaults.workspace ile farklı bir çalışma alanı seçin (~ destekler).

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

Bir depodan kendi çalışma alanı dosyalarınızı zaten gönderiyorsanız, bootstrap dosyası oluşturmayı tamamen devre dışı bırakabilirsiniz:

{
  agents: {
    defaults: {
      skipBootstrap: true,
    },
  },
}

Bunu "bir asistana" dönüştüren yapılandırma

OpenClaw varsayılan olarak iyi bir asistan kurulumu sunar, ancak genellikle şunları ayarlamak istersiniz:

SOUL.md içinde persona/talimatlar
düşünme varsayılanları (istenirse)
Heartbeat'ler (ona güvendikten sonra)

Örnek:

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // Start with 0; enable later.
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

Oturumlar ve bellek

Oturum dosyaları: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
Oturum meta verileri (token kullanımı, son rota vb.): ~/.openclaw/agents/<agentId>/sessions/sessions.json (eski: ~/.openclaw/sessions/sessions.json)
/new veya /reset, o sohbet için yeni bir oturum başlatır (resetTriggers üzerinden yapılandırılabilir). Tek başına gönderilirse OpenClaw, modeli çağırmadan sıfırlamayı onaylar.
/compact [instructions], oturum bağlamını compact eder ve kalan bağlam bütçesini bildirir.

Heartbeat'ler (proaktif mod)

Varsayılan olarak OpenClaw, şu prompt ile her 30 dakikada bir Heartbeat çalıştırır: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. Devre dışı bırakmak için agents.defaults.heartbeat.every: "0m" ayarlayın.

HEARTBEAT.md varsa ancak fiilen boşsa (yalnızca boş satırlar ve # Heading gibi markdown başlıkları), OpenClaw API çağrılarını azaltmak için Heartbeat çalıştırmasını atlar.
Dosya yoksa Heartbeat yine çalışır ve model ne yapılacağına karar verir.
Ajan HEARTBEAT_OK ile yanıt verirse (isteğe bağlı kısa dolgu ile; bkz. agents.defaults.heartbeat.ackMaxChars), OpenClaw o Heartbeat için giden teslimatı bastırır.
Varsayılan olarak, DM tarzı user:<id> hedeflerine Heartbeat teslimatına izin verilir. Heartbeat çalıştırmalarını aktif tutarken doğrudan hedef teslimatını bastırmak için agents.defaults.heartbeat.directPolicy: "block" ayarlayın.
Heartbeat'ler tam ajan turları çalıştırır - daha kısa aralıklar daha fazla token tüketir.

{
  agent: {
    heartbeat: { every: "30m" },
  },
}

Gelen ve giden medya

Gelen ekler (görseller/ses/dokümanlar) şablonlar üzerinden komutunuza sunulabilir:

{{MediaPath}} (yerel geçici dosya yolu)
{{MediaUrl}} (sözde URL)
{{Transcript}} (ses transkripsiyonu etkinse)

Ajandan giden ekler: kendi satırına MEDIA:<path-or-url> ekleyin (boşluk yok). Örnek:

Here's the screenshot.
MEDIA:https://example.com/screenshot.png

OpenClaw bunları ayıklar ve metinle birlikte medya olarak gönderir.

Yerel yol davranışı, ajanla aynı dosya okuma güven modelini izler:

tools.fs.workspaceOnly true ise, giden MEDIA: yerel yolları OpenClaw geçici kökü, medya önbelleği, ajan çalışma alanı yolları ve sandbox tarafından oluşturulan dosyalarla sınırlı kalır.
tools.fs.workspaceOnly false ise, giden MEDIA: ajanın zaten okumasına izin verilen ana makine yerel dosyalarını kullanabilir.
Yerel yollar mutlak, çalışma alanına göreli veya ~/ ile ev dizinine göreli olabilir.
Ana makine yerel gönderimleri yine de yalnızca medya ve güvenli belge türlerine izin verir (görseller, ses, video, PDF ve Office belgeleri). Düz metin ve gizli anahtar benzeri dosyalar gönderilebilir medya olarak değerlendirilmez.

Bu, çalışma alanı dışındaki oluşturulmuş görsellerin/dosyaların artık dosya sistemi politikanız bu okumaları zaten izin veriyorsa, rastgele ana makine metin eki sızıntısını yeniden açmadan gönderilebileceği anlamına gelir.

Operasyon kontrol listesi

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # asks the gateway for a live health probe with channel probes when supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

Loglar /tmp/openclaw/ altında bulunur (varsayılan: openclaw-YYYY-MM-DD.log).

Sonraki adımlar

WebChat: WebChat
Gateway operasyonları: Gateway runbook
Cron + uyandırmalar: Cron işleri
macOS menü çubuğu eşlikçisi: OpenClaw macOS uygulaması
iOS Node uygulaması: iOS uygulaması
Android Node uygulaması: Android uygulaması
Windows durumu: Windows (WSL2)
Linux durumu: Linux uygulaması
Güvenlik: Güvenlik

Kişisel asistan kurulumu

⚠️ Önce güvenlik

Önkoşullar

İki telefonlu kurulum (önerilir)

5 dakikalık hızlı başlangıç

Ajanınıza bir çalışma alanı verin (AGENTS)

Bunu "bir asistana" dönüştüren yapılandırma

Oturumlar ve bellek

Heartbeat'ler (proaktif mod)

Gelen ve giden medya

Operasyon kontrol listesi

Sonraki adımlar

İlgili

Ask OpenClaw

# ⚠️ Önce güvenlik

# Önkoşullar

# İki telefonlu kurulum (önerilir)

# 5 dakikalık hızlı başlangıç

# Ajanınıza bir çalışma alanı verin (AGENTS)

# Bunu "bir asistana" dönüştüren yapılandırma

# Oturumlar ve bellek

# Heartbeat'ler (proaktif mod)

# Gelen ve giden medya

# Operasyon kontrol listesi

# Sonraki adımlar

# İlgili

⚠️ Önce güvenlik

Önkoşullar

İki telefonlu kurulum (önerilir)

5 dakikalık hızlı başlangıç

Ajanınıza bir çalışma alanı verin (AGENTS)

Bunu "bir asistana" dönüştüren yapılandırma

Oturumlar ve bellek

Heartbeat'ler (proaktif mod)

Gelen ve giden medya

Operasyon kontrol listesi

Sonraki adımlar

İlgili