Chuyển đến nội dung chính
OpenClaw nhập trạng thái Claude cục bộ thông qua trình cung cấp di chuyển Claude được tích hợp sẵn. Trình cung cấp xem trước từng mục trước khi thay đổi trạng thái, che thông tin bí mật trong kế hoạch và báo cáo, đồng thời tạo bản sao lưu đã được xác minh trước khi áp dụng.
Việc nhập trong quá trình thiết lập ban đầu yêu cầu một bản thiết lập OpenClaw mới. Nếu bạn đã có trạng thái OpenClaw cục bộ, trước tiên hãy đặt lại cấu hình, thông tin xác thực, phiên và không gian làm việc; hoặc sử dụng trực tiếp openclaw migrate với --overwrite sau khi xem xét kế hoạch.

​
Hai cách nhập

Trình hướng dẫn cung cấp tùy chọn Claude khi phát hiện trạng thái Claude cục bộ.
Hoặc chỉ định một nguồn cụ thể:

​
Nội dung được nhập

  • Nội dung CLAUDE.md và .claude/CLAUDE.md của dự án được sao chép hoặc nối thêm vào AGENTS.md trong không gian làm việc của tác tử OpenClaw.
  • Nội dung ~/.claude/CLAUDE.md của người dùng được nối thêm vào USER.md trong không gian làm việc.
Các định nghĩa máy chủ MCP được nhập từ .mcp.json của dự án, ~/.claude.json của Claude Code và claude_desktop_config.json của Claude Desktop khi có.
  • Các Skills Claude có tệp SKILL.md được sao chép vào thư mục Skills trong không gian làm việc OpenClaw.
  • Các tệp Markdown lệnh Claude trong .claude/commands/ hoặc ~/.claude/commands/ được chuyển đổi thành Skills OpenClaw với disable-model-invocation: true.

​
Nội dung chỉ được lưu trữ

Trình cung cấp sao chép các nội dung sau vào báo cáo di chuyển để xem xét thủ công, nhưng không tải chúng vào cấu hình OpenClaw đang hoạt động:
  • Hook Claude
  • Quyền Claude và danh sách cho phép công cụ phạm vi rộng
  • Giá trị mặc định của môi trường Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Các tác tử con Claude trong .claude/agents/ hoặc ~/.claude/agents/
  • Bộ nhớ đệm, kế hoạch và thư mục lịch sử dự án của Claude Code
  • Tiện ích mở rộng Claude Desktop và thông tin xác thực được lưu trong hệ điều hành
OpenClaw từ chối tự động thực thi hook, tin cậy danh sách cho phép quyền hoặc giải mã trạng thái thông tin xác thực OAuth và Desktop không rõ cấu trúc. Sau khi xem xét kho lưu trữ, hãy di chuyển thủ công những nội dung bạn cần.

​
Chọn nguồn

Nếu không có --from, OpenClaw kiểm tra thư mục chính Claude Code mặc định tại ~/.claude, tệp trạng thái mẫu ~/.claude.json của Claude Code và cấu hình MCP của Claude Desktop trên macOS. Khi --from trỏ đến thư mục gốc dự án, OpenClaw chỉ nhập các tệp Claude của dự án đó, chẳng hạn như CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ và .mcp.json. Trong quá trình nhập từ thư mục gốc dự án, OpenClaw không đọc thư mục chính Claude toàn cục của bạn.

​
Quy trình được khuyến nghị

1

Xem trước kế hoạch

Kế hoạch liệt kê mọi nội dung sẽ thay đổi, bao gồm xung đột, các mục bị bỏ qua và các giá trị nhạy cảm đã được che trong các trường MCP env hoặc headers lồng nhau.
2

Áp dụng kèm bản sao lưu

OpenClaw tạo và xác minh bản sao lưu trước khi áp dụng.
3

Chạy doctor

Doctor kiểm tra các vấn đề về cấu hình hoặc trạng thái sau khi nhập.
4

Khởi động lại và xác minh

Xác nhận Gateway hoạt động bình thường và các hướng dẫn, máy chủ MCP cùng Skills đã nhập được tải thành công.

​
Xử lý xung đột

Thao tác áp dụng từ chối tiếp tục khi kế hoạch báo cáo xung đột (một tệp hoặc giá trị cấu hình đã tồn tại tại đích).
Chỉ chạy lại với --overwrite khi bạn chủ ý thay thế đích hiện có. Trình cung cấp vẫn có thể ghi bản sao lưu cấp mục cho các tệp bị ghi đè vào thư mục báo cáo di chuyển.
Đối với bản cài đặt OpenClaw mới, xung đột hiếm khi xảy ra. Chúng thường xuất hiện khi bạn chạy lại quá trình nhập trên một bản thiết lập đã có chỉnh sửa của người dùng.

​
Đầu ra JSON cho tự động hóa

--yes là bắt buộc đối với migrate apply bên ngoài thiết bị đầu cuối tương tác; nếu không có cờ này, OpenClaw sẽ báo lỗi thay vì áp dụng, vì vậy tập lệnh và CI phải truyền --yes một cách rõ ràng. Trước tiên hãy xem trước bằng --dry-run --json, sau đó áp dụng bằng --json --yes khi kế hoạch đã phù hợp.

​
Khắc phục sự cố

Truyền --from /actual/path (CLI) hoặc --import-source /actual/path (thiết lập ban đầu).
Việc nhập trong quá trình thiết lập ban đầu yêu cầu một bản thiết lập mới. Hãy đặt lại trạng thái và thực hiện lại quá trình thiết lập ban đầu, hoặc sử dụng trực tiếp openclaw migrate apply claude, lệnh này hỗ trợ --overwrite và khả năng kiểm soát bản sao lưu rõ ràng.
Claude Desktop đọc claude_desktop_config.json từ đường dẫn dành riêng cho từng nền tảng. Hãy trỏ --from đến thư mục chứa tệp đó nếu OpenClaw không tự động phát hiện được.
Đây là hành vi theo thiết kế. Các lệnh Claude do người dùng kích hoạt, vì vậy OpenClaw nhập chúng dưới dạng Skills với disable-model-invocation: true. Chỉnh sửa frontmatter của từng Skill nếu bạn muốn tác tử tự động gọi chúng.

​
Liên quan