Tích hợp model cục bộ Atomic Chat (NanoClaw)
Skill gắn MCP server để agent trong container của NanoClaw gọi được các model chạy cục bộ trên app Atomic Chat.
Lập trìnhNâng cao★ 30,840⑂ 12,826Điểm AI 7/10Cập nhật lần cuối: 23 thg 9, 2026
Skill này làm gì
- Copy MCP server dạng stdio (
atomic-chat-mcp-stdio.ts) vào cây agent-runner và đăng ký mụcatomic_chattrongmcpServerscủaindex.ts. - Thêm
...atomicChatEnv()vàocontributedEnvtrongcomposeSessionSpecđể chuyển tiếpATOMIC_CHAT_HOST/ATOMIC_CHAT_API_KEYtừ host vào container. - Sửa logger stderr của Docker driver để log có tiền tố
[ATOMIC]hiện ở mức info, và thêm biến mẫu vào.env.example. - Mở ra hai tool cho agent:
atomic_chat_list_modelsvàatomic_chat_generate. - Kèm bước kiểm chứng bằng vitest và bun test để chắc chắn hai điểm tích hợp không bị lệch.
Phù hợp với ai
- Người tự vận hành NanoClaw, muốn Claude điều phối còn việc nặng thì đẩy sang model cục bộ.
- Người đã dùng Atomic Chat (bản fork của Jan) với API tương thích OpenAI tại
127.0.0.1:1337. - Môi trường macOS + Docker Desktop, quen với việc container gọi service trên host.
Ví dụ sử dụng
- Nhắn "use atomic chat to tell me the capital of France" — agent liệt kê model rồi sinh câu trả lời bằng model cục bộ.
- "Dùng atomic_chat_generate với llama3.2-3b-instruct để tóm tắt log này" — xử lý văn bản lớn mà không tốn token API.
- Chạy
tail -f logs/nanoclaw.log | grep -i atomicđể theo dõi thời gian và số token của mỗi lần sinh.
· · · 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-atomic-chat-tool/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-atomic-chat-tool từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-atomic-chat-tool/ 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 && cp -r nanoclaw/.claude/skills/add-atomic-chat-tool ~/.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.
- Vào thư mục gốc của dự án NanoClaw (hoặc clone mới:
git clone https://github.com/nanocoai/nanoclaw.git). - Cài skill:
cp -r nanoclaw/.claude/skills/add-atomic-chat-tool ~/.claude/skills/(hoặc dùng trực tiếp.claude/skills/trong repo). - Tải và mở app Atomic Chat, vào Settings → Local API Server và bật ở cổng
1337. - Ở tab Hub tải ít nhất một model, gửi thử một tin nhắn trong UI để làm nóng model.
- Kiểm tra API:
curl -s http://127.0.0.1:1337/v1/models. - Trong Claude Code, yêu cầu: "áp dụng skill add-atomic-chat-tool" để copy file và sửa code.
- Chạy
pnpm run build, các test vitest/bun được cung cấp, rồi./container/build.sh— tất cả phải pass. - Khởi động lại service (macOS:
launchctl kickstart) và thử câu "use atomic chat..." để xác nhận.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT