Tích hợp kênh Matrix (add-matrix)

Skill cài đặt adapter Matrix vào dự án NanoClaw: sao chép mã, đăng ký kênh, ghim phiên bản và cấu hình tài khoản bot.

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

Skill này làm gì

Thêm kênh chat Matrix vào runtime agent NanoClaw. Vì nhánh trunk không kèm mã kênh, skill kéo adapter Matrix từ nhánh channels rồi thực hiện tuần tự:

Sao chép src/channels/matrix.ts và file test đăng ký
Thêm một dòng import './matrix.js'; vào barrel src/channels/index.ts
Cài @beeper/chat-adapter-matrix với phiên bản ghim chính xác (chính sách chuỗi cung ứng cấm dải phiên bản và latest)
Vá import ESM của matrix-js-sdk (thêm đuôi .js) để chạy được trên Node 22
Chạy pnpm run build và test đăng ký để xác minh
Hướng dẫn tạo tài khoản bot và ghi các biến MATRIX_* vào .env

Mọi bước đều được đánh dấu bằng directive nc:, idempotent nên chạy lại nhiều lần vẫn an toàn.

Phù hợp với ai

Người dùng NanoClaw muốn trò chuyện với agent qua Matrix thay vì Slack/Discord
Đội nhóm tự vận hành homeserver (Synapse) hoặc dùng matrix.org
Lập trình viên thích quy trình cài đặt tái lập được, mô tả bằng một tài liệu duy nhất

Lưu ý: skill gắn chặt với cấu trúc repo NanoClaw, khó tái sử dụng cho dự án khác.

Ví dụ sử dụng

Thiết lập lần đầu: yêu cầu "dùng skill add-matrix để bật kênh Matrix" — agent sao chép adapter, cài dependency, hỏi URL homeserver, user ID bot, tên hiển thị rồi ghi vào .env.
Sửa lỗi sau khi pnpm install: gặp ERR_MODULE_NOT_FOUND với matrix-js-sdk/lib/... thì chạy lại bước vá ESM (bước 4) là xong.
Bot không vào phòng: kiểm tra MATRIX_INVITE_AUTOJOIN_ALLOWLIST có chứa user ID của bạn không, theo mục Troubleshooting.

· · · 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.

↓ Tải ZIP

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à clone repo: git clone https://github.com/nanocoai/nanoclaw.git
Tạo thư mục skill: mkdir -p ~/.claude/skills
Sao chép skill: cp -r nanoclaw/.claude/skills/add-matrix ~/.claude/skills/
Chuyển vào thư mục dự án: cd nanoclaw (skill chỉ chạy đúng bên trong repo này).
Vào app.element.io tạo tài khoản Matrix riêng cho bot (không dùng tài khoản cá nhân) và ghi lại user ID dạng @andybot:matrix.org.
Mở Claude Code và nói: "Dùng skill add-matrix để thêm kênh Matrix".
Nhập các giá trị được hỏi (URL homeserver, user ID bot, tên hiển thị, mật khẩu hoặc access token) — chúng sẽ được ghi vào .env.
Kiểm tra pnpm run build và pnpm exec vitest run src/channels/matrix-registration.test.ts đều xanh, sau đó chạy /manage-channels để gắn kênh vào nhóm agent.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT