tinyclaw

Giới thiệu

TinyClaw là một framework quản lý đội ngũ các tác nhân AI (AI Agents) có khả năng cộng tác với nhau, hoạt động bền bỉ 24/7 trong các phiên làm việc biệt lập. Dự án này giải quyết vấn đề quản lý đa tác nhân phức tạp bằng cách cung cấp môi trường chạy nền (sử dụng tmux), cho phép các AI duy trì ngữ cảnh hội thoại lâu dài và tương tác qua nhiều kênh như Discord, WhatsApp và Telegram. Đây là giải pháp lý tưởng cho việc xây dựng các trợ lý ảo chuyên biệt (coding, research, support) có thể tự động bàn giao công việc cho nhau.

Tính năng chính

• Đa tác nhân & Đa nhóm (Multi-agent/Multi-team): Chạy song song nhiều agent với vai trò chuyên biệt; hỗ trợ cơ chế agent bàn giao việc cho đồng đội (chain execution).
• Đa nền tảng (Multi-channel): Tích hợp sẵn với Discord, WhatsApp và Telegram.
• Hỗ trợ nhiều AI Provider: Sử dụng Anthropic Claude (qua Claude Code CLI) và OpenAI Codex mà không vi phạm điều khoản dịch vụ (ToS).
• Quan sát trực quan (Team Observation): Cung cấp giao diện TUI (Text User Interface) thời gian thực để theo dõi hội thoại giữa các agent.
• Hoạt động 24/7: Chạy ngầm trong tmux, đảm bảo tính sẵn sàng cao và session không bị mất khi ngắt kết nối.
• Xử lý song song: Các agent có thể xử lý tin nhắn đồng thời nhờ hàng đợi dựa trên file (File-based queue) an toàn.

Hướng dẫn cài đặt Local (macOS)

Để chạy TinyClaw trên macOS, bạn cần cài đặt các công cụ dòng lệnh cần thiết trước.

1. Cài đặt Prerequisites (Yêu cầu): Sử dụng Homebrew để cài Node.js, tmux và bash phiên bản mới:

   brew install node tmux bash
   

   Lưu ý: Cần Node.js v14+ và Bash 4.0+.

2. Cài đặt AI Provider CLI: Bạn cần cài đặt CLI của Claude Code hoặc OpenAI Codex tùy theo nhu cầu sử dụng.

3. Cài đặt TinyClaw: Cách nhanh nhất là sử dụng script cài đặt tự động:

   curl -fsSL https://raw.githubusercontent.com/jlia0/tinyclaw/main/scripts/remote-install.sh | bash
   

   Hoặc cài từ source:

   git clone https://github.com/jlia0/tinyclaw.git
   cd tinyclaw
   npm install
   ./scripts/install.sh
   

4. Khởi chạy: Chạy lệnh sau để bắt đầu trình hướng dẫn thiết lập tương tác (wizard):

   tinyclaw start
   

Hướng dẫn Docker

Hiện tại repository chưa cung cấp sẵn Dockerfile chính thức, nhưng bạn có thể tạo một Dockerfile cơ bản để chạy môi trường này. Vì TinyClaw dựa vào tmux, bạn cần một image Linux đầy đủ.

Dockerfile gợi ý:

FROM node:18-bullseye

# Cài đặt tmux và bash (đã có sẵn trong bullseye nhưng đảm bảo update)
RUN apt-get update && apt-get install -y tmux bash curl git && rm -rf /var/lib/apt/lists/*

WORKDIR /app

# Clone repo (hoặc copy từ local)
RUN git clone https://github.com/jlia0/tinyclaw.git .

# Cài đặt dependencies
RUN npm install

# Cấp quyền thực thi cho script
RUN chmod +x ./scripts/install.sh
RUN ./scripts/install.sh

# Entrypoint để giữ container chạy hoặc khởi động tinyclaw
# Lưu ý: Chạy tmux trong Docker cần xử lý TTY, thường dùng cho dev enviroment
CMD ["tail", "-f", "/dev/null"]

Lệnh Build & Run:

docker build -t tinyclaw-img .
docker run -it --name tinyclaw-instance tinyclaw-img bash
# Bên trong container, chạy: tinyclaw start

Ví dụ Code (Sử dụng CLI)

TinyClaw hoạt động chủ yếu qua giao diện dòng lệnh (CLI) và tương tác chat. Dưới đây là ví dụ về quy trình làm việc sau khi cài đặt:

1. Khởi động hệ thống:

   tinyclaw start
   # Làm theo hướng dẫn trên màn hình để kết nối tài khoản Discord/Telegram
   

2. Quan sát đội ngũ Agent làm việc: Mở một terminal khác để xem các agent ‘nói chuyện’ với nhau:

   tinyclaw team visualize
   

3. Ghép đôi người dùng (Pairing): Để cho phép một người dùng mới nhắn tin cho bot, TinyClaw sẽ tạo một mã xác thực.
   • Khi người lạ nhắn tin đến bot, bot sẽ im lặng.
   • Admin kiểm tra log/console để lấy mã pairing và gửi lại cho người đó để cấp quyền truy cập.
4. Cập nhật hệ thống:

   tinyclaw update
   

Sources

• github.com
• github.com
• github.com
• goodailist.com
• github.com
• answeroverflow.com

Github Page

https://github.com/jlia0/tinyclaw