Claude-Mem: Bộ Nhớ Liên Tục Cho AI Agent
/claude-mem
Claude-Mem là một plugin giúp Claude Code có bộ nhớ tồn tại qua nhiều phiên làm việc, bằng cách ghi lại những gì agent đã làm, nén lại thành các bản tóm tắt, rồi trả những phần liên quan về sau. Hãy dùng nếu bạn chán việc phải giải thích lại bối cảnh dự án mỗi lần mở Claude Code; bỏ qua nếu bạn không muốn thêm một dịch vụ worker chạy nền cùng các phụ thuộc như Bun và uv vào quy trình làm việc.
Hiểu Về Mục Đích Của Claude-Mem
Claude-Mem là một hệ thống nén bộ nhớ được xây dựng cho Claude Code, có tài liệu hỗ trợ thêm OpenClaw, Codex, Gemini, Hermes, Copilot và OpenCode. Nó chạy năm hook vòng đời quanh mỗi phiên làm việc, lưu các ghi nhận và bản tóm tắt vào một cơ sở dữ liệu SQLite cục bộ, và thêm một cơ sở dữ liệu vector Chroma bên trên để tìm kiếm theo ngữ nghĩa trên các phiên trước đó.
Tính Năng Cốt Lõi
- ✓Năm hook vòng đời (SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd, trải trên sáu hook script) ghi lại những gì xảy ra trong phiên làm việc ngay khi nó diễn ra.
- ✓Một dịch vụ worker, do Bun quản lý, chạy một HTTP API cục bộ cùng giao diện xem trực tiếp hiển thị luồng ghi nhận tại URL được in ra khi khởi động.
- ✓Các ghi nhận và bản tóm tắt được lưu trong một cơ sở dữ liệu SQLite; một cơ sở dữ liệu vector Chroma bổ sung tìm kiếm theo ngữ nghĩa bên trên tìm kiếm theo từ khoá thông thường.
- ✓Skill mem-search cùng 4 công cụ MCP (search, timeline, get_observations) hoạt động theo mô hình 3 lớp mà README nói giúp giảm chi phí token khoảng 10 lần so với lấy toàn bộ chi tiết cho mọi kết quả.
- ✓Thẻ `<private>` đánh dấu nội dung để loại hoàn toàn khỏi việc lưu trữ, theo tính năng kiểm soát quyền riêng tư mà README mô tả.
- ✓CLAUDE_MEM_MODE đặt cả kiểu làm việc (code, chill, investigation) lẫn ngôn ngữ ghi lại các quan sát; chế độ tiếng Trung giản thể (code--zh) đã có sẵn.
- ✓Cloud Sync sao lưu bộ nhớ lên cmem.ai; README mô tả tính năng này không cần daemon, worker tự đồng bộ ngay khi ghi dữ liệu.
Bắt Đầu Với Claude-Mem
Chạy một lệnh duy nhất: `npx claude-mem install`. Với OpenCode là `npx claude-mem install --ide opencode`; với Antigravity CLI là `npx claude-mem install --ide antigravity` (README có link riêng tới hướng dẫn cài đặt cho trường hợp này). Ngay trong Claude Code, bạn cũng có thể thêm plugin marketplace bằng `/plugin marketplace add thedotmack/claude-mem` rồi `/plugin install claude-mem`, sau đó khởi động lại Claude Code để ngữ cảnh từ phiên trước tự động xuất hiện. Trên một OpenClaw gateway, trình cài đặt là `curl -fsSL https://install.cmem.ai/openclaw.sh | bash`, README nói lệnh này còn thiết lập cấu hình nhà cung cấp AI và khởi động worker. Một điểm cần lưu ý: `npm install -g claude-mem` chỉ tải về SDK/thư viện — README khuyên luôn cài qua `npx claude-mem install` hoặc các lệnh `/plugin` ngay trong ứng dụng, vì lệnh cài npm toàn cục bỏ qua hook của plugin và worker.
Sử Dụng Bộ Nhớ Agent
Ngày qua ngày, Claude-Mem không cần bạn tự tay kích hoạt điều gì; README mô tả các hook tự chạy toàn bộ chu trình ghi nhận và tóm tắt. Khi cần tìm lại điều gì cụ thể, skill mem-search cùng các công cụ MCP của nó đi theo 3 bước: `search` trả về một chỉ mục gọn (README ước tính khoảng 50-100 token mỗi kết quả), công cụ `timeline` sắp xếp các sự kiện phiên làm việc gần đó quanh kết quả bạn để ý, còn `get_observations` chỉ lấy bản ghi đầy đủ cho những ID bạn đã chọn, theo lô thay vì từng cái một. Giao diện web viewer riêng của worker cho phép bạn xem luồng quan sát trực tiếp và tra cứu trích dẫn theo ID, còn đánh dấu nội dung nhạy cảm bằng thẻ `<private>` sẽ giữ nó khỏi bị lưu lại ngay từ đầu.
Điểm mạnh
- ✓Tự vận hành sau khi cài đặt — các hook vòng đời xử lý việc ghi nhận và đưa ngữ cảnh vào mà không cần bước lưu thủ công.
- ✓Đường tìm kiếm nhiều lớp (search, rồi timeline, rồi get_observations) mà README nói giúp giảm chi phí token khoảng 10 lần so với lấy toàn bộ chi tiết.
- ✓Bao phủ nhiều môi trường agent khác nhau: phần mô tả của repo liệt kê Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, và OpenCode.
- ✓Thẻ `<private>` cho một cách loại trừ cụ thể với nội dung nhạy cảm, thay vì chỉ có công tắc bật/tắt toàn bộ.
- ✓Cấp phép theo Apache-2.0, được README nói là chọn để hệ thống bộ nhớ này dễ nhúng vào các công cụ và agent harness khác.
- ✓Có giao diện web viewer ngay tại URL riêng của worker, để bạn thấy được những gì đang được ghi lại thay vì phải tin vào một hộp đen.
Yêu Cầu Hệ Thống Và Lưu Ý
- △README không nêu số phiên bản hay ngày phát hành, nên không có tín hiệu tài liệu nào về mức độ trưởng thành của bản hiện tại.
- △Chạy Claude-Mem kéo theo một dịch vụ worker chạy nền cùng Bun và uv được tự động cài thêm, nhiều thành phần hơn một plugin chỉ đọc file cục bộ.
- △`npm install -g claude-mem` trông như đường cài đặt hiển nhiên nhưng chỉ dựng SDK, không có hook của plugin hay worker — một cái bẫy mà README nói rõ.
- △Hai trong ba nhánh phát hành, core-dev và community-edge, chạy từ mã nguồn thay vì được publish lên npm, nên theo dõi chúng nghĩa là phải tự build.
- △Các chế độ ghi quan sát bằng ngôn ngữ khác ngoài tiếng Anh chỉ có sẵn cho tiếng Trung và tiếng Nhật (code--zh, code--ja); chưa có ngôn ngữ nào khác được liệt kê là dùng ngay được.
- △Tìm kiếm theo ngữ nghĩa dựa vào cơ sở dữ liệu vector Chroma và trình quản lý gói uv của Python chạy song song với stack Node/Bun, nhiều hạ tầng hơn một công cụ chỉ chạy trên một runtime.
Các Công Cụ Bộ Nhớ AI Khác
Câu Hỏi Thường Gặp
Claude-Mem được phát hành theo giấy phép Apache License 2.0, một giấy phép cởi mở cho phép sử dụng thương mại, kể cả trong sản phẩm độc quyền.
Phần mô tả trên GitHub của Claude-Mem liệt kê Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, và OpenCode, với hướng dẫn cài đặt riêng cho Claude Code, OpenCode, Antigravity CLI, và OpenClaw gateway.
Chạy `npx claude-mem install`, hoặc trong Claude Code dùng `/plugin marketplace add thedotmack/claude-mem` rồi `/plugin install claude-mem`, sau đó khởi động lại Claude Code.
Tính năng Cloud Sync của Claude-Mem sao lưu bộ nhớ lên cmem.ai; README mô tả tính năng này không cần daemon, worker tự đồng bộ ngay khi ghi dữ liệu thay vì chạy một tiến trình nền riêng.
Claude-Mem hỗ trợ thẻ `<private>` để loại nội dung được đánh dấu khỏi việc lưu trữ hoàn toàn, đây là tính năng kiểm soát quyền riêng tư mà README ghi rõ.
Claude-Mem cần Node.js 20.0.0 trở lên và một bản Claude Code đủ mới có hỗ trợ plugin; Bun, uv, và SQLite 3 nằm bên dưới, với Bun và uv tự cài nếu thiếu.
Vấn đề Claude-Mem giải quyết
Ngữ cảnh của một AI coding agent bị xoá ngay khi phiên làm việc kết thúc hoặc cửa sổ ngữ cảnh đầy, nên phiên tiếp theo không biết gì về những quyết định đã đưa ra một giờ hay một tuần trước đó. Cách Claude-Mem tự mô tả là nó ghi lại những gì agent đã làm, nén lại, rồi tự động trả những phần hữu ích vào lần sau, thay vì bạn phải dán lại ghi chú hay kể lại lịch sử codebase mỗi khi mở phiên Claude Code mới.
Trường hợp sử dụng tốt nhất
- •Các phiên làm việc kéo dài nhiều ngày trong Claude Code, nơi bạn không muốn giải thích lại lịch sử dự án mỗi sáng.
- •Các nhóm chạy Claude Code song song với OpenClaw, Codex, Gemini, Hermes, Copilot, hoặc OpenCode, muốn có một lớp bộ nhớ dùng chung thay vì ngữ cảnh riêng cho từng agent.
- •Thiết lập OpenClaw gateway muốn đẩy luồng quan sát ra Telegram, Discord, hoặc Slack, theo phần trình cài đặt gateway của README.
- •Tra lại lịch sử dự án của bạn bằng ngôn ngữ tự nhiên qua skill mem-search thay vì cuộn lại các phiên cũ.
Ai nên dùng — và ai nên bỏ qua
Hãy thử Claude-Mem nếu bạn dùng Claude Code, hoặc một trong OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode, cho các dự án trải dài nhiều phiên làm việc và chán việc nhắc lại ngữ cảnh, đồng thời không ngại có thêm một worker chạy cùng Bun và uv bên cạnh editor. Bỏ qua nếu bạn muốn một plugin gọn nhẹ, không phụ thuộc, thay vì một dịch vụ worker với file cấu hình riêng, hoặc bạn vẫn ổn với việc tự ghi chú dự án bằng tay.
Repo liên quan
claude-mem có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về claude-mem.