Claude Skill MartKhám phá skillSkill là gì?
 
← Về danh sách

Gỡ lỗi container NanoClaw

Hướng dẫn chẩn đoán theo từng bước cho log, session DB, mount và lỗi xác thực của hệ thống agent container NanoClaw.

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

Kỹ năng này làm gì

Đây là cẩm nang gỡ lỗi chuyên dụng cho hệ thống chạy agent trong container của NanoClaw. Nó mô tả kiến trúc hai session DB (inbound.db, outbound.db) — kênh giao tiếp duy nhất giữa host (Node) và container (Bun) — và chỉ cách dùng vài câu SQL để xác định luồng tin nhắn đứt ở đâu.

  • Sơ đồ kiến trúc và danh sách mount (/workspace, /home/node/.claude, /app/src)
  • Bảng vị trí log (lỗi host, log ứng dụng, log cài đặt) và cách bật LOG_LEVEL=debug
  • Bốn sự cố thường gặp: mất tin nhắn do chạy trùng hai service, container thoát ngay lập tức, sai mount, session treo do heartbeat cũ
  • Lệnh khởi động lại container, build lại image, xóa session và một script chẩn đoán nhanh

Phù hợp với ai

  • Người đang vận hành hoặc fork dự án NanoClaw
  • Lập trình viên muốn tham khảo mẫu xử lý sự cố cho kiến trúc agent chạy cách ly bằng container
  • Kỹ sư quen với Docker, systemd và truy vấn SQLite

Ví dụ sử dụng

  1. "Bot không trả lời nữa" → kỹ năng lần lượt truy vấn messages_in rồi messages_out để phân biệt lỗi định tuyến, lỗi agent hay lỗi khâu gửi đi.
  2. "API trả về 401" → kiểm tra secretMode của OneCLI gateway và sửa bằng onecli agents set-secret-mode --mode all.
  3. "Session kẹt ở trạng thái processing" → xem mtime của .heartbeat để biết container đã chết giữa chừng, rồi chạy ncl groups restart.

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

Cài vào ứng dụng Claude (không cần terminal)
  1. Tải tệp ZIP bằng nút bên dưới.
  2. Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
  3. 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/debug từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/debug/ 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 /tmp/nanoclaw && mkdir -p ~/.claude/skills/debug && cp -r /tmp/nanoclaw/.claude/skills/debug/* ~/.claude/skills/debug/

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

  1. Mở terminal và chuyển tới thư mục làm việc của bạn.
  2. Tải mã nguồn: git clone https://github.com/nanocoai/nanoclaw
  3. Tạo thư mục kỹ năng: mkdir -p ~/.claude/skills/debug
  4. Sao chép tệp: cp -r nanoclaw/.claude/skills/debug/* ~/.claude/skills/debug/
  5. Khởi động lại Claude Code, rồi nói ví dụ "container không phản hồi, giúp tôi gỡ lỗi".
  6. Kỹ năng hoạt động tốt nhất khi bạn đứng trong repo NanoClaw; hãy chắc chắn đã có Docker, pnpm và CLI ncl.
  7. Các lệnh như rm -rf data/v2-sessions/... hay systemctl --user stop là không thể hoàn tác — kiểm tra kỹ đường dẫn và tên service trước khi chạy.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT