Thêm kênh GitHub (NanoClaw)
Cài đặt và cấu hình adapter kênh GitHub cho NanoClaw để agent tham gia các luồng bình luận PR và issue.
Tự động hóaNâng cao★ 30,471⑂ 12,865Điểm AI 7/10Cập nhật lần cuối: 9 thg 8, 2026
Kỹ năng này làm gì
Kỹ năng gắn adapter kênh GitHub vào dự án NanoClaw, biến mỗi luồng bình luận PR/issue thành một cuộc hội thoại riêng của agent. Cụ thể:
- Sao chép
src/channels/github.tsvà file test đăng ký từ nhánhchannels - Thêm đúng một dòng import tự đăng ký vào
src/channels/index.ts - Cài
@chat-adapter/githubghim đúng phiên bản (chính sách chuỗi cung ứng cấm dải phiên bản vàlatest) - Chạy
pnpm run buildvà test đăng ký để chứng minh kênh đã có trong registry - Hỏi PAT của tài khoản bot, webhook secret, username bot rồi ghi vào
.env(chỉ ghi khi chưa có) - Hướng dẫn tạo messaging group / wiring bằng
nclvà chọnunknown_sender_policytheo repo private hay public
Mọi bước đều nằm trong khối directive nc:, idempotent nên chạy lại nhiều lần vẫn an toàn.
Phù hợp với ai
- Lập trình viên tự vận hành NanoClaw và muốn gọi agent ngay trên GitHub
- Nhóm muốn có bot thường trú trong luồng review PR
- Người vận hành cần quy trình khép kín từ
.env, webhook đến khởi động lại service
Lưu ý: chỉ dùng được trong repo NanoClaw, cần CLI ncl và service đang chạy — không dành cho người mới.
Ví dụ sử dụng
- Trợ lý review PR nội bộ: repo private dùng chính sách
public; thành viên gõ@my-org-bot tóm tắt thay đổi nàylà agent trả lời ngay trong luồng. - Phân loại issue cho repo công khai: dùng
strict, thêm maintainer tin cậy bằngncl users create --id "github:12345" --kind githubđể người lạ không tiêu tốn tài nguyên agent. - Chẩn đoán khi kênh chết: chạy
pnpm exec vitest run src/channels/github-registration.test.tsđể biết dòng import hay gói adapter đã lệch.
· · · 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/add-github từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-github/ 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/add-github ~/.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.
- Clone kho:
git clone https://github.com/nanocoai/nanoclaw.git - Chép kỹ năng vào thư mục cá nhân:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-github ~/.claude/skills/(nếu bạn làm việc ngay trong dự án NanoClaw thì đã có sẵn). - Tạo tài khoản GitHub riêng cho bot và mời làm collaborator quyền write ở các repo cần theo dõi.
- Đăng nhập bằng tài khoản bot, vào Settings → Developer Settings → Personal Access Tokens, tạo fine-grained token với quyền Pull requests (R/W) và Issues (R/W).
- Ở từng repo: Settings → Webhooks → Add webhook. Payload URL
https://ten-mien-cua-ban/webhook/github, content typeapplication/json, secret sinh bằngopenssl rand -hex 20, chọn sự kiện Issue comments và Pull request review comments. - Mở Claude Code tại thư mục gốc NanoClaw và yêu cầu "thêm kênh GitHub", hoặc chạy trong luồng
/setup. - Nhập ba giá trị được hỏi (PAT, webhook secret, username bot) — chúng sẽ được ghi vào
.env. - Kiểm tra build và test đăng ký đều xanh, sau đó tạo messaging group và wiring bằng
ncl(service phải đang chạy). - Khởi động lại service (macOS:
launchctl kickstart -k ...; Linux:systemctl --user restart ...) rồi @-mention bot trong một PR để kiểm tra.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT