Tutorial Migration

Từ OpenClaw sang Hermes Agent: di trú từng bước

Hermes Agent

Hermes Agent

@hermesagents

May 19, 2026

8 phút đọc

Nếu bạn đang chạy OpenClaw, Hermes Agent là kẻ kế nhiệm của nó. Cùng dòng dõi project, cùng đội maintainer, phía trên là một lần đổi tên và một lần thiết kế lại. Installer của Hermes được dựng để nhận diện chuyện đó — v0.14.0 mang theo một lệnh hermes claw migrate hạng nhất, nhập trạng thái OpenClaw hiện có của bạn trong một lần chạy, có hỗ trợ dry-run và preset rõ ràng.

Đây là hướng dẫn di trú thực tế: cái gì được nhập, bạn có những flag nào, và workflow chạy dry-run trước để né bất ngờ.

1. Cài Hermes Agent

Wizard setup của Hermes tự phát hiện ~/.openclaw và mời di trú trước khi cấu hình bắt đầu. Đường nhanh nhất:

bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup

Khi wizard thấy thư mục home OpenClaw của bạn, nó hỏi có di trú không. Nói có — nhưng nếu bạn muốn xem chính xác cái gì sẽ được di trú trước, thoát wizard và chạy lệnh migrate trực tiếp.

2. Xem trước với --dry-run

Luôn chạy cái này trước. Nó liệt kê mọi thứ migrator sẽ nhập mà không ghi gì lên đĩa:

bash
hermes claw migrate --dry-run

Output gom theo nhóm — SOUL.md, memory, skill, allowlist, config nhắn tin, API key, asset TTS. Đọc qua. Nếu có gì đó nhìn không ổn (một API key cũ bạn không muốn di trú, một file personality bạn đã vượt qua), bỏ qua nhóm tương ứng bằng cách dùng preset.

3. Chọn một preset

Hai preset có sẵn:

  • full (mặc định) — di trú mọi thứ kể cả secret
  • user-data — di trú mọi thứ trừ API key; secret bạn nhập tay lại

Chuyển sang máy mới và muốn cắt sạch về secret? Dùng user-data:

bash
hermes claw migrate --preset user-data

Nâng cấp cùng một máy và muốn tiếp nối?

bash
hermes claw migrate

4. Cái gì được nhập

Theo README:

OpenClawĐích trong Hermes
SOUL.md (persona)nhập y nguyên
Mục MEMORY.mdUSER.mdnhập vào memory Hermes
Skill do người dùng tạocopy vào ~/.hermes/skills/openclaw-imports/
Allowlist lệnh (mẫu phê duyệt)được nhập
Cài đặt nhắn tin (config nền tảng, user được phép, working directory)được nhập
API key (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)được nhập dưới preset full
Asset TTS (file audio workspace)được nhập
AGENTS.md workspaceđược nhập với --workspace-target

Skill từ agentskills.io không được cài lại tự động — Hermes giả định bạn sẽ duyệt lại hub và chọn cái bạn muốn qua hermes skills. Cố ý: lần đổi tên OpenClaw → Hermes cũng làm lại skills hub (v0.14.0 thêm huggingface/skills làm trusted default tap), và một lần chọn lại tươi sạch hơn là lùa cả gói qua.

5. Xử lý xung đột

Nếu Hermes đã có settings trên máy này (ví dụ bạn đã chạy hermes setup trước khi nhớ ra OpenClaw vẫn ở đó), lệnh migrate mặc định từ chối ghi đè. Hai lựa chọn:

  • --overwrite — ghi đè settings Hermes bằng giá trị OpenClaw
  • Bỏ qua nhóm xung đột với --preset user-data nếu xung đột nằm ở secret

Chỉ dùng --overwrite sau khi --dry-run xác nhận giá trị OpenClaw là cái bạn muốn.

6. Xác minh

bash
hermes doctor

Cái này chạy health check sau cài đặt. Nếu memory, skill, allowlist, hay config nền tảng không nằm đúng chỗ, nó phơi ra lỗi cụ thể. Sửa, chạy lại, đi tiếp.

Lựa chọn khác: di trú có agent dẫn đường

Nếu bạn không muốn chạm vào flag CLI, Hermes mang theo skill openclaw-migration:

bash
hermes
> /openclaw-migration

Skill dẫn bạn qua đúng cuộc di trú đó một cách tương tác, với preview --dry-run ở mỗi bước.

Câu hỏi thường gặp

Tôi có mất dữ liệu OpenClaw không? Không. Migrator copy — không di chuyển. Thư mục ~/.openclaw của bạn vẫn nguyên vẹn. Nếu có gì sai, bạn có thể quay đầu bằng cách xóa ~/.hermes và tiếp tục dùng OpenClaw.

Tôi chạy song song được không? Trong thời gian ngắn được. Chúng chia sẻ giả định về HOME và đều mong sở hữu cùng một memory tại cùng một lúc. Để chạy song song lâu hơn, cầu cộng đồng HermesClaw lo việc chạy OpenClaw và Hermes trên cùng một tài khoản WeChat.

Skill của tôi có vỡ không? Skill do người dùng tự tạo được copy vào ~/.hermes/skills/openclaw-imports/ nên sống sót sau cuộc chuyển nhà. Skill bạn lấy từ agentskills.io gắn với hub, không gắn với cài đặt cục bộ — cài lại qua hermes skills.

Có chuyện thì cầu cứu ở đâu? Đầu tiên hermes doctor. Sau đó Discord Nous Research hay GitHub Issues — cả hai đều có link trong README.

Đọc thêm

Đăng ký nhận cập nhật

Tin tức cộng đồng về bản phát hành, skill mới và tích hợp của Hermes Agent. Không spam, hủy đăng ký bất cứ lúc nào.