Hermes Agent: bảo mật, sao lưu và xử lý lỗi

8 lớp bảo vệ có sẵn trong Hermes

Hermes thiết kế 8 lớp bảo vệ. Hiểu chúng giúp bạn biết lớp nào đã tự chạy, lớp nào cần bạn bật:

Nguồn: Security – Overview · Profiles

Ai được ra lệnh cho bot

Thứ tự Hermes kiểm tra: cho phép tất cả (nếu bật) → người đã duyệt ghép đôi → danh sách của từng nền tảng (TELEGRAM_ALLOWED_USERS) → danh sách chung → mặc định từ chối.

Khi để chế độ pair: người lạ nhắn bot sẽ nhận mã 8 ký tự; bạn tự quyết duyệt hay không trên VPS. Mã hết hạn sau 1 giờ.

hermes pairing list                          # người đang chờ và đã được duyệt
hermes pairing approve telegram <MÃ 8 KÝ TỰ>  # duyệt (chỉ khi bạn biết người đó)
hermes pairing revoke telegram <ID>           # thu hồi quyền

Nguồn: Security – User Authorization · Security – DM Pairing

Duyệt lệnh nguy hiểm

hermes config set approvals.mode manual   # chuyển sang hỏi mọi lệnh nguy hiểm

• Lệnh cần duyệt gồm: xoá thư mục (rm -r), đổi quyền 777, ghi vào /etc, ~/.ssh, file .env, tải script về chạy (curl … | sh), dừng dịch vụ, xoá bảng dữ liệu…
• Một số lệnh phá huỷ (xoá toàn bộ ổ đĩa, ghi đè đĩa…) luôn bị chặn, kể cả khi tắt duyệt.
• Không trả lời trong 5 phút → lệnh tự bị từ chối.
• Trên Telegram, trả lời yes/no hoặc dùng /approve//deny. Chọn "always" là cho phép vĩnh viễn — chỉ dùng cho lệnh bạn hiểu rõ.
• Lịch tự động và yêu cầu từ webhook/API mặc định từ chối lệnh nguy hiểm (không có ai duyệt). Giữ nguyên mặc định này.

Mỗi tháng xem lại danh sách lệnh đã cho phép vĩnh viễn (mục command_allowlist):

hermes config show | grep -A20 command_allowlist   # xoá dòng nào không còn cần bằng: hermes config edit

Nguồn: Security – Dangerous Command Approval · Security – Hardline Blocklist · Security – Approval Timeout

Agent tiếp khách: tắt quyền chạy lệnh

Agent trả lời khách (Fanpage, Zalo, website) đọc tin nhắn của người lạ — kẻ xấu có thể cố "dụ" agent làm việc ngoài vai trò. Nguyên tắc: agent tiếp khách chỉ được nói chuyện, không chạy lệnh, không đọc–ghi file, không duyệt web tự do.

hermes profile create cskh --clone    # agent riêng cho khách
hermes -p cskh tools                  # TẮT: terminal, file, code_execution, browser — giữ lại memory, skills

• Đưa bảng giá, chính sách, FAQ vào kỹ năng của agent cskh để trả lời đúng, không bịa.
• Agent cskh không giữ mã bí mật của tài khoản quảng cáo, Google, VPS.
• Việc cần quyền (tạo đơn, ghi Sheet) → agent cskh chỉ ghi nhận và báo người thật hoặc agent nội bộ xử lý.

Cách nối agent cskh với Fanpage, Zalo: Phần 5, Phần 6.

Nguồn: Tools & Toolsets · Profiles

Giữ mã bí mật

• Mã bí mật nằm trong ~/.hermes/.env (mỗi profile một file). Luôn chmod 600.
• Nhập mã bằng khung đỏ (lệnh read -s): không hiện trên màn hình, không lưu vào lịch sử lệnh.
• Hermes mặc định che mã bí mật trong kết quả công cụ và nhật ký (security.redact_secrets). Đừng tắt.
• hermes config get tự che các giá trị dạng khoá/token.
• Mỗi dịch vụ, mỗi agent một khoá riêng; đặt hạn mức chi tiêu ở từng nhà cung cấp.

Khi nghi lộ mã bí mật — làm ngay

1. Thu hồi ở nơi cấp: bot Telegram → @BotFather /revoke; khoá AI → xoá khoá trong trang nhà cung cấp; token Meta/Google → thu hồi trong trang quản lý.
2. Tạo mã mới và nhập lại bằng khung đỏ (Phần 1).
3. hermes gateway restart, rồi kiểm tra hermes logs gateway --since 24h xem có truy cập lạ.
4. Đổi mật khẩu tài khoản liên quan, rà lại danh sách người được ra lệnh.

read -rsp "Dán TELEGRAM_BOT_TOKEN rồi Enter (chữ sẽ không hiện): " V; echo; hermes config set TELEGRAM_BOT_TOKEN "$V"; unset V   # ví dụ nhập lại token mới sau khi /revoke

Nguồn: Security – Securing API Keys · Security – Credential Redaction · Telegram – BotFather

Cập nhật an toàn

hermes update --check          # xem bản mới có gì, chưa cài
hermes update --backup         # sao lưu đầy đủ rồi mới cập nhật
hermes doctor && hermes --version && hermes gateway status   # kiểm tra sau cập nhật
hermes security audit          # kiểm tra lỗ hổng đã công bố trong thư viện đi kèm (mỗi tháng)

• Dùng kênh stable (Phần 1, Bước 2.2). Cập nhật vào lúc vắng khách, không cập nhật ngay trước sự kiện bán hàng lớn.
• Báo lỗi sau cập nhật → hermes doctor; cấu hình cũ không còn đúng → hermes config check rồi hermes config migrate.
• Cập nhật hệ điều hành (bằng tài khoản quản trị): sudo apt update && sudo apt upgrade -y; gói unattended-upgrades đã tự cài bản vá bảo mật.

Nguồn: Updating · CLI – hermes update · CLI – security audit

Sao lưu và khôi phục

Lịch sao lưu tự động mỗi đêm, tải về máy tính mỗi tuần: Phần 1, Bước 7. Mỗi quý thử khôi phục một lần trên VPS thử nghiệm — sao lưu chưa từng khôi phục thử thì chưa chắc dùng được.

Nguồn: CLI – hermes backup · CLI – hermes import · Profile Commands – export

Báo cáo "còn sống" mỗi sáng và nút dừng khẩn cấp

Nhắn bot một lần để có lịch kiểm tra sức khoẻ hằng ngày:

Tạo lịch tự động mỗi ngày 7h30: kiểm tra dung lượng ổ đĩa (df -h), RAM (free -h), trạng thái cổng nhắn tin, số lịch tự động bị lỗi hôm qua (hermes cron status). Gửi tôi 5 dòng tóm tắt, dòng đầu ghi ỔN hoặc CẦN XỬ LÝ.

Sáng nào không nhận được tin = có sự cố → vào VPS kiểm tra ngay. Lịch tự động chỉ chạy khi cổng nhắn tin đang chạy.

Dừng khẩn cấp

hermes pause      # dừng mọi việc mới: lịch tự động, việc nhận qua tin nhắn (việc đang chạy dở không bị cắt ngang)
hermes resume     # chạy lại bình thường

Dùng khi agent làm sai hàng loạt (đăng nhầm, gửi nhầm). Trong chat có thể gõ /stop để dừng việc đang làm.

Nguồn: Cron · CLI – hermes pause / resume

Bảng xử lý lỗi thường gặp

Gặp lỗi bất kỳ, chạy trước 2 lệnh này — phần lớn nguyên nhân hiện ra ngay:

hermes doctor                  # tự chẩn đoán; thêm --fix để tự sửa lỗi đơn giản
hermes logs errors --since 1h  # lỗi trong 1 giờ qua

Cần người hỗ trợ? hermes dump in bản tóm tắt cấu hình để gửi kỹ thuật viên (mặc định chỉ ghi "đã đặt/chưa đặt" cho khoá — không thêm --show-keys). Kiểm tra lại nội dung trước khi gửi.

Nguồn: FAQ & Troubleshooting · CLI – doctor · CLI – dump · Cron troubleshooting · Multi-profile gateways

Checklist định kỳ

Mỗi tuần

• Tải bản sao lưu mới nhất về máy tính
• Xem /usage hoặc hermes insights --days 7: chi phí có tăng bất thường
• Đọc lướt hermes logs errors --since 7d

Mỗi tháng

• hermes update --backup (kênh stable) rồi hermes doctor
• hermes security audit
• Rà command_allowlist và danh sách người được ra lệnh
• Xem lại kỹ năng agent tự tạo: hermes skills list
• Kiểm tra hạn mức chi tiêu ở nhà cung cấp AI và tài khoản quảng cáo

Mỗi quý

• Thử khôi phục bản sao lưu trên VPS thử nghiệm
• Thay mới khoá API quan trọng
• Rà quyền của token Meta/Google: bỏ quyền không còn dùng

Tài liệu liên quan

• AI AgentHermes Agent là gì? So sánh với OpenClawHermes Agent làm được gì, chi phí bao nhiêu, khác OpenClaw ở đâu và nên chọn công cụ nào cho shop, đội quảng cáo, người làm nội dung.
• Hermes Agent · AI AgentCài đặt Hermes Agent trên VPS an toànTừng bước: VPS bảo mật, cài Hermes, kết nối model AI, bot Telegram chỉ nghe lời bạn, chạy 24/7, sao lưu tự động, Google Sheets/Drive.
• Hermes Agent · AI AgentHướng dẫn sử dụng Hermes Agent hằng ngàyChat qua Telegram, lệnh gạch chéo, tính cách SOUL.md, trí nhớ, kỹ năng tự học, đổi model, kiểm soát chi phí và bảng lệnh hay dùng.
• Hermes Agent · AI AgentTính năng Hermes Agent cho kinh doanh onlineBản đồ tính năng và kỹ năng của Hermes, cách áp dụng cho shop TMĐT, người chạy quảng cáo, bán hàng online, làm nội dung — kèm câu lệnh mẫu.

Xem tất cả tài liệu hướng dẫn →

Nguồn tham khảo

Thông tin kỹ thuật trong bài lấy từ các tài liệu dưới đây (đã ghi nguồn ngay dưới từng mục). Phần diễn giải, ví dụ và quy trình là của Aduca.

• Hermes – Security (8 lớp bảo vệ, duyệt lệnh, pairing, checklist triển khai)
• Hermes – Secure Hermes on a work machine
• Hermes – Profiles (profile không phải hộp cát)
• Hermes – Docker
• Hermes – Tools & Toolsets
• Hermes – CLI (backup, import, update, doctor, dump, pause, security audit)
• Hermes – Updating
• Hermes – Cron
• Hermes – Cron Troubleshooting
• Hermes – FAQ & Troubleshooting
• Hermes – Agent quality troubleshooting
• Telegram – BotFather (/revoke)

Lịch sử cập nhật

• 02/10/2026 — Bản đầu, theo Hermes v0.21.5.

Miễn trừ trách nhiệm