Thêm provider OpenCode (NanoClaw)
Skill hướng dẫn thay backend agent của NanoClaw từ Anthropic SDK sang OpenCode (OpenRouter, DeepSeek, Zen…) theo từng nhóm agent.
Lập trìnhNâng cao★ 30,471⑂ 12,865Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
Giúp NanoClaw (runtime chạy agent trong container) dùng OpenCode làm provider thay cho backend mặc định claude.
- Lấy mã nguồn provider OpenCode từ nhánh
providerscho cả phía host và container, tự đăng ký vào file barrel - Ghim
@opencode-ai/sdkvà CLIopencode-aiở 1.4.17 (bản 1.14.x đổi API session, không tương thích) - Thêm layer RUN riêng vào Dockerfile rồi build lại image
- Xác minh bằng 3 test guard đăng ký + 1 test cấu trúc Dockerfile
- Chuyển provider theo nhóm bằng
ncl groups config update --provider opencode, đồng thời cập nhật overlay của các nhóm cũ - Kèm mẫu
.envvà lệnh đăng ký secret OneCLI cho OpenRouter / DeepSeek / Anthropic / OpenCode Zen
Phù hợp với ai
- Người tự vận hành NanoClaw muốn giảm chi phí hoặc thử model khác
- Nhóm muốn API key được inject qua proxy OneCLI thay vì để trong biến môi trường container
- Dev muốn thử nghiệm nhiều provider song song (nhóm A dùng Claude, nhóm B dùng DeepSeek)
Ví dụ sử dụng
- "Chuyển nhóm này sang DeepSeek" → copy file provider → đặt
OPENCODE_PROVIDER=deepseek,ANTHROPIC_BASE_URL=https://api.deepseek.com/v1→ restart nhóm. - "Dùng OpenRouter với cặp Sonnet/Haiku" → khai báo
OPENCODE_MODEL,OPENCODE_SMALL_MODEL, đăng ký key với host-patternopenrouter.ai. - Gặp lỗi
Unknown provider: opencodesau khi build →docker builder prune -f && ./container/build.shvà copy file vào overlay của nhóm cũ.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-opencode/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
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.
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.
- Clone repo NanoClaw:
git clone https://github.com/nanocoai/nanoclaw.git - Copy thư mục skill:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-opencode ~/.claude/skills/ - Chuẩn bị môi trường: Docker (buildkit),
pnpm,bun, CLInclcủa NanoClaw vàonecli. - Mở Claude Code tại thư mục gốc repo NanoClaw và yêu cầu "thêm provider OpenCode".
- Skill sẽ
git fetch origin providers, copy file provider, cài SDK 1.4.17 và sửa Dockerfile. - Kiểm tra
pnpm run buildcùng 3 test guard đều xanh, rồi build image bằng./container/build.sh. - Điền
OPENCODE_PROVIDER,OPENCODE_MODEL,ANTHROPIC_BASE_URLvào.env; đăng ký API key trong OneCLI kèm host-pattern đúng. - Chạy
ncl groups config update --id <group-id> --provider opencoderồincl groups restart --id <group-id>. Bộ nhớ không tự chuyển, hãy dùng/migrate-memory.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT