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 nhập trạng thái Claude cục bộ thông qua nhà cung cấp di chuyển Claude được đóng gói kèm. Nhà cung cấp xem trước mọi mục trước khi thay đổi trạng thái, che giấu bí mật trong kế hoạch và báo cáo, đồng thời tạo bản sao lưu đã 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ộ, hãy đặt lại cấu hình, thông tin xác thực, phiên và workspace trước, hoặc dùng trực tiếp openclaw migrate với --overwrite sau khi xem lại kế hoạch.

​
Hai cách để nhập

Trình hướng dẫn sẽ đề xuất Claude khi phát hiện trạng thái Claude cục bộ.
openclaw onboard --flow import
Hoặc trỏ đến một nguồn cụ thể:
openclaw onboard --import-from claude --import-source ~/.claude

​
Những gì được nhập

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

​
Những gì chỉ lưu trữ

Nhà cung cấp sao chép các mục này 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 môi trường Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Tác nhân phụ 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 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 OAuth mờ và thông tin xác thực Desktop. Hãy chuyển thủ công những gì bạn cần sau khi xem lại kho lưu trữ.

​
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 Claude Code mẫu ~/.claude.json, 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 đó như CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ và .mcp.json. Nó không đọc thư mục chính Claude toàn cục của bạn trong quá trình nhập từ thư mục gốc dự án.

​
Quy trình khuyến nghị

1

Xem trước kế hoạch

openclaw migrate claude --dry-run
Kế hoạch liệt kê mọi thứ sẽ thay đổi, bao gồm xung đột, mục bị bỏ qua và các giá trị nhạy cảm đã được che giấu khỏi các trường MCP env hoặc headers lồng nhau.
2

Áp dụng với bản sao lưu

openclaw migrate apply claude --yes
OpenClaw tạo và xác minh một bản sao lưu trước khi áp dụng.
3

Chạy doctor

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

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

openclaw gateway restart
openclaw status
Xác nhận Gateway khỏe mạnh và các hướng dẫn, máy chủ MCP, cùng Skills đã nhập của bạn đã được tải.

​
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ó. 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 đè trong thư mục báo cáo di chuyển.
Với một 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 thao tác 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

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
Với --json và không có --yes, thao tác áp dụng in kế hoạch và không thay đổi trạng thái. Đây là chế độ an toàn nhất cho CI và script dùng chung.

​
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à thiết lập lại, hoặc dùng trực tiếp openclaw migrate apply claude, lệnh này hỗ trợ --overwrite và kiểm soát bản sao lưu rõ ràng.
Claude Desktop đọc claude_desktop_config.json từ một đường dẫn riêng theo nền tảng. Trỏ --from đến thư mục của tệp đó nếu OpenClaw không tự động phát hiện.
Đây là thiết kế chủ đích. 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 nhân tự động gọi chúng.

​
Liên quan