Khởi tạo agent NanoClaw đầu tiên
Hướng dẫn tạo agent NanoClaw đầu tiên cho kênh DM và kiểm chứng đường gửi tin bằng một tin nhắn chào mừng.
Tự động hóaNâ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ò các kênh đang bật trong
src/channels/index.tsvà.env(Discord, Slack, Telegram, WhatsApp, Teams, Matrix...) rồi cho bạn chọn kênh đặt agent đầu tiên. - Xác định
platform_idcho DM: kênh không hỗ trợ cold DM thì dùng trực tiếp user id; Discord/Slack/Teams thì yêu cầu bạn DM bot một lần rồi truy vấn bảngmessaging_groups; Telegram có thêm luồng mã ghép đôi (pair code). - Chạy
scripts/init-first-agent.tsđể upsert user, cấp quyền owner nếu chưa có, tạoagent_groups, khởi tạo filesystem của group, nốimessaging_group_agentsvà đẩy tin chào mừng qua CLI socket của service đang chạy — tất cả đều idempotent. - Cung cấp lệnh chẩn đoán cụ thể khi tin nhắn không đến: kiểm tra
outbound.db, grep log tìm lỗi ACL hoặc container crash.
Phù hợp với ai
- Người tự vận hành NanoClaw và đang cấu hình lần đầu.
- Người đã nạp credential kênh nhưng chưa rõ cách liên kết agent với messaging group.
- Người cần quy trình debug dựa trên DB/log thay vì đoán mò.
Ví dụ sử dụng
- Sau
/setupvà/add-discord: chọn Discord, DM bot một lần, chọn đúng platform_id, nhận DM chào mừng. - Với Telegram: phát mã ghép đôi bằng
--step pair-telegram, gửi mã trong chat để tự động tạo user và cấp owner. - Khi DM không tới sau 2 phút: xem hàng
pendingtrongoutbound.dbvà logUnauthorized channel destinationđể biết là lỗi phân quyền hay container chết.
· · · 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/init-first-agent/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/init-first-agent từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/init-first-agent/ 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/init-first-agent ~/.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 - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy skill:
cp -r nanoclaw/.claude/skills/init-first-agent ~/.claude/skills/- Vì skill phụ thuộc vào script trong repo, cách chắc ăn nhất là
cd nanoclawvà chạy Claude Code ngay trong repo đó.
- Vì skill phụ thuộc vào script trong repo, cách chắc ăn nhất là
- Chuẩn bị điều kiện: chạy
/setupđể service hoạt động, dùng/add-<kênh>để nạp credential, bỏ comment adapter trongsrc/channels/index.ts. - Mở Claude Code và yêu cầu: "Khởi tạo agent NanoClaw đầu tiên cho tôi".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT