Thêm kênh Matrix (NanoClaw)
Kỹ năng sao chép, đăng ký và cấu hình adapter Matrix cho dự án NanoClaw, kèm hướng dẫn tạo tài khoản bot.
Lập trìnhTrung cấp★ 30,520⑂ 12,857Điểm AI 7/10Cập nhật lần cuối: 16 thg 8, 2026
Làm được gì
- Lấy adapter Matrix (
src/channels/matrix.tsvà test đăng ký) từ nhánhchannelsvà sao chép vào dự án. - Thêm một dòng import tự đăng ký vào
src/channels/index.ts, cài@beeper/chat-adapter-matrixvới phiên bản ghim chính xác. - Vá lỗi thiếu đuôi
.jstrong importmatrix-js-sdk/lib/...(gây lỗi ESM trên Node 22), rồi build và chạy test đăng ký để xác nhận. - Hướng dẫn tạo tài khoản bot Matrix và ghi biến môi trường cho hai cách xác thực: mật khẩu hoặc access token.
- Mọi bước đều idempotent nên chạy lại nhiều lần vẫn an toàn.
Phù hợp với ai
- Người tự vận hành NanoClaw và muốn nói chuyện với agent qua Matrix/Element hoặc homeserver riêng.
- Kỹ sư làm việc trên repo pnpm/TypeScript cần lặp lại quy trình cấu hình kênh chat.
- Người muốn xử lý các tùy chọn đặc thù của Matrix (E2EE, tự động chấp nhận lời mời) theo quy trình rõ ràng.
Ví dụ sử dụng
- Đang chạy
/setup, chọn Matrix → kỹ năng thực hiện tuần tự từ sao chép adapter đến build và test. - Build lỗi
ERR_MODULE_NOT_FOUND matrix-js-sdk/lib/...sau khipnpm install→ chạy lại bước vá ESM (bước 4). - Bot không vào phòng → dùng phần Troubleshooting để kiểm tra
MATRIX_INVITE_AUTOJOIN_ALLOWLISTcó chứa user ID của bạn.
· · · 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-matrix/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-matrix từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-matrix/ 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-matrix ~/.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à vào thư mục làm việc của bạn.
- Clone repo:
git clone https://github.com/nanocoai/nanoclaw.git - Tạo thư mục kỹ năng:
mkdir -p ~/.claude/skills - Sao chép kỹ năng:
cp -r nanoclaw/.claude/skills/add-matrix ~/.claude/skills/ - Kỹ năng chỉ hoạt động trong dự án NanoClaw, nên chạy
cd nanoclaw && pnpm install. - Mở Claude Code ngay trong thư mục nanoclaw và yêu cầu "thêm kênh Matrix" để kích hoạt kỹ năng.
- Nên tạo trước một tài khoản bot riêng tại app.element.io (Matrix không cho DM chính mình) để bước cấu hình thông tin đăng nhập diễn ra suôn sẻ.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT