Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw hỗ trợ ba lộ trình di chuyển: nhập từ một hệ thống agent khác, chuyển một bản cài đặt hiện có sang máy mới, và nâng cấp Plugin tại chỗ.

​
Nhập từ hệ thống agent khác

Dùng các nhà cung cấp di chuyển được tích hợp sẵn để đưa hướng dẫn, máy chủ MCP, Skills, cấu hình mô hình, và khóa API (tùy chọn) vào OpenClaw. Các kế hoạch được xem trước trước khi có bất kỳ thay đổi nào, bí mật được che trong báo cáo, và thao tác áp dụng được bảo vệ bằng một bản sao lưu đã xác minh.

Migrating from Claude

Nhập trạng thái Claude Code và Claude Desktop, bao gồm CLAUDE.md, máy chủ MCP, Skills, và lệnh dự án.

Migrating from Hermes

Nhập cấu hình Hermes, nhà cung cấp, máy chủ MCP, bộ nhớ, Skills, và các khóa .env được hỗ trợ.
Điểm vào CLI là openclaw migrate. Quy trình thiết lập ban đầu cũng có thể đề xuất di chuyển khi phát hiện một nguồn đã biết (openclaw onboard --flow import).

​
Chuyển OpenClaw sang máy mới

Sao chép thư mục trạng thái (~/.openclaw/ theo mặc định) và workspace của bạn để giữ lại:
  • Cấu hình — openclaw.json và mọi thiết lập Gateway.
  • Xác thực — auth-profiles.json theo từng agent (khóa API cộng với OAuth), cùng mọi trạng thái kênh hoặc nhà cung cấp trong credentials/.
  • Phiên — lịch sử hội thoại và trạng thái agent.
  • Trạng thái kênh — đăng nhập WhatsApp, phiên Telegram, và các trạng thái tương tự.
  • Tệp workspace — MEMORY.md, USER.md, Skills, và prompt.
Chạy openclaw status trên máy cũ để xác nhận đường dẫn thư mục trạng thái của bạn. Hồ sơ tùy chỉnh dùng ~/.openclaw-<profile>/ hoặc một đường dẫn được đặt qua OPENCLAW_STATE_DIR.

​
Các bước di chuyển

1

Stop the gateway and back up

Trên máy cũ, dừng Gateway để tệp không thay đổi giữa lúc sao chép, rồi lưu trữ:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
Nếu bạn dùng nhiều hồ sơ (ví dụ ~/.openclaw-work), hãy lưu trữ từng hồ sơ riêng.
2

Install OpenClaw on the new machine

Cài đặt CLI (và Node nếu cần) trên máy mới. Không sao nếu quy trình thiết lập ban đầu tạo một ~/.openclaw/ mới. Bạn sẽ ghi đè thư mục đó ở bước tiếp theo.
3

Copy state directory and workspace

Chuyển tệp lưu trữ qua scp, rsync -a, hoặc ổ đĩa ngoài, rồi giải nén:
cd ~
tar -xzf openclaw-state.tgz
Đảm bảo các thư mục ẩn đã được đưa vào và quyền sở hữu tệp khớp với người dùng sẽ chạy Gateway.
4

Run doctor and verify

Trên máy mới, chạy Doctor để áp dụng di chuyển cấu hình và sửa chữa dịch vụ:
openclaw doctor
openclaw gateway restart
openclaw status

​
Lỗi thường gặp

Nếu Gateway cũ dùng --profile hoặc OPENCLAW_STATE_DIR còn Gateway mới thì không, các kênh sẽ trông như đã đăng xuất và phiên sẽ trống. Khởi chạy Gateway với cùng hồ sơ hoặc thư mục trạng thái bạn đã di chuyển, rồi chạy lại openclaw doctor.
Chỉ riêng tệp cấu hình là chưa đủ. Hồ sơ xác thực mô hình nằm trong agents/<agentId>/agent/auth-profiles.json, còn trạng thái kênh và nhà cung cấp nằm trong credentials/. Luôn di chuyển toàn bộ thư mục trạng thái.
Nếu bạn sao chép bằng root hoặc đổi người dùng, Gateway có thể không đọc được thông tin xác thực. Đảm bảo thư mục trạng thái và workspace thuộc sở hữu của người dùng chạy Gateway.
Nếu UI của bạn trỏ tới một Gateway từ xa, máy chủ từ xa sở hữu các phiên và workspace. Hãy di chuyển chính máy chủ Gateway, không phải laptop cục bộ của bạn. Xem Câu hỏi thường gặp.
Thư mục trạng thái chứa hồ sơ xác thực, thông tin xác thực kênh, và trạng thái nhà cung cấp khác. Hãy lưu bản sao lưu ở dạng mã hóa, tránh các kênh truyền không an toàn, và xoay vòng khóa nếu bạn nghi ngờ bị lộ.

​
Danh sách kiểm tra xác minh

Trên máy mới, xác nhận:
  • openclaw status hiển thị Gateway đang chạy.
  • Các kênh vẫn được kết nối (không cần ghép đôi lại).
  • Bảng điều khiển mở được và hiển thị các phiên hiện có.
  • Các tệp workspace (bộ nhớ, cấu hình) có mặt.

​
Nâng cấp Plugin tại chỗ

Nâng cấp Plugin tại chỗ giữ nguyên cùng id Plugin và khóa cấu hình, nhưng có thể chuyển trạng thái trên đĩa sang bố cục hiện tại. Hướng dẫn nâng cấp riêng cho từng Plugin nằm cùng với kênh của chúng:
  • Di chuyển Matrix: giới hạn khôi phục trạng thái đã mã hóa, hành vi snapshot tự động, và lệnh khôi phục thủ công.

​
Liên quan