Chuyển đến nội dung chính
OpenCode cung cấp hai danh mục được lưu trữ trong OpenClaw:
Danh mụcTiền tốNhà cung cấp runtime
Zenopencode/...opencode
Goopencode-go/...opencode-go
Cả hai danh mục đều dùng cùng một khóa API OpenCode. OpenClaw giữ các id nhà cung cấp runtime tách riêng để định tuyến theo từng mô hình ở upstream luôn chính xác, nhưng quy trình khởi tạo và tài liệu xem chúng như một thiết lập OpenCode duy nhất.

Bắt đầu

Phù hợp nhất cho: proxy đa mô hình OpenCode được tuyển chọn (Claude, GPT, Gemini, GLM).
1

Chạy quy trình khởi tạo

openclaw onboard --auth-choice opencode-zen
Hoặc truyền khóa trực tiếp:
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
2

Đặt một mô hình Zen làm mặc định

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

Xác minh các mô hình có sẵn

openclaw models list --provider opencode

Ví dụ cấu hình

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

Danh mục tích hợp sẵn

Zen

Thuộc tínhGiá trị
Nhà cung cấp runtimeopencode
Mô hình ví dụopencode/claude-opus-4-6, opencode/gpt-5.5, opencode/gemini-3.1-pro, opencode/glm-5.2

Go

Thuộc tínhGiá trị
Nhà cung cấp runtimeopencode-go
Mô hình ví dụopencode-go/kimi-k2.6, opencode-go/glm-5, opencode-go/minimax-m2.5

Cấu hình nâng cao

OPENCODE_ZEN_API_KEY cũng được hỗ trợ làm bí danh cho OPENCODE_API_KEY.
Nhập một khóa OpenCode trong quá trình thiết lập sẽ lưu thông tin xác thực cho cả hai nhà cung cấp runtime. Bạn không cần khởi tạo từng danh mục riêng.
Bạn đăng nhập vào OpenCode, thêm thông tin thanh toán và sao chép khóa API của mình. Việc thanh toán và tính khả dụng của danh mục được quản lý từ bảng điều khiển OpenCode.
Các tham chiếu OpenCode dựa trên Gemini vẫn nằm trên đường dẫn proxy-Gemini, nên OpenClaw giữ thao tác làm sạch chữ ký suy nghĩ của Gemini tại đó mà không bật xác thực phát lại Gemini gốc hoặc ghi lại bootstrap.
Các tham chiếu OpenCode không phải Gemini giữ chính sách phát lại tương thích OpenAI tối thiểu.
Nhập một khóa OpenCode trong quá trình thiết lập sẽ lưu thông tin xác thực cho cả nhà cung cấp runtime Zen và Go, nên bạn chỉ cần khởi tạo một lần.

Liên quan

Chọn mô hình

Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.

Tham chiếu cấu hình

Tham chiếu cấu hình đầy đủ cho agent, mô hình và nhà cung cấp.