# openclaw migrate

Nhập trạng thái từ một hệ thống tác tử khác thông qua nhà cung cấp di chuyển do Plugin sở hữu. Các nhà cung cấp đi kèm bao phủ trạng thái Codex CLI, Claude, và Hermes; Plugin bên thứ ba có thể đăng ký các nhà cung cấp bổ sung.

# Lệnh

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Tên của một nhà cung cấp di chuyển đã đăng ký, ví dụ hermes. Chạy openclaw migrate list để xem các nhà cung cấp đã cài đặt.

--dry-runboolean

Tạo kế hoạch và thoát mà không thay đổi trạng thái.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Ghi đè thư mục trạng thái nguồn. Hermes mặc định là ~/.hermes.

--include-secretsboolean

Nhập thông tin xác thực được hỗ trợ. Mặc định tắt.

--overwriteboolean

Cho phép áp dụng thay thế các đích hiện có khi kế hoạch báo cáo xung đột.

--yesboolean

Bỏ qua lời nhắc xác nhận. Bắt buộc trong chế độ không tương tác.

"--skill

--no-backupboolean

Bỏ qua bản sao lưu trước khi áp dụng. Yêu cầu --force khi trạng thái OpenClaw cục bộ tồn tại.

--forceboolean

Bắt buộc cùng với --no-backup khi việc áp dụng nếu không sẽ từ chối bỏ qua sao lưu.

--jsonboolean

In kế hoạch hoặc kết quả áp dụng dưới dạng JSON. Với --json và không có --yes, apply in kế hoạch và không thay đổi trạng thái.

# Mô hình an toàn

openclaw migrate ưu tiên xem trước.

# Nhà cung cấp Claude

Nhà cung cấp Claude đi kèm phát hiện trạng thái Claude Code tại ~/.claude theo mặc định. Dùng --from <path> để nhập một thư mục chính hoặc gốc dự án Claude Code cụ thể.

# Claude nhập những gì

• CLAUDE.md của dự án và .claude/CLAUDE.md vào không gian làm việc tác tử OpenClaw.
• ~/.claude/CLAUDE.md của người dùng được nối vào USER.md của không gian làm việc.
• Định nghĩa máy chủ MCP từ .mcp.json của dự án, Claude Code ~/.claude.json, và Claude Desktop claude_desktop_config.json.
• Thư mục skill Claude bao gồm SKILL.md.
• Tệp Markdown lệnh Claude được chuyển đổi thành skills OpenClaw chỉ với cách gọi thủ công.

# Trạng thái lưu trữ và cần xem xét thủ công

Hooks, quyền, giá trị mặc định môi trường, bộ nhớ cục bộ, quy tắc theo phạm vi đường dẫn, tác tử con, bộ nhớ đệm, kế hoạch, và lịch sử dự án của Claude được giữ trong báo cáo di chuyển hoặc được báo cáo là mục cần xem xét thủ công. OpenClaw không thực thi hooks, sao chép allowlists rộng, hoặc tự động nhập trạng thái thông tin xác thực OAuth/Desktop.

# Nhà cung cấp Codex

Nhà cung cấp Codex đi kèm phát hiện trạng thái Codex CLI tại ~/.codex theo mặc định, hoặc tại CODEX_HOME khi biến môi trường đó được đặt. Dùng --from <path> để kiểm kê một thư mục chính Codex cụ thể.

Dùng nhà cung cấp này khi chuyển sang OpenClaw Codex harness và bạn muốn chủ đích đưa các tài sản Codex CLI cá nhân hữu ích lên dùng. Các lần khởi chạy máy chủ ứng dụng Codex cục bộ dùng các thư mục CODEX_HOME và HOME theo từng tác tử, nên mặc định chúng không đọc trạng thái Codex CLI cá nhân của bạn.

Chạy openclaw migrate codex trong terminal tương tác sẽ xem trước toàn bộ kế hoạch, sau đó mở bộ chọn hộp kiểm cho các mục sao chép skill trước xác nhận áp dụng cuối cùng. Dùng Toggle all on hoặc Toggle all off để chọn hàng loạt; skills đã lên kế hoạch bắt đầu ở trạng thái được chọn, skills xung đột bắt đầu ở trạng thái không chọn, và Skip for now để nguyên skills mà không áp dụng. Đối với các lần chạy theo script hoặc chính xác, truyền --skill <name> một lần cho mỗi skill, ví dụ:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# Codex nhập những gì

• Thư mục skill Codex CLI dưới $CODEX_HOME/skills, loại trừ bộ nhớ đệm .system của Codex.
• AgentSkills cá nhân dưới $HOME/.agents/skills, được sao chép vào không gian làm việc tác tử OpenClaw hiện tại khi bạn muốn quyền sở hữu theo từng tác tử.

# Trạng thái Codex cần xem xét thủ công

Plugin gốc của Codex, config.toml, và hooks/hooks.json gốc không được kích hoạt tự động. Plugin có thể phơi bày máy chủ MCP, ứng dụng, hooks, hoặc hành vi thực thi khác, nên nhà cung cấp báo cáo chúng để xem xét thay vì tải chúng vào OpenClaw. Tệp cấu hình và hook được sao chép vào báo cáo di chuyển để xem xét thủ công.

# Nhà cung cấp Hermes

Nhà cung cấp Hermes đi kèm phát hiện trạng thái tại ~/.hermes theo mặc định. Dùng --from <path> khi Hermes nằm ở nơi khác.

# Hermes nhập những gì

• Cấu hình mô hình mặc định từ config.yaml.
• Các nhà cung cấp mô hình đã cấu hình và endpoint tương thích OpenAI tùy chỉnh từ providers và custom_providers.
• Định nghĩa máy chủ MCP từ mcp_servers hoặc mcp.servers.
• SOUL.md và AGENTS.md vào không gian làm việc tác tử OpenClaw.
• memories/MEMORY.md và memories/USER.md được nối vào các tệp bộ nhớ không gian làm việc.
• Giá trị mặc định cấu hình bộ nhớ cho bộ nhớ tệp OpenClaw, cùng với các mục lưu trữ hoặc cần xem xét thủ công cho nhà cung cấp bộ nhớ bên ngoài như Honcho.
• Skills bao gồm tệp SKILL.md dưới skills/<name>/.
• Giá trị cấu hình theo từng skill từ skills.config.
• Các khóa API được hỗ trợ từ .env, chỉ với --include-secrets.

# Khóa .env được hỗ trợ

OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY.

# Trạng thái chỉ lưu trữ

Trạng thái Hermes mà OpenClaw không thể diễn giải an toàn được sao chép vào báo cáo di chuyển để xem xét thủ công, nhưng không được tải vào cấu hình hoặc thông tin xác thực OpenClaw đang hoạt động. Điều này bảo toàn trạng thái mờ hoặc không an toàn mà không giả vờ OpenClaw có thể tự động thực thi hoặc tin cậy nó:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• auth.json
• state.db

# Sau khi áp dụng

openclaw doctor

# Hợp đồng Plugin

Nguồn di chuyển là Plugin. Một Plugin khai báo id nhà cung cấp của nó trong openclaw.plugin.json:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

Khi chạy, Plugin gọi api.registerMigrationProvider(...). Nhà cung cấp triển khai detect, plan, và apply. Core sở hữu điều phối CLI, chính sách sao lưu, lời nhắc, đầu ra JSON, và kiểm tra trước xung đột. Core truyền kế hoạch đã xem xét vào apply(ctx, plan), và nhà cung cấp chỉ có thể tạo lại kế hoạch khi đối số đó vắng mặt để tương thích.

Plugin nhà cung cấp có thể dùng openclaw/plugin-sdk/migration để xây dựng mục và đếm tóm tắt, cùng với openclaw/plugin-sdk/migration-runtime để sao chép tệp có nhận biết xung đột, sao chép báo cáo chỉ lưu trữ, wrapper config-runtime được lưu đệm, và báo cáo di chuyển.

# Tích hợp onboarding

Onboarding có thể đề xuất di chuyển khi một nhà cung cấp phát hiện nguồn đã biết. Cả openclaw onboard --flow import và openclaw setup --wizard --import-from hermes đều dùng cùng nhà cung cấp di chuyển Plugin và vẫn hiển thị bản xem trước trước khi áp dụng.

# Liên quan

• Di chuyển từ Hermes: hướng dẫn dành cho người dùng.
• Di chuyển từ Claude: hướng dẫn dành cho người dùng.
• Di chuyển: chuyển OpenClaw sang máy mới.
• Doctor: kiểm tra sức khỏe sau khi áp dụng di chuyển.
• Plugins: cài đặt và đăng ký Plugin.