Langsung ke konten utama

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.

OpenClaw adalah Gateway yang di-host sendiri yang menghubungkan Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, dan lainnya ke agen AI. Panduan ini mencakup penyiapan “asisten pribadi”: nomor WhatsApp khusus yang berperilaku seperti asisten AI Anda yang selalu aktif.

​
⚠️ Keselamatan terlebih dahulu

Anda menempatkan agen dalam posisi untuk:
  • menjalankan perintah di mesin Anda (bergantung pada kebijakan alat Anda)
  • membaca/menulis file di ruang kerja Anda
  • mengirim pesan kembali melalui WhatsApp/Telegram/Discord/Mattermost dan kanal bawaan lainnya
Mulai secara konservatif:
  • Selalu atur channels.whatsapp.allowFrom (jangan pernah menjalankan terbuka untuk seluruh dunia di Mac pribadi Anda).
  • Gunakan nomor WhatsApp khusus untuk asisten.
  • Heartbeat sekarang default setiap 30 menit. Nonaktifkan sampai Anda memercayai penyiapan dengan mengatur agents.defaults.heartbeat.every: "0m".

​
Prasyarat

  • OpenClaw sudah terpasang dan di-onboard - lihat Memulai jika Anda belum melakukannya
  • Nomor telepon kedua (SIM/eSIM/prabayar) untuk asisten

​
Penyiapan dua ponsel (direkomendasikan)

Anda menginginkan ini: Jika Anda menautkan WhatsApp pribadi Anda ke OpenClaw, setiap pesan kepada Anda menjadi “input agen”. Itu jarang yang Anda inginkan.

​
Mulai cepat 5 menit

  1. Pasangkan WhatsApp Web (menampilkan QR; pindai dengan ponsel asisten):
openclaw channels login
  1. Mulai Gateway (biarkan tetap berjalan):
openclaw gateway --port 18789
  1. Letakkan konfigurasi minimal di ~/.openclaw/openclaw.json:
{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}
Sekarang kirim pesan ke nomor asisten dari ponsel yang masuk daftar izin Anda. Saat onboarding selesai, OpenClaw otomatis membuka dashboard dan mencetak tautan yang bersih (tanpa token). Jika dashboard meminta autentikasi, tempelkan rahasia bersama yang dikonfigurasi ke pengaturan Control UI. Onboarding menggunakan token secara default (gateway.auth.token), tetapi autentikasi kata sandi juga berfungsi jika Anda mengubah gateway.auth.mode ke password. Untuk membuka kembali nanti: openclaw dashboard.

​
Beri agen ruang kerja (AGENTS)

OpenClaw membaca instruksi operasi dan “memori” dari direktori ruang kerjanya. Secara default, OpenClaw menggunakan ~/.openclaw/workspace sebagai ruang kerja agen, dan akan membuatnya (beserta starter AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) secara otomatis saat penyiapan/menjalankan agen pertama kali. BOOTSTRAP.md hanya dibuat saat ruang kerja benar-benar baru (seharusnya tidak muncul kembali setelah Anda menghapusnya). MEMORY.md bersifat opsional (tidak dibuat otomatis); jika ada, file ini dimuat untuk sesi normal. Sesi subagen hanya menyuntikkan AGENTS.md dan TOOLS.md.
Perlakukan folder ini seperti memori OpenClaw dan jadikan repo git (idealnya privat) agar AGENTS.md dan file memori Anda dicadangkan. Jika git terpasang, ruang kerja yang benar-benar baru diinisialisasi otomatis.
openclaw setup
Tata letak ruang kerja lengkap + panduan pencadangan: Ruang kerja agen Alur kerja memori: Memori Opsional: pilih ruang kerja lain dengan agents.defaults.workspace (mendukung ~). 
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
Jika Anda sudah mengirim file ruang kerja sendiri dari repo, Anda dapat menonaktifkan pembuatan file bootstrap sepenuhnya: 
{
  agents: {
    defaults: {
      skipBootstrap: true,
    },
  },
}

​
Konfigurasi yang mengubahnya menjadi “asisten”

OpenClaw default ke penyiapan asisten yang baik, tetapi biasanya Anda ingin menyesuaikan:
  • persona/instruksi di SOUL.md
  • default berpikir (jika diinginkan)
  • Heartbeat (setelah Anda memercayainya)
Contoh: 
{
  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,
    },
  },
}

​
Sesi dan memori

  • File sesi: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
  • Metadata sesi (penggunaan token, rute terakhir, dll): ~/.openclaw/agents/<agentId>/sessions/sessions.json (legacy: ~/.openclaw/sessions/sessions.json)
  • /new atau /reset memulai sesi baru untuk obrolan tersebut (dapat dikonfigurasi melalui resetTriggers). Jika dikirim sendiri, OpenClaw mengakui reset tanpa memanggil model.
  • /compact [instructions] memadatkan konteks sesi dan melaporkan sisa anggaran konteks.

​
Heartbeat (mode proaktif)

Secara default, OpenClaw menjalankan Heartbeat setiap 30 menit dengan prompt: 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. Atur agents.defaults.heartbeat.every: "0m" untuk menonaktifkan.
  • Jika HEARTBEAT.md ada tetapi secara efektif kosong (hanya baris kosong dan header markdown seperti # Heading), OpenClaw melewati proses Heartbeat untuk menghemat panggilan API.
  • Jika file tidak ada, Heartbeat tetap berjalan dan model memutuskan apa yang harus dilakukan.
  • Jika agen membalas dengan HEARTBEAT_OK (opsional dengan padding singkat; lihat agents.defaults.heartbeat.ackMaxChars), OpenClaw menekan pengiriman keluar untuk Heartbeat tersebut.
  • Secara default, pengiriman Heartbeat ke target bergaya DM user:<id> diizinkan. Atur agents.defaults.heartbeat.directPolicy: "block" untuk menekan pengiriman target langsung sambil tetap menjaga proses Heartbeat aktif.
  • Heartbeat menjalankan giliran agen penuh - interval yang lebih pendek menghabiskan lebih banyak token.
{
  agents: {
    defaults: {
      heartbeat: { every: "30m" },
    },
  },
}

​
Media masuk dan keluar

Lampiran masuk (gambar/audio/dokumen) dapat disajikan ke perintah Anda melalui template:
  • {{MediaPath}} (jalur file temp lokal)
  • {{MediaUrl}} (pseudo-URL)
  • {{Transcript}} (jika transkripsi audio diaktifkan)
Lampiran keluar dari agen: sertakan MEDIA:<path-or-url> pada barisnya sendiri (tanpa spasi). Contoh: 
Here's the screenshot.
MEDIA:https://example.com/screenshot.png
OpenClaw mengekstraknya dan mengirimkannya sebagai media bersama teks. Perilaku jalur lokal mengikuti model kepercayaan baca file yang sama seperti agen:
  • Jika tools.fs.workspaceOnly adalah true, jalur lokal MEDIA: keluar tetap dibatasi ke root temp OpenClaw, cache media, jalur ruang kerja agen, dan file yang dihasilkan sandbox.
  • Jika tools.fs.workspaceOnly adalah false, MEDIA: keluar dapat menggunakan file lokal host yang sudah diizinkan untuk dibaca oleh agen.
  • Jalur lokal dapat berupa absolut, relatif terhadap ruang kerja, atau relatif terhadap home dengan ~/.
  • Pengiriman lokal host tetap hanya mengizinkan media dan jenis dokumen aman (gambar, audio, video, PDF, dan dokumen Office). Teks biasa dan file yang menyerupai rahasia tidak diperlakukan sebagai media yang dapat dikirim.
Artinya gambar/file yang dihasilkan di luar ruang kerja sekarang dapat dikirim ketika kebijakan fs Anda sudah mengizinkan pembacaan tersebut, tanpa membuka kembali eksfiltrasi lampiran teks host arbitrer.

​
Daftar periksa operasi

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)
Log berada di bawah /tmp/openclaw/ (default: openclaw-YYYY-MM-DD.log).

​
Langkah berikutnya

​
Terkait