Hoàn tất di trú NanoClaw v1 → v2

Hướng dẫn Claude xử lý phần cần phán đoán của con người sau khi chạy `migrate-v2.sh`: gán owner, chuyển bộ nhớ cũ, đối chiếu container và xử lý code fork.

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ì

Đọc logs/setup-migration/handoff.json trước tiên để phân loại kết quả từng bước và các việc còn treo.
Nếu chưa chạy script, skill dừng lại và yêu cầu bạn chạy bash migrate-v2.sh trong terminal (không mô phỏng, không làm giữa dòng).
Phase 0: kiểm tra thực tế bot v2 có trả lời tin nhắn trên kênh thật. Phase 1: truy vấn users, xác nhận ID dạng telegram:<id> / whatsapp:<phone>@s.whatsapp.net, cấp role owner bằng grantRole, chọn unknown_sender_policy (public/strict/request_approval) và nhập danh sách người gửi từ DB v1.
Phase 2–4: chạy /migrate-memory cho bộ nhớ cũ, kiểm tra additionalMounts trong container.json, phân loại commit fork (chỉ copy skills/docs, còn src/* lưu tham khảo).
Kết thúc bằng pnpm exec tsx setup/index.ts --step verify và restart service theo label suy ra từ src/install-slug.ts.

Dành cho ai

Người đang chạy NanoClaw v1 và muốn nâng lên v2.
Người đã fork v1 và tự thêm skill, tài liệu, cấu hình container.
Người quản trị bot Telegram/Discord/WhatsApp/Slack muốn siết lại chính sách truy cập.

Ví dụ sử dụng

"Hoàn tất migration v1" → đọc handoff.json, chỉ sửa lỗi chặn định tuyến, rồi nhờ bạn gửi tin nhắn thử.
"Đặt tôi làm owner" → liệt kê bảng users, xác nhận đúng người và cấp role owner một cách idempotent.
"Code tôi sửa ở v1 thì sao?" → hiện git log upstream/main..HEAD, copy phần portable và cất source vào docs/v1-fork-reference/.

· · · 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/migrate-from-v1/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.

↓ 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/migrate-from-v1 từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/migrate-from-v1/ 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/migrate-from-v1 ~/.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.
Clone repo: git clone https://github.com/nanocoai/nanoclaw.git
Nếu bạn đã dùng repo NanoClaw v2, skill có sẵn tại .claude/skills/migrate-from-v1, không cần cài thêm.
Muốn dùng toàn cục: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-v1 ~/.claude/skills/
Quan trọng: chạy bash migrate-v2.sh trong terminal trước (cần prompt tương tác, Docker, pnpm).
Sau khi script xong, mở Claude Code trong thư mục dự án và yêu cầu "finish v1 migration".
Vì skill ghi vào DB và restart service, hãy sao lưu data/ và .env trước.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT