Khởi tạo agent đầu tiên cho NanoClaw
Hướng dẫn từng bước tạo agent NanoClaw đầu tiên cho kênh DM và kiểm chứng luồ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 6/10Cập nhật lần cuối: 9 thg 8, 2026
Skill này làm gì
Skill dẫn dắt bạn qua toàn bộ quá trình dựng agent đầu tiên trong NanoClaw — runtime agent nhắn tin đa kênh.
- Đọc
src/channels/index.tsvà.envđể liệt kê các kênh đang bật, rồi hỏi bạn chọn kênh - Thu thập user ID trên kênh, tên hiển thị và tên persona của agent
- Xác định
platform_idcủa DM: kênh gửi DM lạnh được (Discord, Slack, Teams, Webex, gChat) thì bạn nhắn cho bot một lần rồi tra bảngmessaging_groups; kênh trực tiếp (Telegram, WhatsApp, iMessage, Matrix, Resend) thì dùng luôn user ID - Chạy
scripts/init-first-agent.tsđể tạo bản ghi users / agent_groups / messaging_groups và nối chúng lại, đồng thời khởi tạo thư mụcgroups/dm-with-<tên>/ - Đẩy tin nhắn chào mừng qua CLI socket của service để kiểm chứng end-to-end
- Cung cấp quy trình chẩn đoán khi tin không tới (truy vấn
outbound.db, grep log)
Mọi bước đều idempotent nên chạy lại vẫn an toàn.
Phù hợp với ai
- Người vừa cài NanoClaw và cần dựng agent đầu tiên
- Người bối rối với việc nối bot Discord/Slack/Telegram vào agent
- Người cần checklist chẩn đoán khi tin nhắn chào mừng không tới
Lưu ý: chỉ hữu ích khi bạn làm việc trong repo NanoClaw, service đang chạy và credentials kênh đã cấu hình.
Ví dụ sử dụng
- Agent Discord đầu tiên: sau khi chạy
/add-discord, gọi skill, nhắn DM cho bot một lần, xác nhậnplatform_idvà nhận tin chào mừng. - Đường pair-code Telegram: nếu không muốn nhắn trước, dùng
--step pair-telegramđể lấy mã, gửi mã trong chat Telegram và hệ thống tự gán user. - Gỡ lỗi giao tin: tin không tới trong 2 phút → kiểm tra hàng
pendingtrongoutbound.dbvà các dòngUnauthorized channel destinationtrong log để tìm lỗi ACL hoặc container.
· · · 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.
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 và clone repo:
git clone https://github.com/nanocoai/nanoclaw.git - Tạo thư mục skills nếu chưa có:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r nanoclaw/.claude/skills/init-first-agent ~/.claude/skills/- (Nếu bạn làm việc ngay trong repo NanoClaw thì skill đã có sẵn, không cần copy.)
- Cài đặt NanoClaw trước bằng lệnh
/setup, rồi kiểm tra service đang chạy (launchd trên macOS, systemd trên Linux). - Chạy skill kênh tương ứng (
/add-discord,/add-telegram, …) để nạp credentials vào.envvà bỏ comment adapter trongsrc/channels/index.ts. - Mở Claude Code tại thư mục repo NanoClaw và yêu cầu "tạo agent đầu tiên" hoặc gọi
init-first-agent. - Chờ tin nhắn chào mừng (lần đầu container khởi động ~60 giây); nếu không tới, làm theo các lệnh chẩn đoán mà skill đưa ra.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT