Maintenance
การย้ายจาก Claude
OpenClaw นำเข้าสถานะ Claude ภายในเครื่องผ่านผู้ให้บริการย้ายข้อมูล Claude ที่รวมมาให้ ผู้ให้บริการจะแสดงตัวอย่างทุกรายการก่อนเปลี่ยนแปลงสถานะ ปกปิดข้อมูลลับในแผนและรายงาน และสร้างข้อมูลสำรองที่ผ่านการตรวจสอบก่อนนำการเปลี่ยนแปลงไปใช้
สองวิธีในการนำเข้า
ตัวช่วยสร้างการเริ่มต้นใช้งาน
ตัวช่วยสร้างจะเสนอตัวเลือก Claude เมื่อตรวจพบสถานะ Claude ภายในเครื่อง
openclaw onboard --flow importหรือระบุแหล่งที่มาเฉพาะ:
openclaw onboard --import-from claude --import-source ~/.claudeCLI
ใช้ openclaw migrate สำหรับการทำงานแบบสคริปต์หรือการทำงานซ้ำได้ ดูข้อมูลอ้างอิงฉบับเต็มที่ openclaw migrate
openclaw migrate claude --dry-runopenclaw migrate apply claude --yesเพิ่ม --from <path> เพื่อนำเข้าโฮม Claude Code หรือรากโปรเจกต์ที่ระบุ
สิ่งที่จะถูกนำเข้า
คำสั่งและหน่วยความจำ
- เนื้อหา
CLAUDE.mdและ.claude/CLAUDE.mdของโปรเจกต์จะถูกคัดลอกหรือต่อท้ายในAGENTS.mdของพื้นที่ทำงานเอเจนต์ OpenClaw - เนื้อหา
~/.claude/CLAUDE.mdของผู้ใช้จะถูกต่อท้ายในUSER.mdของพื้นที่ทำงาน
เซิร์ฟเวอร์ MCP
คำนิยามเซิร์ฟเวอร์ MCP จะถูกนำเข้าจาก .mcp.json ของโปรเจกต์, ~/.claude.json ของ Claude Code และ claude_desktop_config.json ของ Claude Desktop เมื่อมีไฟล์เหล่านี้
Skills และคำสั่ง
- Skills ของ Claude ที่มีไฟล์
SKILL.mdจะถูกคัดลอกไปยังไดเรกทอรี Skills ในพื้นที่ทำงาน OpenClaw - ไฟล์ Markdown คำสั่งของ Claude ภายใต้
.claude/commands/หรือ~/.claude/commands/จะถูกแปลงเป็น Skills ของ OpenClaw พร้อมdisable-model-invocation: true
สิ่งที่เก็บไว้เฉพาะในคลัง
ผู้ให้บริการจะคัดลอกรายการต่อไปนี้ไปยังรายงานการย้ายข้อมูลเพื่อตรวจสอบด้วยตนเอง แต่จะ ไม่ โหลดรายการเหล่านี้เข้าสู่การกำหนดค่า OpenClaw ที่ใช้งานอยู่:
- ฮุกของ Claude
- สิทธิ์ของ Claude และรายการอนุญาตเครื่องมือแบบกว้าง
- ค่าเริ่มต้นของสภาพแวดล้อม Claude
CLAUDE.local.md.claude/rules/- เอเจนต์ย่อยของ Claude ภายใต้
.claude/agents/หรือ~/.claude/agents/ - ไดเรกทอรีแคช แผน และประวัติโปรเจกต์ของ Claude Code
- ส่วนขยาย Claude Desktop และข้อมูลประจำตัวที่จัดเก็บโดยระบบปฏิบัติการ
OpenClaw ปฏิเสธที่จะเรียกใช้ฮุก เชื่อถือรายการอนุญาตสิทธิ์ หรือถอดรหัสสถานะข้อมูลประจำตัว OAuth และ Desktop ที่ไม่โปร่งใสโดยอัตโนมัติ ให้ย้ายสิ่งที่คุณต้องการด้วยตนเองหลังจากตรวจสอบคลังแล้ว
การเลือกแหล่งที่มา
หากไม่มี --from OpenClaw จะตรวจสอบโฮม Claude Code เริ่มต้นที่ ~/.claude ไฟล์สถานะตัวอย่างของ Claude Code ที่ ~/.claude.json และการกำหนดค่า MCP ของ Claude Desktop บน macOS
เมื่อ --from ชี้ไปยังรากโปรเจกต์ OpenClaw จะนำเข้าเฉพาะไฟล์ Claude ของโปรเจกต์นั้น เช่น CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ และ .mcp.json โดยจะไม่อ่านโฮม Claude ส่วนกลางของคุณระหว่างการนำเข้าจากรากโปรเจกต์
ขั้นตอนที่แนะนำ
ดูตัวอย่างแผน
openclaw migrate claude --dry-runแผนจะแสดงรายการทุกสิ่งที่จะเปลี่ยนแปลง รวมถึงข้อขัดแย้ง รายการที่ข้าม และค่าที่ละเอียดอ่อนซึ่งถูกปกปิดจากฟิลด์ MCP env หรือ headers ที่ซ้อนกัน
นำไปใช้พร้อมข้อมูลสำรอง
openclaw migrate apply claude --yesOpenClaw จะสร้างและตรวจสอบข้อมูลสำรองก่อนนำการเปลี่ยนแปลงไปใช้
เรียกใช้ Doctor
openclaw doctorDoctor จะตรวจหาปัญหาการกำหนดค่าหรือสถานะหลังการนำเข้า
เริ่มใหม่และตรวจสอบ
openclaw gateway restartopenclaw statusยืนยันว่า Gateway ทำงานเป็นปกติ และคำสั่ง เซิร์ฟเวอร์ MCP และ Skills ที่นำเข้าได้รับการโหลดแล้ว
การจัดการข้อขัดแย้ง
การนำไปใช้จะปฏิเสธที่จะดำเนินการต่อเมื่อแผนรายงานข้อขัดแย้ง (มีไฟล์หรือค่าการกำหนดค่าอยู่ที่ปลายทางแล้ว)
สำหรับการติดตั้ง OpenClaw ใหม่ ข้อขัดแย้งพบได้ไม่บ่อย โดยทั่วไปจะปรากฏเมื่อคุณเรียกใช้การนำเข้าอีกครั้งในการตั้งค่าที่มีการแก้ไขโดยผู้ใช้อยู่แล้ว
เอาต์พุต JSON สำหรับระบบอัตโนมัติ
openclaw migrate claude --dry-run --jsonopenclaw migrate apply claude --json --yesจำเป็นต้องใช้ --yes สำหรับ migrate apply นอกเทอร์มินัลแบบโต้ตอบ หากไม่มีตัวเลือกนี้ OpenClaw จะแจ้งข้อผิดพลาดแทนการนำไปใช้ ดังนั้นสคริปต์และ CI ต้องส่ง --yes อย่างชัดเจน ดูตัวอย่างก่อนด้วย --dry-run --json แล้วจึงนำไปใช้ด้วย --json --yes เมื่อแผนถูกต้องแล้ว
การแก้ไขปัญหา
สถานะ Claude อยู่ภายนอก ~/.claude
ส่ง --from /actual/path (CLI) หรือ --import-source /actual/path (การเริ่มต้นใช้งาน)
การเริ่มต้นใช้งานปฏิเสธการนำเข้าในการตั้งค่าที่มีอยู่
การนำเข้าผ่านการเริ่มต้นใช้งานต้องใช้การตั้งค่าใหม่ ให้รีเซ็ตสถานะและเริ่มต้นใช้งานใหม่ หรือใช้ openclaw migrate apply claude โดยตรง ซึ่งรองรับ --overwrite และการควบคุมข้อมูลสำรองอย่างชัดเจน
เซิร์ฟเวอร์ MCP จาก Claude Desktop ไม่ถูกนำเข้า
Claude Desktop อ่าน claude_desktop_config.json จากเส้นทางเฉพาะแพลตฟอร์ม ให้ชี้ --from ไปยังไดเรกทอรีของไฟล์นั้น หาก OpenClaw ตรวจไม่พบโดยอัตโนมัติ
คำสั่ง Claude กลายเป็น Skills ที่ปิดการเรียกใช้โดยโมเดล
เป็นพฤติกรรมที่ออกแบบไว้ คำสั่ง Claude ถูกเรียกใช้โดยผู้ใช้ ดังนั้น OpenClaw จึงนำเข้าเป็น Skills พร้อม disable-model-invocation: true แก้ไข frontmatter ของแต่ละ Skill หากคุณต้องการให้เอเจนต์เรียกใช้โดยอัตโนมัติ
ที่เกี่ยวข้อง
openclaw migrate: ข้อมูลอ้างอิง CLI ฉบับเต็ม สัญญา Plugin และโครงสร้าง JSON- คู่มือการย้ายข้อมูล: เส้นทางการย้ายข้อมูลทั้งหมด
- การย้ายจาก Hermes: เส้นทางการนำเข้าข้ามระบบอีกเส้นทางหนึ่ง
- การเริ่มต้นใช้งาน: ขั้นตอนตัวช่วยสร้างและแฟล็กแบบไม่โต้ตอบ
- Doctor: การตรวจสอบสถานะระบบหลังการย้ายข้อมูล
- พื้นที่ทำงานของเอเจนต์: ตำแหน่งที่จัดเก็บ
AGENTS.md,USER.mdและ Skills