English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Fundamentals

Ruang kerja agen

Ruang kerja adalah rumah agen. Ini adalah satu-satunya direktori kerja yang digunakan untuk alat file dan konteks ruang kerja. Jaga agar tetap privat dan perlakukan sebagai memori.

Ini terpisah dari ~/.openclaw/, yang menyimpan konfigurasi, kredensial, dan sesi.

Lokasi default

  • Default: ~/.openclaw/workspace
  • Jika OPENCLAW_PROFILE ditetapkan dan bukan "default", default menjadi ~/.openclaw/workspace-<profile>.
  • Timpa di ~/.openclaw/openclaw.json:
json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

openclaw onboard, openclaw configure, atau openclaw setup akan membuat ruang kerja dan menanamkan file bootstrap jika belum ada.

Jika Anda sudah mengelola file ruang kerja sendiri, Anda dapat menonaktifkan pembuatan file bootstrap:

json5
{ agents: { defaults: { skipBootstrap: true } } }

Folder ruang kerja tambahan

Instalasi lama mungkin telah membuat ~/openclaw. Menyimpan beberapa direktori ruang kerja dapat menyebabkan drift autentikasi atau status yang membingungkan, karena hanya satu ruang kerja yang aktif pada satu waktu.

Peta file ruang kerja

Ini adalah file standar yang diharapkan OpenClaw di dalam ruang kerja:

AGENTS.md - instruksi operasi

Instruksi operasi untuk agen dan cara agen menggunakan memori. Dimuat pada awal setiap sesi. Tempat yang baik untuk aturan, prioritas, dan detail "cara berperilaku".

SOUL.md - persona dan nada

Persona, nada, dan batasan. Dimuat setiap sesi. Panduan: panduan kepribadian SOUL.md.

USER.md - siapa pengguna

Siapa pengguna dan cara menyapa mereka. Dimuat setiap sesi.

IDENTITY.md - nama, vibe, emoji

Nama, vibe, dan emoji agen. Dibuat/diperbarui selama ritual bootstrap.

TOOLS.md - konvensi alat lokal

Catatan tentang alat dan konvensi lokal Anda. Tidak mengontrol ketersediaan alat; ini hanya panduan.

HEARTBEAT.md - daftar periksa heartbeat

Daftar periksa kecil opsional untuk proses heartbeat. Buat tetap singkat agar tidak membakar token.

BOOT.md - daftar periksa startup

Daftar periksa startup opsional yang dijalankan otomatis saat gateway dimulai ulang (saat hook internal diaktifkan). Buat tetap singkat; gunakan alat pesan untuk pengiriman keluar.

BOOTSTRAP.md - ritual pertama kali

Ritual satu kali untuk pertama kali. Hanya dibuat untuk ruang kerja yang benar-benar baru. Hapus setelah ritual selesai.

memory/YYYY-MM-DD.md - log memori harian

Log memori harian (satu file per hari). Disarankan membaca hari ini + kemarin saat sesi dimulai.

MEMORY.md - memori jangka panjang terkurasi (opsional)

Memori jangka panjang terkurasi: fakta, preferensi, keputusan, dan ringkasan singkat yang tahan lama. Simpan log terperinci di memory/YYYY-MM-DD.md agar alat memori dapat mengambilnya sesuai permintaan tanpa menyuntikkannya ke setiap prompt. Muat MEMORY.md hanya di sesi utama dan privat (bukan konteks bersama/grup). Lihat Memory untuk alur kerja dan flush memori otomatis.

skills/ - Skills ruang kerja (opsional)

Skills khusus ruang kerja. Lokasi skill dengan prioritas tertinggi untuk ruang kerja tersebut. Menimpa skill agen proyek, skill agen pribadi, skill terkelola, skill bawaan, dan skills.load.extraDirs saat nama bertabrakan.

canvas/ - file UI Canvas (opsional)

File UI Canvas untuk tampilan node (misalnya canvas/index.html).

Yang TIDAK ada di ruang kerja

Ini berada di bawah ~/.openclaw/ dan TIDAK boleh di-commit ke repo ruang kerja:

  • ~/.openclaw/openclaw.json (konfigurasi)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (profil autentikasi model: OAuth + kunci API)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (akun runtime Codex per agen, konfigurasi, skills, plugin, dan status thread native)
  • ~/.openclaw/credentials/ (status channel/provider plus data impor OAuth lama)
  • ~/.openclaw/agents/<agentId>/sessions/ (transkrip sesi + metadata)
  • ~/.openclaw/skills/ (skills terkelola)

Jika Anda perlu memigrasikan sesi atau konfigurasi, salin secara terpisah dan jauhkan dari kontrol versi.

Cadangan Git (direkomendasikan, privat)

Perlakukan ruang kerja sebagai memori privat. Letakkan di repo git privat agar dicadangkan dan dapat dipulihkan.

Jalankan langkah-langkah ini di mesin tempat Gateway berjalan (di situlah ruang kerja berada).

  • Inisialisasi repo

    Jika git terinstal, ruang kerja yang benar-benar baru diinisialisasi secara otomatis. Jika ruang kerja ini belum menjadi repo, jalankan:

    bash
    cd ~/.openclaw/workspacegit initgit add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/git commit -m "Add agent workspace"

  • Tambahkan remote privat

    UI web GitHub

    1. Buat repositori privat baru di GitHub.
    2. Jangan inisialisasi dengan README (menghindari konflik merge).
    3. Salin URL remote HTTPS.
    4. Tambahkan remote dan push:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    GitHub CLI (gh)

    bash
    gh auth logingh repo create openclaw-workspace --private --source . --remote origin --push

    UI web GitLab

    1. Buat repositori privat baru di GitLab.
    2. Jangan inisialisasi dengan README (menghindari konflik merge).
    3. Salin URL remote HTTPS.
    4. Tambahkan remote dan push:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • Pembaruan berkelanjutan

    bash
    git statusgit add .git commit -m "Update memory"git push

    • Jangan commit rahasia

    Starter .gitignore yang disarankan:

    gitignore
    .DS_Store.env**/*.key**/*.pem**/secrets*

    Memindahkan ruang kerja ke mesin baru

  • Clone repo

    Clone repo ke path yang diinginkan (default ~/.openclaw/workspace).

  • Perbarui konfigurasi

    Tetapkan agents.defaults.workspace ke path tersebut di ~/.openclaw/openclaw.json.

  • Seed file yang hilang

    Jalankan openclaw setup --workspace <path> untuk menanamkan file yang hilang.

  • Salin sesi (opsional)

    Jika Anda membutuhkan sesi, salin ~/.openclaw/agents/<agentId>/sessions/ dari mesin lama secara terpisah.

    • Catatan lanjutan

    • Routing multi-agen dapat menggunakan ruang kerja berbeda per agen. Lihat Routing channel untuk konfigurasi routing.
    • Jika agents.defaults.sandbox diaktifkan, sesi non-utama dapat menggunakan ruang kerja sandbox per sesi di bawah agents.defaults.sandbox.workspaceRoot.

    Terkait

    Was this useful?
    On this page

    On this page