Thêm provider OpenCode (NanoClaw)

Skill hướng dẫn chuyển backend của nhóm agent NanoClaw từ Anthropic SDK sang OpenCode (OpenRouter, DeepSeek, Google...).

Lập trìnhNâng cao★ 30,471⑂ 12,865Điểm AI 6/10Cập nhật lần cuối: 9 thg 8, 2026

Làm được gì

NanoClaw chạy agent trong một poll loop bên trong container, và backend được chọn theo từng nhóm qua khóa provider trong container.json (mặc định là claude). Nhánh trunk chỉ có sẵn provider claude.

Skill này hướng dẫn từng bước: lấy mã nguồn provider OpenCode từ nhánh providers, đăng ký vào barrel index.ts ở cả phía host và container, cài @opencode-ai/sdk@1.4.17, thêm CLI opencode-ai (ghim đúng phiên bản) vào Dockerfile rồi build lại image. Kèm theo là 3 bài test bảo vệ: hai test kiểm tra provider đã đăng ký và một test phân tích Dockerfile.

Ngoài ra tài liệu còn có mẫu .env cho DeepSeek, OpenRouter, Anthropic và OpenCode Zen, cách đăng ký khóa qua OneCLI (Bearer so với x-api-key), script cập nhật overlay của các nhóm cũ, và các lưu ý về session UUID, NO_PROXY, cache buildkit.

Dành cho ai

Người tự vận hành NanoClaw muốn giảm chi phí model hoặc dùng nhà cung cấp khác
Developer quen làm việc với Docker, Dockerfile, pnpm/bun
Nhóm muốn so sánh nhiều backend LLM theo từng group

Ví dụ sử dụng

"Tiết kiệm chi phí với DeepSeek": đặt OPENCODE_PROVIDER=deepseek, ANTHROPIC_BASE_URL=https://api.deepseek.com/v1, đăng ký khóa trong OneCLI rồi chuyển thử một group.
"So sánh model qua OpenRouter": dùng Claude Sonnet cho việc nặng và Haiku cho việc nhẹ bằng OPENCODE_SMALL_MODEL.
"Sửa lỗi Unknown provider sau khi build": chạy docker builder prune -f && ./container/build.sh và copy file provider mới vào overlay data/v2-sessions/*/agent-runner-src/providers/.

· · · Hướng dẫn cài đặt · · ·

Cài vào ứng dụng Claude (không cần terminal)

Tải tệp ZIP bằng nút bên dưới.
Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.

↓ Tải ZIP

Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục .claude/skills/add-opencode từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-opencode/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-opencode ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Mở terminal và clone repo: git clone https://github.com/nanocoai/nanoclaw.git
Copy skill vào thư mục Claude Code: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-opencode ~/.claude/skills/
Vào repo NanoClaw (cd nanoclaw) — skill chỉ hoạt động trong repo này. Kiểm tra đã có Docker, pnpm, bun và OneCLI.
Mở Claude Code và yêu cầu: "dùng skill add-opencode để cài provider OpenCode".
Theo hướng dẫn: git fetch origin providers, copy file nguồn, thêm dòng import './opencode.js'; vào hai barrel, rồi bun add @opencode-ai/sdk@1.4.17. Tuyệt đối không dùng latest.
Thêm ARG OPENCODE_VERSION=1.4.17 và block pnpm install -g "opencode-ai@${OPENCODE_VERSION}" vào container/Dockerfile, sau đó build image bằng ./container/build.sh.
Chạy pnpm run build và các test bảo vệ; tất cả phải xanh trước khi tiếp tục.
Điền biến OPENCODE_* vào .env, đăng ký API key trong OneCLI, rồi chuyển một group thử: ncl groups config update --id <group-id> --provider opencode && ncl groups restart --id <group-id> và gửi tin nhắn kiểm tra.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT