Onboarding

A first run does not open the wizard. OpenCrabs goes straight to the chat, with its built-in provider already provisioned and the agent greeting you. The onboarding wizard is opt-in: run opencrabs --onboard, or /onboard from inside a session.

Panduan video ada di halaman Video Onboarding.

Mulai Cepat (3 menit)

Jalur cepat ini membuat Anda bisa mengobrol dengan agent dalam waktu kurang dari 3 menit.

Langkah	Aksi
1. Mode	Tekan `Enter` pada QuickStart
2. Workspace	Tekan `Enter` untuk menerima jalur default
3. Provider	Gunakan panah untuk memilih provider Anda (misalnya z.ai), lalu tekan `Enter`. Gunakan panah bawah untuk memilih paket (misalnya Coding), lalu tekan `Enter`
4. API Key	Tempel kunci Anda (`Cmd+V` / `Ctrl+V` / `Cmd+Shift+V` / `Ctrl+Shift+V`), lalu tekan `Enter`. Daftar model dimuat langsung
5. Model	Gunakan panah untuk memilih model Anda (misalnya gemini-2.5-pro), lalu tekan `Enter`
6. Daemon	Gunakan panah untuk memilih apakah dijalankan sebagai daemon latar belakang, lalu tekan `Enter`
7. Vibe Check	Semua pemeriksaan harus menampilkan ✅. Tekan `Enter`
8. Tentang Anda	Tulis sesuatu tentang diri Anda. Semakin banyak yang diketahui agent, semakin baik. Tekan `Enter`
9. Tentang Agent	Tulis sesuatu tentang kepribadian agent. Tekan `Enter`
10. Chat	Anda sudah masuk. Mulai berbicara dengan agent Anda

Pengaturan Lanjutan (7 menit)

Pengaturan lengkap dengan Telegram, suara lokal, vision, dan pembuatan gambar.

Langkah	Aksi
1. Mode	Tekan `Enter` pada QuickStart
2. Workspace	Tekan `Enter` untuk menerima jalur default
3. Provider	Gunakan panah untuk memilih provider Anda (misalnya z.ai), lalu tekan `Enter`. Gunakan panah bawah untuk memilih paket, lalu tekan `Enter`
4. API Key	Tempel kunci Anda, lalu tekan `Enter`. Daftar model dimuat langsung
5. Model	Gunakan panah untuk memilih model Anda, lalu tekan `Enter`
6. Channels	Gunakan panah ke Other, tekan `Space` untuk memilih Telegram, lalu tekan `Enter`. Tempel bot token Anda, ikuti petunjuk untuk mendapatkan chat ID, lalu tekan `Enter`. Pilih mode mention, lalu tekan `Enter`. Setelah muncul tulisan Connected, tekan `Enter` lagi. Gunakan panah bawah ke Continue, lalu tekan `Enter`
7. STT	Pilih Local, lalu tekan `Enter`. Pilih ukuran model (misalnya tiny untuk kecepatan), lalu tekan `Enter`
8. TTS	Pilih Local lagi, lalu tekan `Enter`. Pilih suara (misalnya Ryan), lalu tekan `Enter`. Tunggu model selesai diunduh, gunakan panah bawah ke Continue, lalu tekan `Enter`
9. Image	Tekan `Space` untuk memilih Vision dan Image Generation, lalu tekan `Enter`. Tempel API key Gemini Anda, lalu tekan `Enter`
10. Daemon	Gunakan panah untuk memilih apakah dijalankan sebagai daemon latar belakang, lalu tekan `Enter`
11. Vibe Check	Semua pemeriksaan harus menampilkan ✅. Tekan `Enter`
12. Tentang Anda	Tulis sesuatu tentang diri Anda. Semakin banyak yang diketahui agent, semakin baik. Tekan `Enter`
13. Tentang Agent	Tulis sesuatu tentang kepribadian agent. Tekan `Enter`
14. Chat	Anda sudah masuk. Mulai berbicara dengan agent Anda

Alur Onboarding

Wizard ini adalah TUI yang dikendalikan keyboard dengan 8 langkah. Navigasi dengan tombol panah, Tab untuk maju, Esc untuk kembali.

Langkah	Layar	Yang Anda lakukan
1	Pilih Mode	Pilih QuickStart (lewati channel) atau Advanced
2	Workspace	Pilih direktori kerja untuk operasi file
3	Provider & Autentikasi	Pilih provider → tempel API key → pilih model (diambil langsung)
4	Channels	Space untuk mengaktifkan atau menonaktifkan channel → Enter pada tiap channel untuk mengatur
5	Suara	Provider STT (Groq, Whisper lokal, atau nonaktif) + suara TTS
6	Image	Pengaktifan Vision + model pembuatan + API key
7	Daemon	Pasang daemon latar belakang (opsional)
8	Pengaturan Brain	Buat SOUL.md secara otomatis dari profil Anda

Pengaturan Channel (Langkah 4)

Layar channel menampilkan 5 integrasi: Telegram, Discord, WhatsApp, Slack, Trello.

Space mengaktifkan atau menonaktifkan channel
Enter pada channel yang aktif membuka layar pengaturannya (token, ID, allowlist)
Enter pada Continue atau Tab melewati ke langkah berikutnya
Setiap layar pengaturan channel memiliki tombol Test Connection

Lihat Ringkasan Channels untuk panduan navigasi lengkap.

Menjalankan Ulang Pengaturan

Anda dapat langsung ke langkah mana pun tanpa menjalankan ulang seluruh wizard:

Perintah	Langkah
`/onboard`	Wizard lengkap
`/onboard:provider`	Pemilihan provider & model
`/onboard:channels`	Pemilih channel
`/onboard:voice`	Pengaturan suara
`/onboard:image`	Pengaturan image
`/onboard:brain`	Pembuatan file brain

Setelah onboarding, agent Anda aktif dan memperkenalkan diri. Ia membaca file brain-nya (SOUL.md, AGENTS.md, TOOLS.md) dan memulai percakapan.

Bootstrap

Pada saat pertama kali dijalankan, agent melewati fase bootstrap:

Mengenal Anda (nama, preferensi, gaya kerja)
Menentukan identitasnya (nama, kepribadian, emoji)
Membuka SOUL.md bersama Anda untuk membahas nilai-nilai
Menyiapkan USER.md dengan profil Anda

File bootstrap (BOOTSTRAP.md) akan menghapus dirinya sendiri setelah selesai.

Migrasi dari Tool Lain

Sudah memakai ClaudeCode, OpenClaw, Hermes, atau harness agent AI lainnya? Agent Anda dapat memindahkan data yang sudah ada (memori, skill, perintah kustom, preferensi) ke file brain miliknya menggunakan bahasa alami. Tidak perlu memindahkan file secara manual.

Ini berfungsi dengan semua agent atau harness coding yang menyimpan konfigurasi secara lokal. Migrasi mencari direktori konfigurasi tool lain di filesystem Anda, membaca isinya, dan memetakannya ke format file brain OpenCrabs (SOUL.md, USER.md, TOOLS.md, MEMORY.md, AGENTS.md, CODE.md).

Migrasi Terpandu

Jika Anda ingin meninjau apa saja yang akan dimigrasi sebelum prosesnya berjalan:

Cari data ClaudeCode/OpenClaw/Hermes saya secara lokal (atau harness agent lain yang pernah saya pakai) dan audit migrasi ke file brain kita, laporkan setelah selesai, jalankan setelah saya konfirmasi dan setujui.

Agent akan:

Mencari direktori konfigurasi tool lain di filesystem Anda
Membaca dan mengurai semua file terkait (memori, perintah, skill, preferensi)
Membuat audit yang menunjukkan secara tepat apa dipetakan ke mana
Menunggu konfirmasi Anda
Menjalankan migrasi dan melaporkan rincian lengkap

Migrasi Otomatis

Jika Anda ingin langsung selesai:

Cari data agent/harness saya yang sudah ada secara lokal dan migrasikan semuanya ke file brain kita, tanpa perlu persetujuan saya. Langsung rencanakan dan jalankan, lalu laporkan setelah selesai dengan rincian lengkap.

Agent melewati langkah audit, merencanakan migrasi secara internal, menjalankannya, dan memberi Anda ringkasan semua yang dipindahkan.

Apa yang Dipetakan

Sumber	Tujuan	Contoh
Memori / CLAUDE.md / file konteks	`MEMORY.md`	Keputusan proyek, konteks sebelumnya
Perintah kustom	`commands.toml`	Perintah slash dan definisinya
Skill / instruksi agent	`AGENTS.md`, `TOOLS.md`	Aturan alur kerja, konfigurasi tool
Preferensi / profil pengguna	`USER.md`	Nama, zona waktu, gaya coding
Standar coding / aturan linting	`CODE.md`	Panduan gaya, konvensi

Tips: Jalankan migrasi tepat setelah onboarding selagi konteksnya masih segar. Agent sudah memiliki USER.md dan SOUL.md Anda dari wizard, sehingga ia dapat menggabungkan data secara cerdas alih-alih menimpanya.

Perintah Utama

Perintah	Deskripsi
`/help`	Tampilkan semua perintah yang tersedia
`/models`	Ganti provider atau model
`/new`	Buat sesi baru
`/sessions`	Pindah antar sesi
`/cd`	Ubah direktori kerja
`/compact`	Ringkas konteks secara manual
`/evolve`	Unduh versi terbaru
`/rebuild`	Build dari source
`/approve`	Atur kebijakan persetujuan

Mode Persetujuan

Atur seberapa besar otonomi yang dimiliki agent:

Mode	Perilaku
`/approve`	Tanya sebelum setiap penggunaan tool (default)
`/approve auto`	Setujui otomatis untuk sesi ini
`/approve yolo`	Selalu setujui otomatis (tersimpan)

Direktori Kerja

Agent bekerja di dalam direktori kerja untuk operasi file. Ubah dengan:

Perintah /cd di chat
Pemilih direktori di TUI (Tab untuk memilih)
Tool config_manager set_working_directory

Direktori kerja disimpan per sesi. Saat berpindah sesi, direktori dipulihkan secara otomatis.

Petunjuk Filter Model (v0.3.78)

Pemilih model onboarding sekarang selalu menampilkan petunjuk filter di atas daftar model (“Type to filter…”). Sebelumnya, petunjuk ini hanya muncul setelah Anda mulai mengetik, sehingga pengguna tidak tahu bahwa filter tersedia. Selain itu, ID model yang diketik persis sekarang mengalahkan pencocokan substring: jika Anda mengetik claude-opus-4-8 secara persis, model tersebut dipilih meskipun model lain memiliki substring yang sama.

Keyboard shortcuts

OpenCrabs