Claude Skill MartKhám phá skillCâu dùng ngayHọc qua videoDùng terminalSkill là gì?
 
← Về danh sách

Gỡ lỗi container NanoClaw

Hướng dẫn lần theo log và hai session DB để tìm nguyên nhân khi container agent của NanoClaw không phản hồi, lỗi xác thực hoặc sai mount.

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ì

Dựa trên kiến trúc host–container của NanoClaw (luồng tin nhắn đi qua hai DB inbound.db và outbound.db), skill chỉ rõ nên kiểm tra chỗ nào theo thứ tự.

  • Bảng vị trí log: logs/nanoclaw.error.log, logs/nanoclaw.log, log từng bước cài đặt
  • Bật LOG_LEVEL=debug để thấy cả stderr được stream từ container
  • Truy vấn messages_in / messages_out / processing_ack bằng wrapper scripts/q.ts
  • Bốn sự cố phổ biến: chạy trùng hai service làm mất tin nhắn, container thoát ngay / lỗi 401, sai mount, session treo do heartbeat cũ
  • Dùng ncl để restart group, rebuild image, xoá session
  • Script chẩn đoán nhanh 7 bước ở cuối

Phù hợp với ai

  • Người tự vận hành NanoClaw và cần tìm lý do bot Telegram/Signal đột nhiên im lặng
  • Lập trình viên muốn hiểu và đóng góp cho hệ thống chạy agent trong container
  • Người dùng đã quen Docker, SQLite, systemd/launchd

Ví dụ sử dụng

  1. "Bot không trả lời" → thấy No adapter for channel type trong error log → ps aux phát hiện hai instance → dừng và disable service cũ.
  2. "Agent báo lỗi 401" → kiểm tra gateway OneCLI rồi chạy onecli agents set-secret-mode --mode all.
  3. "Session kẹt ở trạng thái processing" → stat file .heartbeat để biết container đã chết giữa chừng → ncl groups restart.

· · · 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/debug/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)
  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.git && mkdir -p ~/.claude/skills/debug && cp -r 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à clone repo: git clone https://github.com/nanocoai/nanoclaw.git
  2. Tạo thư mục skill: mkdir -p ~/.claude/skills/debug
  3. Sao chép file: cp -r nanoclaw/.claude/skills/debug/* ~/.claude/skills/debug/
  4. Cách dùng đúng nhất là chạy Claude Code ngay trong thư mục dự án NanoClaw — khi đó skill được nạp tự động, không cần sao chép.
  5. Khởi động lại Claude Code và thử câu như "container không phản hồi" để kiểm tra skill có kích hoạt không.
  6. Yêu cầu trước: Docker đang chạy, đã cài pnpm, và có sẵn lệnh ncl, onecli thì phần lớn hướng dẫn mới hoạt động.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT