Open-Claw

Vendor: Open-Claw Nama instalasi: open-claw Status: Pratinjau Konfigurasi native: ~/.openclaw/openclaw.json

InstalasiCopy Anchor Link

apothem install --harness open-claw

Adapter menulis berkas konfigurasi global-pengguna OpenClaw, memproyeksikan profil bersama ke dalam dokumen profil, dan memasang kohor pendukung Apothem di bawah akar harness. Konfigurasi native OpenClaw adalah JSON; materializer merender satu kunci, skills.load.extraDirs, dan berkas yang sudah ada tetap mempertahankan kunci-kuncinya yang lain.

Berkas yang ditulis: ~/.openclaw/openclaw.json, dokumen profil ~/.openclaw/apothem/rules/00-apothem-profile.md, dan berkas pendukung di bawah ~/.openclaw/.apothem/support/

Dokumen profil diakhiri dengan bagian berkas pendukung Apothem yang menyebutkan direktori absolut di bawah ~/.openclaw/.apothem/support/ tempat setiap kutipan bergaya repositori (rules/<name>.md, templates/..., hooks/...) di-resolve.

Pemetaan profil ke konfigurasi nativeCopy Anchor Link

Adapter menulis satu kunci konfigurasi. Adapter menambahkan ~/.openclaw/.apothem/support/skills ke skills.load.extraDirs, daftar direktori skill tambahan yang dibaca OpenClaw, yang merupakan cara OpenClaw menemukan skill yang terpasang. Entri ini ditempatkan setelah entri apa pun yang sudah Anda cantumkan, dan kunci Anda yang lain tetap seperti semula. Identitas, preferensi, dan aturan profil masuk ke dokumen profil. Command, skill, aturan, templat, dan prompt hook bersama dipasang sebagai materi pendukung di bawah ~/.openclaw/.apothem/support/.

Catatan kompatibilitasCopy Anchor Link

Adapter pratinjau. OpenClaw memuat skill Apothem melalui skills.load.extraDirs, tetapi tidak memuat bagian lain dari pohon pendukung maupun dokumen profil dengan sendirinya: tidak satu pun berkas instruksi workspace-nya atau konfigurasinya menunjuk ke sana, sehingga setelah pemasangan OpenClaw berjalan tanpa aturan atau server MCP Apothem.

Bentrok nama. OpenClaw membaca skill dari sumber-sumber berikut, dimulai dari prioritas tertinggi, dan ketika nama skill yang sama muncul di lebih dari satu tempat, sumber tertinggi yang menang: folder skills/ di workspace, folder .agents/skills/ di workspace, ~/.agents/skills (hanya untuk direktori state default), folder skills/ di direktori state (~/.openclaw/skills secara default), skill workshop, skill bawaan dan custodian, dan terakhir folder yang tercantum di bawah skills.load.extraDirs bersama skill plugin. Direktori Apothem adalah entri extraDirs, sehingga skill dengan nama yang sama yang Anda simpan di salah satu sumber sebelumnya adalah yang digunakan OpenClaw, dan salinan Apothem dari skill itu tetap tidak terpakai di disk. Apothem hanya menulis ke openclaw.json dan di bawah ~/.openclaw/.apothem/support/, tidak pernah ke folder-folder sebelumnya itu, sehingga instalasi, pembaruan, dan pencopotan tidak mengganti skill yang Anda simpan di sana.

agents.defaults.skills adalah daftar izin nama skill; Apothem tidak menyuntingnya, jadi jika Anda menyimpannya, periksa bahwa daftar itu menyebutkan skill Apothem yang Anda inginkan. apothem update mempertahankan kunci yang Anda tambahkan ke openclaw.json. Server MCP berada di blok mcp.servers pada konfigurasi OpenClaw, yang Anda kelola dengan openclaw mcp add dan subperintah terkait; adapter tidak menulis entri apa pun di sana. (Perilaku OpenClaw menurut dokumentasinya tentang skill, konfigurasi skill, dan ekstensi konfigurasi, dibaca 2026-10-24, serta dokumentasi CLI MCP miliknya, dibaca 2026-10-02.)

Komentar di openclaw.json. OpenClaw membaca konfigurasinya sebagai JSON5, dan Apothem menulis ulang berkas itu sebagai JSON biasa. Ketika berkas itu memuat komentar atau sintaks JSON5 lainnya dan entri tersebut tidak ada, Apothem membiarkan berkas itu tidak tersentuh dan instalasi berhenti dengan pesan yang menyebutkan kuncinya. Gabungkan sendiri entri ini ke dalam berkas Anda, atau konversikan berkas itu menjadi JSON biasa, lalu jalankan instalasi lagi:

{
  "skills": {
    "load": {
      "extraDirs": ["~/.openclaw/.apothem/support/skills"]
    }
  }
}

Entri yang Anda tambahkan sendiri dihitung sebagai milik Anda: pencopotan membiarkannya di tempatnya.

VerifikasiCopy Anchor Link

apothem verify --harness open-claw

Perintah verify memastikan bahwa:

1. Konfigurasi native ada di jalur yang diharapkan.
2. Setiap target terkelola ada; berkas terkelola tidak kosong, dan konfigurasi JSON atau YAML dapat diurai. Tambahkan --profile PATH untuk juga memastikan bahwa berkas yang terpasang cocok dengan profil tersebut.
3. skills.load.extraDirs di konfigurasi native mencantumkan ~/.openclaw/.apothem/support/skills. Tanpa entri itu OpenClaw tidak memuat skill yang terpasang; apothem update menambahkannya kembali.
4. Rutin verifikasi khusus adapter melaporkan keberhasilan.

PembaruanCopy Anchor Link

apothem update --harness open-claw

Menurunkan ulang dokumen profil dari status profil bersama saat ini dan menyegarkan berkas pendukung; openclaw.json tetap mempertahankan kunci yang sudah dimilikinya, dan entri Apothem di skills.load.extraDirs tetap tercantum sekali, seberapa sering pun Anda memperbarui. Jalankan setelah menyunting ~/.config/apothem/profile.yaml atau memutakhirkan paket Apothem yang terpasang.

PencopotanCopy Anchor Link

apothem uninstall --harness open-claw

Menghapus apa yang ditambahkan adapter: entrinya di skills.load.extraDirs, dokumen profil, dan pohon pendukung. Kunci milik Anda sendiri di openclaw.json tetap ada, termasuk entri extraDirs milik Anda sendiri, dan berkas itu dihapus hanya ketika Apothem yang membuatnya dan tidak ada lagi yang tersisa milik Anda. YAML profil bersama dan mesin Apothem tidak terpengaruh.

Gerbang konformitasCopy Anchor Link

python -m apothem.conformity.gate --all .

Pemecahan masalahCopy Anchor Link

Tombol konfigurasiCopy Anchor Link

Lihat jugaCopy Anchor Link

• Semua harness — katalog lengkap alat yang didukung
• Panduan instalasi — pasang Apothem ke dalam harness ini
• Referensi apothem harnesses — tampilkan daftar dan periksa adapter dari CLI