Hướng dẫn OpenClaw v2026.3.22: 45 tính năng mới + 13 breaking changes bạn cần biết
Hướng dẫn OpenClaw v2026.3.22: 45 tính năng mới + 13 breaking changes bạn cần biết
Cập nhật lần cuối: 9 tháng 6, 2026
Bạn có nên nâng cấp lên OpenClaw v2026.3.22? Trả lời ngắn: có, nhưng hãy chạy openclaw doctor --fix ngay sau khi nâng cấp. Bản phát hành này mang ClawHub skills marketplace bản địa, timeout agent 48 giờ (trước đây 10 phút) và sandbox cắm được (SSH + OpenShell), đồng thời gỡ thư mục legacy .moltbot cùng biến môi trường CLAWDBOT_* / MOLTBOT_* — doctor --fix tự xử lý phần lớn 13 breaking changes.
“Trước đây ship mỗi 1–2 ngày — cộng đồng bị chiều hư.” Sau khoảng trống 10 ngày, “con tôm hùm” vừa drop bản cập nhật lớn nhất từ trước đến nay.
OpenClaw v2026.3.22, phát hành ngày 23 tháng 3 năm 2026, mang 45+ tính năng mới, 13 breaking changes, 82 bug fix, 20 bản vá bảo mật và 15 cải tiến hiệu năng — đạt 294 reaction trên GitHub. Cộng đồng tech Trung Quốc gọi đây là “bản cập nhật mạnh nhất lịch sử”, trong khi Linux DO gắn thẻ “nâng cấp cẩn thận”.
Hướng dẫn này giúp bạn nắm: đổi gì, có ảnh hưởng đến bạn không, và cách nâng cấp an toàn.
Đọc liên quan: Hướng dẫn đầy đủ OpenClaw + bibigpt-skill (cập nhật tháng 3/2026) | OpenClaw 250K Stars: Cách BibiGPT thắng trong kỷ nguyên Agent | bibigpt-skill: cho Claude / OpenClaw khả năng hiểu video
Năm tính năng lớn: Điểm nhấn
1. ClawHub Skills Marketplace trở thành bản địa
Đây là thay đổi lớn nhất của bản phát hành. openclaw plugins install giờ ưu tiên ClawHub hơn npm, chỉ fallback npm khi package không có trên ClawHub. Bộ lệnh quản lý skill đầy đủ đã sẵn sàng:
# Tìm skill
openclaw skills search <keyword>
# Cài một cú nhấp
openclaw skills install <skill-name>
# Kiểm tra cập nhật
openclaw skills update
Đáng chú ý hơn: tương thích xuyên hệ sinh thái. ClawHub có thể khám phá và import skill package từ Claude, Codex và Cursor, tự map sang định dạng OpenClaw. Hơn 4.000 skill cộng đồng nằm trong tầm tay bạn.

2. Timeout agent nhảy lên 48 giờ
Timeout agent mặc định từ 10 phút lên 48 giờ mà không cần chỉnh cấu hình. Job hàng loạt, tài liệu dài, workflow phức tạp — hết bị ngắt giữa chừng.
3. Backend sandbox cắm được (OpenShell + SSH)
Môi trường thực thi sandbox giờ hỗ trợ backend cắm được. Hai backend đầu tiên: SSH và OpenShell, kèm chế độ workspace mirror và remote.
Thực tế: agent của bạn có thể SSH vào máy từ xa và chạy task trực tiếp. Không còn workaround để chạy job trên server.
4. Mở rộng hệ sinh thái model ồ ạt
Bản này bao phủ gần như mọi nhà cung cấp LLM lớn:
- Anthropic Vertex AI: Gọi Claude qua Google Vertex AI (không còn chỉ API Anthropic trực tiếp)
- OpenAI: Model mặc định nâng lên gpt-5.4, tương thích trước với gpt-5.4-mini và gpt-5.4-nano
- MiniMax: Mặc định nâng từ M2.5 lên M2.7, có chế độ tốc độ cao
- xAI Grok: Đồng bộ họ model Grok mới nhất dựa trên Pi
- Z.AI: Thêm series GLM 4.5/4.6
- Xiaomi: Chuyển sang API v1, thêm MiMo V2 Pro và MiMo V2 Omni
- Mistral: Cập nhật giá và metadata model
- GitHub Copilot: ID model động tương thích trước
Tóm lại: dùng LLM nào bạn muốn — OpenClaw lo phần tích hợp.
5. Bộ ba web search tích hợp sẵn
Exa, Tavily và Firecrawl ship dưới dạng plugin first-party. Agent của bạn cuối cùng có khả năng search bản địa ổn định, không còn đau đầu cấu hình bên thứ ba.
Giải thích 13 Breaking Changes — Đọc trước khi nâng cấp
Nếu bạn đang hỏi “có nên update không?”, bảng này có câu trả lời:
| # | Thay đổi | Ai bị ảnh hưởng | Việc cần làm |
|---|---|---|---|
| 1 | ClawHub ưu tiên hơn npm | Cài plugin | Thường trong suốt; fallback npm vẫn hoạt động |
| 2 | Đường legacy Chrome MCP bị gỡ | Người dùng tích hợp trình duyệt | Chạy openclaw doctor --fix |
| 3 | Plugin SDK → openclaw/plugin-sdk/* |
Nhà phát triển skill | Theo tài liệu migration |
| 4 | Gỡ nano-banana-pro |
Người dùng tạo ảnh | Chuyển sang agents.defaults.imageGenerationModel |
| 5 | Gỡ biến env CLAWDBOT_* / MOLTBOT_* |
Mọi người dùng config legacy | Đổi tên thành OPENCLAW_* |
| 6 | Gỡ thư mục .moltbot |
Early adopter | Migrate sang ~/.openclaw |
| 7 | Viết lại plugin Matrix | Người dùng Matrix | Theo hướng dẫn migration |
| 8 | Thay đổi deploy lệnh Discord | Người dùng Discord | Thường trong suốt |
| 9 | Chặn inject biến env sandbox | Developer | MAVEN_OPTS/SBT_OPTS/GRADLE_OPTS không còn đi xuyên |
| 10 | Đổi API message discovery | Developer plugin | Dùng describeMessageTool(...) |
| 11 | Chuẩn hóa tool tạo ảnh | Người dùng tạo ảnh | Dùng tool image_generate |
| 12 | Củng cố webhook voice-call | Người dùng voice call | Đảm bảo header chữ ký provider đúng |
| 13 | Refactor media reply của agent | Developer plugin | Dùng đường details.media |
Lộ trình nâng cấp khuyến nghị
# 1. Cập nhật OpenClaw
openclaw update
# 2. Tự sửa hầu hết breaking changes
openclaw doctor --fix
# 3. Kiểm tra mọi thứ hoạt động
openclaw status

Quan trọng: Nếu bạn vẫn dùng thư mục
.moltbothoặc biến môi trườngCLAWDBOT_*/MOLTBOT_*, bạn phải migrate ngay — không còn đường fallback.
20+ cải tiến nền tảng nhắn tin
Gần như mọi nền tảng lớn đều được cải thiện:
- Matrix (mới): Plugin chính thức
matrix-js-sdkvới hội thoại bot, mention gating, chat bot-to-bot và mạng riêng - Telegram: Endpoint Bot API tùy chỉnh, nhãn topic tự động, chỉnh sửa topic, trả lỗi im lặng
- Feishu/Lark: Thẻ phê duyệt có cấu trúc, hỗ trợ ACP, render reasoning stream
- Discord: Deploy lệnh Carbon reconcile, sửa auth component
- Slack: Sửa ổn định khởi động
@slack/bolt - WhatsApp: Sửa cơ chế reconnect, cải thiện xử lý credential
- Android: Dark theme theo hệ thống, tìm kiếm call log, tìm kiếm SMS, tối ưu bộ nhớ camera
- Mattermost: Hỗ trợ chế độ thread reply
off, cơ chế retry DM - WeChat/WeCom/QQ/DingTalk: Plugin cộng đồng được liệt kê trong tài liệu chính thức
Điểm nhấn bảo mật + hiệu năng
Bảo mật (20+ bản vá)
Bản phát hành bảo mật lớn nhất trong lịch sử OpenClaw:
- Bảo vệ credential Windows SMB: Chặn URL
file://từ xa và đường UNC - Phát hiện text Unicode ẩn: Escape Hangul filler trống trong prompt phê duyệt exec
- Bảo mật Nostr DM: Ép chính sách DM trước khi giải mã kèm guard rate/size
- Củng cố device pairing: Gắn mã setup iOS với profile node dự kiến
- Ép chính sách SSRF: Củng cố toàn diện trên lớp trình duyệt và mạng
Hiệu năng (15+ cải tiến)
- Khởi động Gateway: Load từ
distđã compile, cold-start WhatsApp từ hàng chục giây xuống vài giây - Lazy-load khám phá provider: Không còn preload toàn bộ provider lúc khởi động
- Cache catalog model: Cache theo trạng thái config để tránh lặp việc lúc start
- Độ trễ tin nhắn Telegram: Reply thường không còn rebuild toàn bộ catalog model
- Tối ưu khởi động CLI: Lazy-load cho help và đường channel-add
Top 5 skill ClawHub nên cài sau khi nâng cấp
Với ClawHub đã tích hợp sẵn, khám phá và cài skill chưa bao giờ dễ hơn. Đây là 5 skill đáng lấy ngay sau khi lên v2026.3.22:
1. bibigpt-skill — Tóm tắt video AI
Hỗ trợ 30+ nền tảng gồm Bilibili, YouTube, TikTok, Xiaohongshu và podcast. Tóm tắt bản địa của OpenClaw chỉ cover YouTube — bibigpt-skill lấp đầy phần còn lại. Được hơn 1 triệu người dùng tin tưởng với hơn 5 triệu bản tóm tắt AI đã tạo.
openclaw skills install bibigpt-skill
# Dùng ngay
@OpenClaw summarize this video with bibi https://www.youtube.com/watch?v=xxx

2. Context7 — Tài liệu thư viện trực tiếp
Lấy documentation và code example cập nhật trong lúc bạn code. Không còn API lỗi thời.
3. web-search — Search nâng cao
Hoạt động cùng Exa/Tavily/Firecrawl tích hợp để truy xuất thông tin sâu hơn.
4. notion-connector — Đồng bộ Notion hai chiều
Đồng bộ công việc của agent trực tiếp vào Notion để quản lý kiến thức mượt.
5. github-pr-review — Review PR tự động
Để agent review code và bắt lỗi trước khi ship.
Câu hỏi thường gặp
FAQ nâng cấp OpenClaw v2026.3.22: tương thích, xử lý breaking change và mẹo tích hợp ClawHub.
Q: Tôi có thể nhảy từ bản cũ (ví dụ v2026.3.10) thẳng lên v2026.3.22 không?
A: Có — nhưng luôn chạy openclaw doctor --fix ngay sau đó. Doctor migrate .moltbot sang ~/.openclaw, viết lại biến env legacy sang prefix OPENCLAW_*, và gỡ đường cũ của Chrome MCP. Nếu bạn bỏ qua nhiều version, hãy quét bảng 13 breaking changes trước.
Q: Plugin Claude / Codex / Cursor từ ClawHub có thật sự chạy ngay không?
A: Có. ClawHub ship kèm lớp map định dạng tự động — hầu hết plugin logic thuần (search, dịch, chuyển định dạng) chạy không đổi; plugin phụ thuộc API host-native được gắn badge “compatibility”. bibigpt-skill, Context7 và notion-connector đều đã được verify đầy đủ qua ClawHub.
Q: Timeout agent 48 giờ có tốn thêm tiền không? A: Không. Timeout chỉ cho phép task chạy lâu hơn — billing vẫn theo token model. Cửa sổ 48 giờ lý tưởng cho xử lý video dài, dịch hàng loạt hoặc scrape liên tục — các workflow trước đây phải chunk thủ công giờ có thể chạy end-to-end.
Q: Làm sao để OpenClaw tự tóm tắt video Bilibili / Douyin / YouTube?
A: Cài bibigpt-skill: openclaw skills install bibigpt-skill, rồi prompt @OpenClaw use bibi to summarize this video \<URL\>. summarize tích hợp của OpenClaw chỉ xử lý YouTube — bibigpt-skill mở rộng tóm tắt video AI sang Bilibili, Douyin, Xiaohongshu, podcast và 30+ nền tảng khác.
Q: Sau khi nâng cấp tôi thấy “Cannot find .moltbot directory” — giờ sao?
A: Đó là Breaking Change #6. Chạy openclaw doctor --fix để migrate ~/.moltbot sang ~/.openclaw (config, skill cache và lịch sử session). Nếu doctor thất bại, fallback thủ công là mv ~/.moltbot ~/.openclaw.
Kết luận
OpenClaw v2026.3.22 là bản cập nhật lớn nhất đến nay. ClawHub biến đổi hệ sinh thái skill, timeout agent 48 giờ mở khóa task chạy dài, sandbox cắm được với SSH mở ra thực thi từ xa, và độ phủ đa model đầy đủ nghĩa là bạn không bị khóa vào một nhà cung cấp.
Đúng là 13 breaking changes nghe đáng sợ — nhưng openclaw doctor --fix xử lý phần lớn. Nếu bạn vẫn trì hoãn migrate khỏi .moltbot và biến env legacy, đây là lúc thích hợp.
Sau khi nâng cấp, hãy thử ClawHub — hơn 4.000 skill đang chờ. bibigpt-skill là lựa chọn chuẩn để thêm khả năng hiểu video cho OpenClaw.
Đọc liên quan: