Kết nối Ollama cho NanoClaw
Chuyển một nhóm agent NanoClaw sang dùng model Ollama chạy cục bộ thay vì Anthropic API để cắt chi phí.
Kỹ năng này làm gì
Định tuyến các yêu cầu của một nhóm agent NanoClaw từ Anthropic API sang máy chủ Ollama chạy nội bộ. Vì Ollama hỗ trợ sẵn endpoint tương thích Anthropic (v1/messages), bạn không cần viết code provider mới — chỉ cần ghi đè biến môi trường (ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY, NO_PROXY) và đặt tên model.
Quy trình gồm: kiểm tra/thêm trường env và blockedHosts vào ContainerConfig, cấu hình groups/<folder>/container.json, ghi model vào settings.json dùng chung của nhóm agent, build lại và khởi động lại dịch vụ, cuối cùng xác minh bằng docker inspect và /api/ps. Tài liệu còn có tuỳ chọn chặn api.anthropic.com (map về 0.0.0.0) để tránh vô tình tốn tiền API, hướng dẫn hoàn tác và 4 tình huống xử lý sự cố phổ biến.
Phù hợp với ai
- Người đang vận hành NanoClaw và muốn giảm chi phí API
- Người cần chạy agent offline hoặc trong mạng nội bộ với model open-weight
- Lập trình viên quen Docker, launchd/systemd và build bằng pnpm
Lưu ý: chỉ dùng được trong dự án NanoClaw, không áp dụng cho người dùng Claude Code nói chung.
Ví dụ sử dụng
- "Đổi nhóm agent
researchsang modelqwen3-coder" → sửa container.json và settings.json rồi restart dịch vụ. - "Chặn hẳn việc gọi Anthropic API" → thêm
blockedHosts: ["api.anthropic.com"]để container không thể kết nối ra ngoài. - "Agent trả lời nhưng Ollama không thấy hoạt động" → chẩn đoán thiếu biến
no_proxyviết thường theo phần troubleshooting.
· · · 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.
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-ollama-provider từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-ollama-provider/ 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 /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/add-ollama-provider ~/.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.
- Tải mã nguồn:
git clone https://github.com/nanocoai/nanoclaw.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r nanoclaw/.claude/skills/add-ollama-provider ~/.claude/skills/ - Chuẩn bị: cài và chạy Ollama, kiểm tra bằng
curl -s http://localhost:11434/api/tags, rồi tải model vớiollama pull <tên-model>. - Mở Claude Code tại thư mục gốc dự án NanoClaw và yêu cầu: "Dùng skill add-ollama-provider để chuyển nhóm <tên> sang Ollama".
- Làm theo các bước build (
pnpm run build) và khởi động lại dịch vụ, sau đó kiểm tra bằngdocker exec <container> env | grep ANTHROPIC.