README_VI.md

✨ OpenSpace: Biến Agent của bạn thành Thông Minh, Chi Phí Thấp, Tự Tiến Hóa ✨

| 🔋 46% Token ít hơn | 💰 $11K kiếm được trong 6 giờ | 🧬 Skills Tự Tiến Hóa | 🌐 Agents Chia Sẻ Kinh Nghiệm | 🧠 Cross-Session Memory (OpenViking) |

Một Lệnh Để Tiến Hóa Mọi AI Agent Của Bạn: OpenClaw, nanobot, Claude Code, Codex, Cursor và v.v.

---

📢 Tin tức

• 2026-04-11 🛡️ OpenViking Round 6 — universal access + privacy hardening. Năm upgrade đóng các gap của integration ban đầu: (1) 5 MCP tools trực tiếp cho host agents (openviking_retrieve_memory, remember, forget_memory, report_stale_memory, memory_status) để Claude Code/Codex/OpenClaw/... có thể access cross-session memory mà không cần delegate full task; (2) mid-iteration retrieve_memory tool grounding agent gọi dynamically khi bí; (3) negative feedback + anti-patterns — failures trở thành AVOID warnings cho tasks tương lai; (4) regex PII scrubber (API keys, JWTs, emails, credit cards) default BẬT; (5) OPENVIKING_MIN_SCORE quality threshold. 63 tests passing. Chi tiết trong docs/openviking/.
• 2026-04-11 🧠 Tích hợp OpenViking — lớp cross-session memory. OpenSpace giờ enrich skill selection, grounding execution, và post-run analysis bằng trí tuệ xuyên phiên từ OpenViking, và push evolved skills ngược lại như structured resources. Multi-team namespace isolation, per-user memory scoping, và privacy opt-out qua OPENVIKING_PUSH_SKILLS. Hoàn toàn graceful khi Viking offline — zero rủi ro regression. Xem docs/openviking/ cho kiến trúc đầy đủ, phân tích token economics, và deployment guide.
• 2026-04-09 💬 Communication gateway đa kênh. OpenSpace giờ có thể nhận và phản hồi messages từ external platforms. Ship với adapters WhatsApp (Baileys bridge + QR auth) và Feishu (HTTP webhook), session management, attachment caching, và allowlist-based access control.
• 2026-04-03 🚀 Released v0.1.0 — Skill quality monitoring.
• 2026-03-25 🎉 OpenSpace open source!

Đầy đủ news: README.md

---

Vấn đề với AI Agents hiện nay

Các AI agents hiện tại — OpenClaw, nanobot, Claude Code, Codex, Cursor, v.v. — mạnh mẽ, nhưng có một điểm yếu critical: chúng không bao giờ Học, Thích nghi, và Tiến hóa từ kinh nghiệm thực tế — chứ đừng nói đến Chia sẻ với nhau.

• ❌ Lãng phí Token Khổng lồ — Làm sao reuse successful task patterns thay vì reasoning từ đầu và đốt tokens mỗi lần?
• ❌ Lặp lại các Failures đắt giá — Làm sao chia sẻ solutions across agents thay vì lặp lại cùng exploration và mistakes đắt giá?
• ❌ Skills Tệ và Không đáng tin — Làm sao maintain skill reliability khi tools và APIs tiến hóa — đồng thời đảm bảo community-contributed skills đáp ứng tiêu chuẩn chất lượng nghiêm ngặt?

🎯 OpenSpace là gì?

🚀 🚀 Engine tự tiến hóa nơi mỗi task làm mọi agent thông minh hơn và tiết kiệm chi phí hơn.

OpenSpace plug vào bất kỳ agent nào như skills và tiến hóa nó với bốn siêu năng lực:

🧬 Tự Tiến Hóa (Self-Evolution)

Skills học và tự cải tiến tự động:

• ✅ AUTO-FIX — Khi một skill bị break, nó tự fix ngay lập tức
• ✅ AUTO-IMPROVE — Successful patterns trở thành versions skill tốt hơn
• ✅ AUTO-LEARN — Capture winning workflows từ sử dụng thực tế
• ✅ Quality monitoring — Track skill performance, error rates, và execution success

🌐 Trí Tuệ Tập Thể của Agents (Collective Intelligence)

Biến các agents cá nhân thành một brain chung:

• ✅ Shared evolution: Một cải tiến của agent trở thành upgrade của mọi agent
• ✅ Network effects: Càng nhiều agents → data phong phú hơn → evolution nhanh hơn cho mọi agent
• ✅ Easy sharing — Upload và download evolved skills với một lệnh đơn giản
• ✅ Access control — Chọn public, private, hoặc team-only access cho mỗi skill

💰 Hiệu Quả Token

Agents thông minh hơn, chi phí thấp hơn dramatically:

• ✅ Stop repeating work → Reuse successful solutions thay vì bắt đầu từ zero mỗi lần
• ✅ Tasks get cheaper → Khi skills cải tiến, similar work tốn ít hơn dần
• ✅ Small updates only → Fix cái gì broken, không rebuild tất cả
• ✅ Real savings: 4.2× hiệu suất tốt hơn với 46% tokens ít hơn trên real-world tasks (GDPVal)

🧠 Cross-Session Memory (OpenViking — MỚI)

Đóng khoảng trống học lại giữa các tasks:

• ✅ User preferences tồn tại — "Alice prefer bar charts" đúng vào thứ Ba và thứ Tư, không cần re-prompt
• ✅ Tool knowledge tích lũy — "chromedriver 124 cần Chrome 124+" học một lần, sẵn sàng cho mọi agent trong team mãi mãi
• ✅ Past cases resurface — Tasks tương tự tuần trước surface như hints, short-circuit 2–4 exploration iterations
• ✅ Cross-agent propagation — Fix vất vả của Agent A trở thành knowledge khởi đầu của Agent B, tự động, qua shared team Viking server

---

🧠 Tích hợp OpenViking — Cross-Session Memory

OpenSpace đã làm agents thông minh trong một task đơn lẻ. Tích hợp OpenViking mở rộng trí tuệ đó xuyên tasks, users, và machines — đóng khoảng trống "relearn gap" nơi mỗi session mới bắt đầu từ zero.

Kinh tế học Token (compound với 46% reduction hiện có của OpenSpace)

Scenario	Token reduction vs baseline
Cold start (task mới, không memory)	0% — zero overhead
Warm cache (task prior tương tự)	25–40% thêm trên đỉnh OpenSpace
Tránh Phase 2 (selector chọn đúng skill ngay lần đầu)	~55% thêm
Cross-agent propagation (Agent B hưởng lợi từ Agent A)	30–45% thêm

Kết hợp với self-evolution của OpenSpace: teams realistic đo được 55–65% tokens ít hơn vs baseline (non-OpenSpace) agent sau tuần đầu sử dụng.

Privacy by design

• Agent memories (tool knowledge, patterns, cases) → shared trong team
• User memories (preferences, profile) → isolated per user qua OPENVIKING_USER_ID
• Skill content push → opt-out qua OPENVIKING_PUSH_SKILLS=false cho privacy-sensitive deployments
• Namespace scoping → multi-team isolation qua OPENVIKING_NAMESPACE (không bao giờ auto-derive — tường minh by design)

Failure mode

OpenViking server down? OpenSpace chạy y hệt như trước. Mọi Viking call là best-effort, guard bởi is_available() health checks với cache two-tier. Timeout default 5s. 30 tests verify graceful degradation cho mọi failure path.

Observability built in

Mỗi execute() return một viking dict trong result:

result["viking"] == {
    "enabled": True, "available": True,
    "hit_counts": {"tool_hints": 3, "user_preferences": 1, ...},
    "enrichment_chars": 1243,
    "feedback_status": "committed",
    "pushed_skills": 1,
}

Cộng với một dòng log mỗi task cho dashboard grep: Viking telemetry: available=True hits=9 ....

Quick start

# Chạy OpenViking local
docker run -d -p 1933:1933 volcengine/openviking:latest

# Enable trong OpenSpace
export OPENVIKING_ENABLED=true
openspace --query "task của bạn"

Documentation đầy đủ:

Chủ đề	Tiếng Việt	English	中文
Index + Triết lý	README_VI.md	README.md	README_CN.md
Kiến trúc	architecture_VI.md	architecture.md	architecture_CN.md
Kinh tế học Token	token-economics_VI.md	token-economics.md	token-economics_CN.md
Cấu hình	configuration_VI.md	configuration.md	configuration_CN.md
Vận hành	operations_VI.md	operations.md	operations_CN.md

---

⚡ Quick Start

Cài đặt

# Clone repo
git clone https://github.com/HKUDS/OpenSpace.git
cd OpenSpace

# Install dependencies
pip install -r requirements.txt

# Set up credentials
cp openspace/.env.example openspace/.env
# Edit .env với OPENROUTER_API_KEY hoặc provider key khác

Chạy task đầu tiên

openspace --query "analyze sales.xlsx and create a summary dashboard"

(Tùy chọn) Bật OpenViking cho cross-session memory

# Start OpenViking server
docker run -d -p 1933:1933 volcengine/openviking:latest

# Enable integration
export OPENVIKING_ENABLED=true

# Run task — lần đầu chỉ prime memory base
openspace --query "your task"

# Run task tương tự — giờ hưởng lợi từ extracted memories
openspace --query "similar task"

Xem README.md cho Quick Start đầy đủ với các ví dụ MCP, integration agent, và advanced configuration.

---

📋 Table of Contents (README tiếng Anh)

Để có documentation toàn diện — benchmark results, architecture diagrams, integration guides với Claude Code / Codex / OpenClaw, skill development guide, và showcase examples — xem README.md tiếng Anh.

Các section chính:

• Benchmark: GDPVal — 4.2× hiệu suất tốt hơn, 46% tokens ít hơn
• Framework Architecture — Two-phase execution, skill engine, evolution triggers
• Advanced Configuration — Model selection, backend scope, workspace management
• Showcase: My Daily Monitor — Real-world agent dashboard use case

---

🔗 Related Projects

OpenSpace xây dựng trên các open-source projects sau. Chúng tôi chân thành cảm ơn các tác giả và contributors:

• OpenViking — Context Database for AI Agents bởi Volcano Engine, powering lớp cross-session memory của OpenSpace
• AnyTool — Plug-and-play universal tool-use layer cho bất kỳ AI agent
• ClawWork — Biến AI assistants thành true AI coworkers
• WorldMonitor — Real-time global intelligence dashboard

---

👤 Về tác giả

Nguyễn Ngọc Tuấn Founder & CEO — Transform Group · Lark Platinum Partner

Người xây dựng OpenSpace × OpenViking integration được document ở trên. Integration này mang cross-session memory đến self-evolution engine của OpenSpace, biến "một agent học, mọi agents hưởng lợi" từ slogan thành feedback loop tự động, toàn-team.

Kết nối: facebook.com/khongphaituan

---

🤝 Contribute & Roadmap

Chào đón contributions! Xem README.md cho roadmap chi tiết và contribution guidelines.

📄 License

MIT License. Xem LICENSE.

---

🧬 Làm Agent Tự Tiến Hóa · 🌐 Một Cộng Đồng Cùng Phát Triển · 💰 Ít Tokens Hơn, Agents Thông Minh Hơn