Migrate NanoClaw (nâng cấp bản fork)

Trích xuất các tùy chỉnh trong bản fork NanoClaw thành hướng dẫn migration rồi áp lại lên upstream sạch, tránh hoàn toàn xung đột merge.

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

Làm được gì

Khi bạn fork NanoClaw và sửa config, mã nguồn, persona hay thêm skill, mỗi lần upstream cập nhật thì git merge sẽ tạo ra hàng loạt xung đột. Skill này thay thế cách merge bằng migration theo ý định (intent-based).

Giai đoạn Extract: dùng các sub-agent (haiku) chạy song song để quét diff của bản fork, rồi sinh file hướng dẫn markdown trong .nanoclaw-migrations/ — ghi lại vừa ý định (bạn muốn gì) vừa chi tiết triển khai (đoạn code, API, đường dẫn import).
Giai đoạn Upgrade: tạo nhánh + tag backup, dựng git worktree từ upstream sạch, áp lại từng skill và từng tùy chỉnh theo hướng dẫn, chạy build/test (và test thật nếu muốn), sau đó mới swap vào cây chính và khởi động lại dịch vụ.
Tự phân loại mức độ: Tier 1 (nhẹ → gợi ý dùng /update-nanoclaw), Tier 2 (chuẩn), Tier 3 (phức tạp, có kế hoạch migration riêng).
Không bao giờ đụng vào thư mục dữ liệu: groups/, store/, data/, .env.

Phù hợp với ai

Người fork NanoClaw và tùy biến thành bot/agent riêng
Lập trình viên mệt mỏi vì giải quyết conflict mỗi lần upstream cập nhật
Ai muốn tài liệu hóa các tùy chỉnh để tái tạo trên máy khác hoặc chia sẻ cho đồng đội
Người dùng trung–cao cấp, quen git worktree, reset và quản lý dịch vụ launchd/systemd

Ví dụ sử dụng

Đổi tên trigger đơn giản: fork đổi ASSISTANT_NAME trong src/config.ts từ 'Andy' sang 'Bob' → hướng dẫn chỉ cần một dòng mô tả, và khi nâng cấp sẽ tự áp lại lên file upstream mới.
Tích hợp API bên ngoài: dịch tin nhắn ra tiếng Tây Ban Nha bằng DeepL → hướng dẫn lưu nguyên đoạn import, lời gọi translateText và dependency trong package.json, để phiên Claude mới tái tạo mà không cần xem diff gốc.
Fork có nhiều skill: đã cài add-telegram, add-slack... → một sub-agent riêng kiểm tra xung đột giữa các skill (biến khai báo trùng, cách xử lý env khác nhau) và ghi vào mục "Skill Interactions"; khi nâng cấp, từng skill được chạy lại phần apply của nó trong worktree.

· · · 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.

↓ 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-nanoclaw từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/migrate-nanoclaw/ 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/migrate-nanoclaw ~/.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 và clone kho về thư mục tạm:

git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw

Tạo thư mục skill cá nhân (bỏ qua nếu đã có):
```
mkdir -p ~/.claude/skills
```
Sao chép thư mục skill:
```
cp -r /tmp/nanoclaw/.claude/skills/migrate-nanoclaw ~/.claude/skills/
```
Lưu ý: skill này được thiết kế để chạy ngay trong .claude/skills/ của chính bản fork NanoClaw. Nếu bạn đã có bản fork, hãy chạy trực tiếp trong đó.
Chuyển vào thư mục fork cần nâng cấp và kiểm tra cây làm việc sạch:
```
cd ~/duong-dan-fork && git status
```
Tự tạo thêm một nhánh backup cho chắc:
```
git branch backup/before-migrate
```
Chạy Claude Code và yêu cầu: "Hãy migrate bản fork NanoClaw của tôi lên upstream". Skill sẽ chạy tuần tự từ Phase 0.
Đọc kỹ các câu hỏi lựa chọn (stash/commit, chọn tier, có test live không) rồi tự quyết định. Đặc biệt bước swap cuối dùng git reset --hard, hãy ghi lại tên tag backup để rollback khi cần.

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