TinyClaw là AI agent framework mã nguồn mở, viết bằng Bun, với kiến trúc plugin modular và Heartware Personality — engine tính cách cho phép agent có “cá tính” riêng. Dự án được thiết kế như một người bạn hữu ích, không phải công cụ vô tri. Đây là mã nguồn mở độc lập — không phải bản rút gọn của OpenClaw.

TinyClaw là gì?

Phát triển bởi Waren Gonzaga, dự án đang trong giai đoạn phát triển tích cực. Điểm đặc biệt là hệ thống Heartware Personality — engine tính cách giúp định nghĩa linh hồn cho AI agent qua SOUL.md và IDENTITY.md. Nếu bạn cần một AI agent framework thực sự có cá tính, đây là câu trả lời.

Triết lý thiết kế

Dự án được xây dựng dựa trên 8 nguyên tắc cốt lõi — phản ánh tư duy của một agent cá nhân hóa hiện đại:

Cá nhân, không doanh nghiệp — xây cho cá nhân, không phải tổ chức
Lõi nhỏ, plugin mọi thứ — kênh, provider, tool đều là plugin
Tự cải thiện — học từ mọi cuộc trò chuyện qua episodic memory
Tự cấu hình — không cần file cấu hình thủ công
Có tính cách riêng — Heartware với SOUL.md và IDENTITY.md
Xây dựng thuần từ đầu — không phụ thuộc framework AI bên ngoài
Dễ bắt đầu — dùng Ollama Cloud với hai model tích hợp sẵn
Tiết kiệm chi phí — smart routing phân luồng truy vấn theo provider

Đây không chỉ là mã nguồn mở thông thường — nó được thiết kế để tạo ra những người bạn AI thực sự có cá tính.

Kiến trúc Plugin

Kiến trúc cực kỳ modular: mọi thứ phía trên đường plugin là “tiny core”. Channels, providers và tools đều nằm dưới dạng plugin, giúp lõi giữ nguyên sự nhỏ gọn. Đây là điểm mạnh giúp framework này dễ mở rộng mà không phình to codebase.

Package cốt lõi

core — Vòng lặp agent, database, Ollama provider tích hợp sẵn
heartware — Engine tính cách + lớp an toàn — điểm khác biệt lớn nhất
memory — Bộ nhớ thích ứng episodic + FTS5
compactor — Engine nén context 4 lớp
router — Định tuyến provider thông minh 8 chiều
shield — Thực thi SHIELD.md runtime + chống malware
delegation — Điều phối sub-agent + blackboard
sandbox — Thực thi mã Bun Worker an toàn

Heartware — Engine tính cách độc đáo

Đây là tính năng độc đáo nhất — engine Heartware giúp định nghĩa cá tính cho AI agent qua hai file:

SOUL.md — Định nghĩa “linh hồn”: giá trị cốt lõi, niềm tin, mục đích tồn tại
IDENTITY.md — Định nghĩa “nhân dạng”: giọng nói, phong cách giao tiếp, sở thích, cá tính

Trong khi hầu hết mã nguồn mở chỉ tập trung vào hiệu năng, dự án này đi xa hơn: nó muốn tạo ra những agent có “trái tim”.

Các tính năng nổi bật

Tính năng	Mô tả
Smart Routing	Bộ phân loại truy vấn 8 chiều, thích ứng với provider đã cài
Context Compactor	Pipeline nén ngữ cảnh 4 lớp: nén quy tắc, khử trùng lặp, tóm tắt LLM
Bảo mật 5 lớp	Path sandbox, xác thực nội dung, audit log, tự động backup, rate limiting
SHIELD.md	Anti-malware runtime với phân tích mối đe dọa thời gian thực
Sub-agent Delegation	Điều phối sub-agent tự động với role template tự cải thiện
Bộ nhớ 3 lớp	Episodic, semantic FTS5 và temporal decay — tự biết nên nhớ và quên gì
Provider Fallback	Đa nhà cung cấp (Ollama, OpenAI, Anthropic) với tự động chuyển đổi dự phòng
Web UI	Giao diện giống Discord với SSE streaming, indicator gõ chữ

So sánh TinyClaw với các Claw khác

Tiêu chí	TinyClaw	OpenClaw	NullClaw	NanoClaw
Ngôn ngữ	TypeScript (Bun)	TypeScript	Zig	TypeScript
Kiến trúc	Plugin modular	Monolithic	Single binary	Container
Tính cách AI	Heartware (SOUL.md)	Không	AIEOS	Không
Cấu hình	Tự động (zero config)	File config	File config	Script tự động
Bộ nhớ	3 lớp (episodic + FTS5 + decay)	Vector DB	Hybrid vector/FTS5	SQLite
Sub-agent	Có (delegation system)	Có	Multi-agent	Per-group

Cài đặt

Dự án yêu cầu Bun làm runtime. Cài đặt qua:

git clone https://github.com/warengonzaga/tinyclaw.git
cd tinyclaw
bun install
bun run start

Chi tiết có thể xem trên GitHub repository. Dự án đang trong giai đoạn phát triển tích cực — “this project is in heavy development and things will break.”

Vị trí trong hệ sinh thái Claw

Đây là thành viên độc đáo nhất trong gia đình Claw Ecosystem — mỗi dự án là một mã nguồn mở AI agent với thế mạnh riêng:

OpenClaw — AI agent đa kênh TypeScript, 50+ integrations
ZeroClaw — Agent runtime Rust, single binary, 20+ LLM providers
NullClaw — AI assistant Zig 678KB, 6 lớp bảo mật
NanoClaw — Tối giản, chỉ ~3.900 dòng code, container isolation
PicoClaw — AI agent Go siêu nhẹ, dưới 10MB RAM

Xem thêm bài So sánh 6 Claw Ecosystem để có cái nhìn tổng quan.

Kết luận: TinyClaw có đáng dùng?

Sau khi tìm hiểu kỹ, mình đánh giá dự án này mang đến một làn gió mới với triết lý cá nhân hóa và có tính cách. Heartware là điểm khác biệt lớn — biến AI agent thành người bạn có cá tính. Với kiến trúc plugin modular, smart routing, và bộ nhớ 3 lớp, TinyClaw có tiềm năng trở thành framework đáng chú ý trong mảng AI agent.

Nếu bạn muốn một agent không chỉ thông minh mà còn có “cá tính”, hãy để mắt đến TinyClaw.

Bạn nghĩ sao về việc AI agent có tính cách riêng? Hữu ích hay chỉ là chiêu trò? Chia sẻ dưới phần bình luận nhé!