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ırmak (araç politikanıza bağlı olarak)
• çalışma alanınızdaki dosyaları okumak/yazmak
• WhatsApp/Telegram/Discord/Mattermost ve diğer paketli kanallar üzerinden dışarı mesaj göndermek

Temkinli başlayın:

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

Ön koşullar

• OpenClaw kurulmuş ve ilk yapılandırması tamamlanmış 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 düzen şudur:

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

Kişisel WhatsApp'ınızı OpenClaw'a bağlarsanız, size gelen her mesaj "ajan girdisi" haline gelir. Genellikle istediğiniz şey bu değildir.

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

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

openclaw channels login

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

openclaw gateway --port 18789

3. ~/.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.

İlk yapılandırma tamamlandığında OpenClaw panoyu otomatik açar ve temiz (token içermeyen) 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. İlk yapılandırma varsayılan olarak 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 tekrar açmak için: openclaw dashboard.

Ajan için 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 (başlangıç AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md ile birlikte) otomatik oluşturur. BOOTSTRAP.md yalnızca çalışma alanı tamamen yeniyken oluşturulur (sildikten sonra geri gelmemelidir). MEMORY.md isteğe bağlıdır (otomatik oluşturulmaz); varsa normal oturumlar için yüklenir. Alt ajan oturumları yalnızca AGENTS.md ve TOOLS.md dosyalarını 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",    },  },}

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

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

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

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

• SOUL.md içinde persona/talimatlar
• düşünme varsayılanları (istenirse)
• Heartbeat (ona güvendiğinizde)

Örnek:

{  logging: { level: "info" },  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-6" },      workspace: "~/.openclaw/workspace",      thinkingDefault: "high",      timeoutSeconds: 1800,      // Start with 0; enable later.      heartbeat: { every: "0m" },    },    list: [      {        id: "main",        default: true,        groupChat: {          mentionPatterns: ["@openclaw", "openclaw"],        },      },    ],  },  channels: {    whatsapp: {      allowFrom: ["+15555550123"],      groups: {        "*": { requireMention: true },      },    },  },  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 ile yapılandırılabilir). Tek başına gönderilirse OpenClaw, modeli çağırmadan sıfırlamayı onaylar.
• /compact [instructions] oturum bağlamını sıkıştırır ve kalan bağlam bütçesini bildirir.

Heartbeat (proaktif mod)

Varsayılan olarak OpenClaw, şu istemle 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, Markdown/HTML yorumları, # Heading gibi Markdown başlıkları, fence işaretçileri veya boş kontrol listesi taslakları), 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ı olarak kısa dolgu ile; bkz. agents.defaults.heartbeat.ackMaxChars), OpenClaw bu Heartbeat için dışa teslimi bastırır.
• Varsayılan olarak, DM tarzı user:<id> hedeflerine Heartbeat teslimine izin verilir. Heartbeat çalıştırmalarını aktif tutarken doğrudan hedef teslimini bastırmak için agents.defaults.heartbeat.directPolicy: "block" ayarlayın.
• Heartbeat tam ajan dönüşleri çalıştırır - daha kısa aralıklar daha fazla token tüketir.

{  agents: {    defaults: {      heartbeat: { every: "30m" },    },  },}

Medya girişi ve çıkışı

Gelen ekler (görüntüler/sesler/belgeler) şablonlar üzerinden komutunuza sunulabilir:

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

Ajandan çıkan ekler, mesaj aracı veya yanıt yükü üzerinde media, mediaUrl, mediaUrls, path ya da filePath gibi yapılandırılmış medya alanlarını kullanır. Örnek mesaj aracı argümanları:

{  "message": "Here's the screenshot.",  "mediaUrl": "https://example.com/screenshot.png"}

OpenClaw yapılandırılmış medyayı metinle birlikte gönderir. Eski nihai asistan yanıtları uyumluluk için hâlâ normalize edilebilir, ancak araç çıktısı, tarayıcı çıktısı, akış blokları ve mesaj eylemleri metni ek komutları olarak ayrıştırmaz.

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

• tools.fs.workspaceOnly true ise, dışa giden yerel medya 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, dışa giden yerel medya, ajanın zaten okumasına izin verilen host-yerel dosyaları kullanabilir.
• Yerel yollar mutlak, çalışma alanına göre göreli veya ~/ ile ana dizine göre göreli olabilir.
• Host-yerel gönderimler yine yalnızca medya ve güvenli belge türlerine izin verir (görüntüler, ses, video, PDF, Office belgeleri ve Markdown/MD, TXT, JSON, YAML ve YML gibi doğrulanmış metin belgeleri). Bu, mevcut host okuma güven sınırının bir uzantısıdır; gizli tarayıcı değildir: ajan host-yerel bir secret.txt veya config.json okuyabiliyorsa, uzantı ve içerik doğrulaması eşleştiğinde o dosyayı ekleyebilir.

Bu, fs politikanız bu okumalarına zaten izin veriyorsa çalışma alanı dışındaki oluşturulmuş görüntülerin/dosyaların artık gönderilebileceği, rastgele host-yerel metin uzantılarının ise engelli kalacağı anlamına gelir. Hassas dosyaları ajanın okuyabildiği dosya sisteminin dışında tutun veya daha katı yerel yol gönderimleri için tools.fs.workspaceOnly=true tutun.

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 supportedopenclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

Günlükler /tmp/openclaw/ altında tutulur (varsayılan: openclaw-YYYY-MM-DD.log).

Sonraki adımlar

• WebChat: WebChat
• Gateway işlemleri: Gateway çalışma kılavuzu
• Cron + uyandırmalar: Cron işleri
• macOS menü çubuğu yardımcı uygulaması: OpenClaw macOS uygulaması
• iOS düğüm uygulaması: iOS uygulaması
• Android düğüm uygulaması: Android uygulaması
• Windows Hub: Windows
• Linux durumu: Linux uygulaması
• Güvenlik: Güvenlik

İlgili

• Başlarken
• Kurulum
• Kanallara genel bakış