Langsung ke konten utama

OpenCode

OpenCode mengekspos dua katalog hosted di OpenClaw:
CatalogPrefixProvider runtime
Zenopencode/...opencode
Goopencode-go/...opencode-go
Kedua katalog menggunakan kunci API OpenCode yang sama. OpenClaw menjaga id provider runtime tetap terpisah agar routing per model di hulu tetap benar, tetapi onboarding dan dokumentasi memperlakukannya sebagai satu penyiapan OpenCode.

Memulai

Paling cocok untuk: proxy multi-model OpenCode yang dikurasi (Claude, GPT, Gemini).
1

Jalankan onboarding

openclaw onboard --auth-choice opencode-zen
Atau berikan key secara langsung:
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
2

Tetapkan model Zen sebagai default

openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"
3

Verifikasi bahwa model tersedia

openclaw models list --provider opencode

Contoh config

{
  env: { OPENCODE_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

Katalog

Zen

PropertyValue
Provider runtimeopencode
Contoh modelopencode/claude-opus-4-6, opencode/gpt-5.4, opencode/gemini-3-pro

Go

PropertyValue
Provider runtimeopencode-go
Contoh modelopencode-go/kimi-k2.5, opencode-go/glm-5, opencode-go/minimax-m2.5

Catatan lanjutan

OPENCODE_ZEN_API_KEY juga didukung sebagai alias untuk OPENCODE_API_KEY.
Memasukkan satu key OpenCode saat penyiapan menyimpan kredensial untuk kedua provider runtime. Anda tidak perlu melakukan onboarding untuk setiap katalog secara terpisah.
Anda masuk ke OpenCode, menambahkan detail penagihan, dan menyalin kunci API Anda. Penagihan dan ketersediaan katalog dikelola dari dashboard OpenCode.
Ref OpenCode yang didukung Gemini tetap berada di jalur proxy-Gemini, sehingga OpenClaw tetap mempertahankan sanitasi thought-signature Gemini di sana tanpa mengaktifkan validasi replay Gemini native atau penulisan ulang bootstrap.
Ref OpenCode non-Gemini mempertahankan kebijakan replay kompatibel OpenAI yang minimal.
Memasukkan satu key OpenCode saat penyiapan menyimpan kredensial untuk provider runtime Zen dan Go, jadi Anda hanya perlu melakukan onboarding sekali.

Terkait

Pemilihan model

Memilih provider, ref model, dan perilaku failover.

Referensi konfigurasi

Referensi config lengkap untuk agent, model, dan provider.