Thêm kênh Linear (NanoClaw)
Công thức cài đặt để kết nối agent NanoClaw với luồng bình luận issue trên Linear.
Tự động hóaNâng cao★ 30,573⑂ 12,843Điểm AI 7/10Cập nhật lần cuối: 20 thg 8, 2026
Làm được gì
- Lấy adapter Linear (
src/channels/linear.ts) và test đăng ký từ nhánhchannelsrồi copy vàosrc/channels/. - Thêm một dòng import self-registration vào
src/channels/index.tsvà cài@chat-adapter/linearghim đúng phiên bản (chính sách chuỗi cung ứng không cho dùng range haylatest). - Chạy
pnpm run buildvà test đăng ký để chứng minh adapter đã nằm trong registry. - Hỏi và ghi thông tin xác thực vào
.env: OAuth Client ID/Secret (khuyến nghị) hoặcLINEAR_API_KEY, webhook signing secret, team key, tên bot — không ghi đè giá trị đã có. - Dùng
ncl messaging-groups createvàncl wirings createđể nối một team Linear với agent, chế độpattern .(trả lời mọi bình luận) và sessionper-thread. - Mọi bước nằm trong khối chỉ thị
nc:nên idempotent, chạy lại an toàn; kèm phần xử lý sự cố khá đầy đủ.
Dành cho ai
- Người tự vận hành NanoClaw và dùng Linear làm issue tracker cho đội.
- Đội muốn bot tự trả lời mọi bình luận issue mà không cần @-mention (app OAuth Linear không thể được mention).
- Người dùng đã quen pnpm, vitest và quản lý service systemd/launchd.
Ví dụ sử dụng
- Đang chạy
/setupthì gọi skill này để thêm kênh Linear, xong quay lại luồng setup. - Workspace nội bộ: chọn policy
public, nối teamENGvới một agent để trả lời mọi bình luận issue. - Bot im lặng: chạy
pnpm exec vitest run src/channels/linear-registration.test.tsđể biết import barrel hay dependency bị lệch.
· · · 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/add-linear/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/add-linear từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-linear/ 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-linear ~/.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 - Copy skill vào thư mục skill của Claude:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-linear ~/.claude/skills/ - Trong thư mục gốc NanoClaw, chạy
pnpm installvà đảm bảo service host đang chạy (ncl kết nối qua Unix socket). - Trên Linear: tạo OAuth Application, sau khi tạo hãy bật grant Client credentials, rồi copy Client ID và Client Secret (hoặc chuẩn bị Personal API Key).
- Tạo webhook tại Linear Settings > API > Webhooks với URL
https://ten-mien/webhook/linear, chọn team và tick sự kiện Comment, copy signing secret. - Mở Claude Code trong thư mục dự án NanoClaw và yêu cầu: "thêm kênh Linear".
- Nhập các giá trị khi được hỏi: Client ID/Secret, webhook secret, team key (vd
ENG), tên bot, thư mục agent (ncl groups list), policypublichoặcstrict. - Khởi động lại service theo lệnh ở phần Next Steps, rồi bình luận thử trên một issue (webhook mới có thể trễ 1–5 phút).
Xem mã nguồn trên GitHub ↗Giấy phép: MIT