Di chuyển từ OpenClaw

hermes vuốt di chuyển nhập thiết lập OpenClaw (hoặc Clawdbot/Moldbot cũ) của bạn vào Hermes. Hướng dẫn này trình bày chính xác những gì sẽ được di chuyển, ánh xạ khóa cấu hình và những gì cần xác minh sau khi di chuyển.

Bắt đầu nhanh

# Preview what would happen (no files changed)
hermes claw migrate --dry-run

# Run the migration (secrets excluded by default)
hermes claw migrate

# Full migration including API keys
hermes claw migrate --preset full

Quá trình di chuyển đọc từ ~/.openclaw/ theo mặc định. Nếu bạn vẫn có thư mục ~/.clawdbot/ hoặc ~/.moldbot/ kế thừa, nó sẽ tự động được phát hiện. Tương tự đối với tên tệp cấu hình cũ (clawdbot.json, moldbot.json).

Tùy chọn

Tùy chọn	Mô tả
--chạy thử	Xem trước những gì sẽ được di chuyển mà không cần viết bất cứ điều gì.
--đặt trước <tên>	đầy đủ (mặc định, bao gồm bí mật) hoặc dữ liệu người dùng (không bao gồm khóa API).
--ghi đè	Ghi đè các tệp Hermes hiện có khi có xung đột (mặc định: bỏ qua).
--migrate-bí mật	Bao gồm các khóa API (được bật theo mặc định với --preset full).
--nguồn <đường dẫn>	Thư mục OpenClaw tùy chỉnh.
--workspace-đích <path>	Nơi đặt AGENTS.md.
--xung đột kỹ năng <mode>	bỏ qua (mặc định), ghi đè hoặc đổi tên.
--vâng	Bỏ qua lời nhắc xác nhận.

Những gì được di chuyển

Persona, bộ nhớ và hướng dẫn

Cái gì	Nguồn OpenClaw	Điểm đến Hermes	Ghi chú
Nhân cách	không gian làm việc/SOUL.md	~/.hermes/SOUL.md	Sao chép trực tiếp
Hướng dẫn về không gian làm việc	không gian làm việc/AGENTS.md	AGENTS.md trong --workspace-target	Yêu cầu cờ --workspace-target
Trí nhớ dài hạn	không gian làm việc/MEMORY.md	~/.hermes/memories/MEMORY.md	Được phân tích cú pháp thành các mục, hợp nhất với hiện có, loại bỏ. Sử dụng dấu phân cách §.
Hồ sơ người dùng	không gian làm việc/USER.md	~/.hermes/memories/USER.md	Logic hợp nhất mục nhập tương tự như bộ nhớ.
Tập tin bộ nhớ hàng ngày	không gian làm việc/bộ nhớ/*.md	~/.hermes/memories/MEMORY.md	Tất cả các tập tin hàng ngày được sáp nhập vào bộ nhớ chính.

Tất cả các tệp không gian làm việc cũng kiểm tra workspace.default/ làm đường dẫn dự phòng.

Kỹ năng (4 nguồn)

Nguồn	Vị trí OpenClaw	Điểm đến Hermes
Kỹ năng không gian làm việc	không gian làm việc/kỹ năng/	~/.hermes/skills/openclaw-imports/
Kỹ năng quản lý/chia sẻ	~/.openclaw/skills/	~/.hermes/skills/openclaw-imports/
Dự án chéo cá nhân	~/.agents/skills/	~/.hermes/skills/openclaw-imports/
Chia sẻ cấp dự án	workspace/.agents/skills/	~/.hermes/skills/openclaw-imports/

Xung đột kỹ năng được xử lý bằng --skill-conflict: skip rời khỏi kỹ năng Hermes hiện có, ghi đè thay thế nó, đổi tên tạo một bản sao -được nhập.

Cấu hình mô hình và nhà cung cấp

Cái gì	Đường dẫn cấu hình OpenClaw	Điểm đến Hermes	Ghi chú
Mô hình mặc định	đại lý.defaults.model	config.yaml → model	Có thể là một chuỗi hoặc đối tượng {chính, dự phòng}
Nhà cung cấp tùy chỉnh	models.providers.*	config.yaml → custom_providers	Bản đồ baseUrl, apiType ("openai"→"chat_completions", "anthropic"→"anthropic_messages")
Khóa API của nhà cung cấp	models.providers.*.apiKey	~/.hermes/.env	Yêu cầu --migrate-secret. Xem độ phân giải khóa API bên dưới.

Hành vi của đại lý

Cái gì	Đường dẫn cấu hình OpenClaw	Đường dẫn cấu hình Hermes	Lập bản đồ
Lượt quay tối đa	agents.defaults.timeoutSeconds	agent.max_turns	thời gian chờGiây / 10, giới hạn ở mức 200
Chế độ dài dòng	agents.defaults.verboseDefault	đại lý.verbose	"tắt" / "bật" / "đầy"
Nỗ lực lý luận	agents.defaults.thinkingDefault	agent.reasoning_effort	"luôn luôn"/"cao" → "cao", "tự động"/"trung bình" → "trung bình", "tắt"/"thấp"/"không"/"tối thiểu" → "thấp"
Nén	agents.defaults.compaction.mode	nén.enabled	"tắt" → sai, bất cứ điều gì khác → đúng
Mô hình nén	agents.defaults.compaction.model	nén.summary_model	Sao chép chuỗi trực tiếp
Sự chậm trễ của con người	agents.defaults.humanDelay.mode	human_delay.mode	"tự nhiên" / "tùy chỉnh" / "tắt"
Thời gian trễ của con người	agents.defaults.humanDelay.minMs / .maxMs	human_delay.min_ms / .max_ms	Sao chép trực tiếp
Múi giờ	agents.defaults.userTimezone	múi giờ	Sao chép chuỗi trực tiếp
Thời gian chờ thực thi	tools.exec.timeoutSec	terminal.timeout	Sao chép trực tiếp (trường là timeoutSec, không phải timeout)
Hộp cát Docker	agents.defaults.sandbox.backend	terminal.backend	"docker" → "docker"
Hình ảnh Docker	agents.defaults.sandbox.docker.image	terminal.docker_image	Sao chép trực tiếp

Chính sách đặt lại phiên

Đường dẫn cấu hình OpenClaw	Đường dẫn cấu hình Hermes	Ghi chú
phiên.reset.mode	session_reset.mode	"hàng ngày", "nhàn rỗi" hoặc cả hai
session.reset.atHour	session_reset.at_hour	Giờ (0–23) để đặt lại hàng ngày
session.reset.idleMinutes	session_reset.idle_phút	Phút không hoạt động

Lưu ý: OpenClaw cũng có session.resetTriggers (một mảng chuỗi đơn giản như ["daily", "idle"]). Nếu cấu trúc session.reset không xuất hiện thì quá trình di chuyển sẽ quay lại suy luận từ resetTriggers.

máy chủ MCP

Trường OpenClaw	Cánh đồng Hermes	Ghi chú
mcp.servers.*.command	mcp_servers.*.command	Vận tải Stdio
mcp.servers.*.args	mcp_servers.*.args
mcp.servers.*.env	mcp_servers.*.env
mcp.servers.*.cwd	mcp_servers.*.cwd
mcp.servers.*.url	mcp_servers.*.url	Vận chuyển HTTP/SSE
mcp.servers.*.tools.include	mcp_servers.*.tools.include	Lọc công cụ
mcp.servers.*.tools.exclude	mcp_servers.*.tools.exclude

TTS (chuyển văn bản thành giọng nói)

Cài đặt TTS được đọc từ hai vị trí cấu hình OpenClaw với mức độ ưu tiên sau:

1. messages.tts.providers.{provider}.* (vị trí chuẩn)
2. talk.providers.{provider}.* cấp cao nhất (dự phòng)
3. Phím phẳng kế thừa messages.tts.{provider}.* (định dạng cũ nhất)

Cái gì	Điểm đến Hermes
Tên nhà cung cấp	config.yaml → tts.provider
ID giọng nói ElevenLabs	config.yaml → tts.elevenlabs.voice_id
ID mô hình ElevenLabs	config.yaml → tts.elevenlabs.model_id
Mô hình OpenAI	config.yaml → tts.openai.model
Giọng nói OpenAI	config.yaml → tts.openai.voice
Giọng nói Edge TTS	config.yaml → tts.edge.voice
Tài sản TTS	~/.hermes/tts/ (bản sao tập tin)

Nền tảng nhắn tin

Nền tảng	Đường dẫn cấu hình OpenClaw	Biến Hermes .env	Ghi chú
Điện tín	channels.telegram.botToken	TELEGRAM_BOT_TOKEN	Mã thông báo có thể là chuỗi hoặc SecretRef
Điện tín	thông tin xác thực/telegram-default-allowFrom.json	TELEGRAM_ALLOWED_USERS	Được nối bằng dấu phẩy từ mảng allowFrom[]
Bất hòa	channels.discord.token	DISCORD_BOT_TOKEN
Bất hòa	channels.discord.allowFrom	DISCORD_ALLOWED_USERS
Chần chừ	channels.slack.botToken	SLACK_BOT_TOKEN
Chần chừ	channels.slack.appToken	SLACK_APP_TOKEN
Chần chừ	channels.slack.allowFrom	SLACK_ALLOWED_USERS
WhatsApp	channels.whatsapp.allowFrom	WHATSAPP_ALLOWED_USERS	Xác thực thông qua ghép nối Baileys QR (không phải mã thông báo)
Tín hiệu	channels.signal.account	TÍN HIỆU_TÀI KHOẢN
Tín hiệu	channels.signal.httpUrl	SIGNAL_HTTP_URL
Tín hiệu	channels.signal.allowFrom	SIGNAL_ALLOWED_USERS
Ma trận	channels.matrix.botToken	MATRIX_ACCESS_TOKEN	Thông qua di chuyển kênh sâu
Quan trọng nhất	channels.mattermost.botToken	MATTERMOST_BOT_TOKEN	Thông qua di chuyển kênh sâu

Cấu hình khác

Cái gì	Đường dẫn OpenClaw	Con đường Hermes	Ghi chú
Chế độ phê duyệt	phê duyệt.exec.mode	config.yaml → approvals.mode	"tự động"→"tắt", "luôn luôn"→"thủ công", "thông minh"→"thông minh"
Danh sách cho phép lệnh	exec-approvals.json	config.yaml → command_allowlist	Các mẫu được hợp nhất và loại bỏ
URL CDP của trình duyệt	trình duyệt.cdpUrl	config.yaml → browser.cdp_url
Trình duyệt không đầu	trình duyệt.không đầu	config.yaml → browser.headless
Phím tìm kiếm dũng cảm	tools.web.search.brave.apiKey	.env → BRAVE_API_KEY	Yêu cầu --migrate-secret
Mã thông báo xác thực cổng	gateway.auth.token	.env → HERMES_GATEWAY_TOKEN	Yêu cầu --migrate-secret
Thư mục làm việc	agent.defaults.workspace	.env → MESSAGING_CWD

Đã lưu trữ (không có tương đương trực tiếp với Hermes)

Chúng được lưu vào ~/.hermes/migration/openclaw/<timestamp>/archive/ để xem xét thủ công:

Cái gì	Lưu trữ tập tin	Cách tái tạo trong Hermes
SẮC DẠNG.md	archive/workspace/IDENTITY.md	Hợp nhất vào SOUL.md
TOOLS.md	archive/workspace/TOOLS.md	Hermes có hướng dẫn sử dụng công cụ tích hợp
HEARTBEAT.md	archive/workspace/HEARTBEAT.md	Sử dụng cron jobs cho các tác vụ định kỳ
BOOTSTRAP.md	lưu trữ/không gian làm việc/BOOTSTRAP.md	Sử dụng các tệp hoặc kỹ năng ngữ cảnh
Công việc định kỳ	lưu trữ/cron-config.json	Tái tạo với hermes cron create
Plugin	archive/plugins-config.json	Xem hướng dẫn plugin
Móc/webhooks	archive/hooks-config.json	Sử dụng hermes webhook hoặc móc cổng
Phụ trợ bộ nhớ	archive/memory-backend-config.json	Cấu hình qua hermes honcho
Đăng ký kỹ năng	archive/skills-registry-config.json	Sử dụng cấu hình kỹ năng hermes
Giao diện người dùng/danh tính	archive/ui-identity-config.json	Sử dụng lệnh /skin
Ghi nhật ký	archive/logging-diagnostics-config.json	Đặt trong phần ghi nhật ký config.yaml
Danh sách đa đại lý	archive/agents-list.json	Sử dụng hồ sơ Hermes
Ràng buộc kênh	archive/binds.json	Thiết lập thủ công cho mỗi nền tảng
Kênh phức tạp	archive/channels-deep-config.json	Cấu hình nền tảng thủ công

Độ phân giải khóa API

Khi --migrate-secrets được bật, các khóa API được thu thập từ ba nguồn theo thứ tự ưu tiên:

1. Giá trị cấu hình — models.providers.*.apiKey và khóa nhà cung cấp TTS trong openclaw.json
2. Tệp môi trường — ~/.openclaw/.env (các khóa như OPENROUTER_API_KEY, ANTHROPIC_API_KEY, v.v.)
3. Hồ sơ xác thực — ~/.openclaw/agents/main/agent/auth-profiles.json (thông tin xác thực cho mỗi tác nhân)

Giá trị cấu hình được ưu tiên. .env lấp đầy mọi khoảng trống. Hồ sơ xác thực điền vào những gì còn lại.

Các mục tiêu chính được hỗ trợ

OPENROUTER_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, GEMINI_API_KEY, ZAI_API_KEY, MINIMAX_API_KEY, ELEVENLABS_API_KEY, TELEGRAM_BOT_TOKEN, VOICE_TOOLS_OPENAI_KEY

Các khóa không có trong danh sách cho phép này sẽ không bao giờ được sao chép.

Xử lý SecretRef

Giá trị cấu hình OpenClaw cho mã thông báo và khóa API có thể ở ba định dạng:

// Plain string
"channels": { "telegram": { "botToken": "123456:ABC-DEF..." } }

// Environment template
"channels": { "telegram": { "botToken": "${TELEGRAM_BOT_TOKEN}" } }

// SecretRef object
"channels": { "telegram": { "botToken": { "source": "env", "id": "TELEGRAM_BOT_TOKEN" } } }

Quá trình di chuyển giải quyết cả ba định dạng. Đối với các mẫu env và đối tượng SecretRef có source: "env", nó sẽ tra cứu giá trị trong ~/.openclaw/.env. Không thể tự động giải quyết các đối tượng SecretRef có source: "file" hoặc source: "exec" — những giá trị đó phải được thêm vào Hermes theo cách thủ công sau khi di chuyển.

Sau khi di chuyển

1. Kiểm tra báo cáo di chuyển — được in khi hoàn thành với số lượng mục đã di chuyển, bị bỏ qua và xung đột.

2. Xem lại các tệp đã lưu trữ — mọi nội dung trong ~/.hermes/migration/openclaw/<timestamp>/archive/ đều cần được xử lý thủ công.

3. Xác minh khóa API — chạy hermes status để kiểm tra xác thực nhà cung cấp.

4. Kiểm tra tin nhắn — nếu bạn đã di chuyển mã thông báo nền tảng, hãy khởi động lại cổng: systemctl --user restart hermes-gateway

5. Kiểm tra chính sách phiên — xác minh hermes config get session_reset phù hợp với mong đợi của bạn.

6. Ghép nối lại WhatsApp — WhatsApp sử dụng ghép nối mã QR (Bailey), không phải di chuyển mã thông báo. Chạy hermes whatsapp để ghép nối.

Khắc phục sự cố

"Không tìm thấy thư mục OpenClaw"

Quá trình di chuyển kiểm tra ~/.openclaw/, sau đó ~/.clawdbot/, sau đó ~/.moldbot/. Nếu cài đặt của bạn ở nơi khác, hãy sử dụng --source /path/to/your/openclaw.

"Không tìm thấy khóa API của nhà cung cấp"

Khóa có thể nằm trong tệp .env của bạn thay vì openclaw.json. Quá trình di chuyển kiểm tra cả hai - đảm bảo ~/.openclaw/.env tồn tại và có khóa. Nếu khóa sử dụng source: "file" hoặc source: "exec" SecretRefs thì chúng không thể được giải quyết tự động.

Kỹ năng không xuất hiện sau khi di chuyển

Các kỹ năng đã nhập sẽ nằm trong ~/.hermes/skills/openclaw-imports/. Bắt đầu một phiên mới để chúng có hiệu lực hoặc chạy /skills để xác minh rằng chúng đã được tải.

Giọng nói TTS chưa được di chuyển

OpenClaw lưu trữ cài đặt TTS ở hai nơi: messages.tts.providers.* và cấu hình talk cấp cao nhất. Việc di chuyển kiểm tra cả hai. Nếu ID giọng nói của bạn được đặt thông qua Giao diện người dùng OpenClaw (được lưu trữ trong một đường dẫn khác), bạn có thể cần đặt ID đó theo cách thủ công: hermes config set tts.elevenlabs.voice_id YOUR_VOICE_ID.