openclaw migrate

นำเข้าสถานะจากระบบเอเจนต์อื่นผ่านผู้ให้บริการการย้ายที่ Plugin เป็นเจ้าของ ผู้ให้บริการที่มาพร้อมระบบครอบคลุมสถานะ Codex CLI, Claude และ Hermes; Plugin จากภายนอกสามารถลงทะเบียนผู้ให้บริการเพิ่มเติมได้

คำสั่ง

openclaw migrate listopenclaw migrate claude --dry-runopenclaw migrate codex --dry-runopenclaw migrate codex --skill gog-vault77-google-workspaceopenclaw migrate codex --plugin google-calendar --dry-runopenclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-runopenclaw migrate hermes --dry-runopenclaw migrate hermesopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --plugin google-calendaropenclaw migrate apply codex --yesopenclaw migrate apply claude --yesopenclaw migrate apply hermes --yesopenclaw migrate apply hermes --include-secrets --yesopenclaw onboard --flow importopenclaw onboard --import-from claude --import-source ~/.claudeopenclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> ชื่อของผู้ให้บริการการย้ายที่ลงทะเบียนไว้ เช่น hermes เรียกใช้ openclaw migrate list เพื่อดูผู้ให้บริการที่ติดตั้งอยู่

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> แทนที่ไดเรกทอรีสถานะต้นทาง ค่าเริ่มต้นของ Hermes คือ ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> เลือกรายการติดตั้ง Plugin ของ Codex หนึ่งรายการตามชื่อ Plugin หรือ item id ใช้แฟล็กซ้ำเพื่อย้าย Plugin ของ Codex หลายรายการ เมื่อไม่ระบุ การย้าย Codex แบบโต้ตอบจะแสดงตัวเลือก Plugin ของ Codex แบบเนทีฟในรูปแบบช่องทำเครื่องหมาย และการย้ายแบบไม่โต้ตอบจะคง Plugin ที่วางแผนไว้ทั้งหมด สิ่งนี้ใช้เฉพาะกับ Plugin ของ Codex แบบ openai-curated ที่ติดตั้งจากต้นทางและค้นพบโดย inventory ของ Codex app-server เท่านั้น

โมเดลความปลอดภัย

openclaw migrate เป็นแบบดูตัวอย่างก่อน

ผู้ให้บริการ Claude

ผู้ให้บริการ Claude ที่มาพร้อมระบบจะตรวจหาสถานะ Claude Code ที่ ~/.claude เป็นค่าเริ่มต้น ใช้ --from <path> เพื่อนำเข้า Claude Code home หรือ project root เฉพาะ

สิ่งที่ Claude นำเข้า

• Project CLAUDE.md และ .claude/CLAUDE.md เข้าสู่พื้นที่ทำงานเอเจนต์ของ OpenClaw
• User ~/.claude/CLAUDE.md ต่อท้ายไปยัง workspace USER.md
• นิยาม MCP server จาก project .mcp.json, Claude Code ~/.claude.json และ Claude Desktop claude_desktop_config.json
• ไดเรกทอรี skill ของ Claude ที่มี SKILL.md
• ไฟล์ Markdown คำสั่งของ Claude ที่แปลงเป็น OpenClaw skills พร้อมการเรียกใช้แบบแมนนวลเท่านั้น

สถานะ archive และการตรวจสอบแบบแมนนวล

Claude hooks, permissions, environment defaults, local memory, rules ตามขอบเขต path, subagents, caches, plans และ project history จะถูกเก็บไว้ในรายงานการย้ายหรือรายงานเป็นรายการที่ต้องตรวจสอบแบบแมนนวล OpenClaw จะไม่รัน hooks, คัดลอก allowlists แบบกว้าง หรือนำเข้าสถานะข้อมูลประจำตัว OAuth/Desktop โดยอัตโนมัติ

ผู้ให้บริการ Codex

ผู้ให้บริการ Codex ที่มาพร้อมระบบจะตรวจหาสถานะ Codex CLI ที่ ~/.codex เป็นค่าเริ่มต้น หรือ ที่ CODEX_HOME เมื่อตั้งค่าตัวแปรสภาพแวดล้อมนั้น ใช้ --from <path> เพื่อ ทำ inventory ของ Codex home เฉพาะ

ใช้ผู้ให้บริการนี้เมื่อย้ายไปยัง OpenClaw Codex harness และคุณต้องการ ยกระดับสินทรัพย์ Codex CLI ส่วนตัวที่มีประโยชน์อย่างตั้งใจ การเปิด Codex app-server ภายในเครื่อง ใช้ CODEX_HOME ต่อเอเจนต์ ดังนั้นจึงไม่อ่าน ~/.codex ส่วนตัวของคุณ เป็นค่าเริ่มต้น กระบวนการปกติยังคงสืบทอด HOME ดังนั้น Codex จึงมองเห็นรายการ skills/marketplace ของ Plugin ที่แชร์ใน $HOME/.agents/* และ subprocesses สามารถค้นหา config และ tokens ใน user-home ได้

การเรียกใช้ openclaw migrate codex ในเทอร์มินัลแบบโต้ตอบจะแสดงตัวอย่าง แผนทั้งหมด จากนั้นเปิดตัวเลือกแบบช่องทำเครื่องหมายก่อนการยืนยัน apply ขั้นสุดท้าย ระบบจะถาม รายการคัดลอก skill ก่อน ใช้ Toggle all on หรือ Toggle all off สำหรับการเลือกแบบกลุ่ม กด Space เพื่อสลับแถว หรือกด Enter เพื่อเปิดใช้งานแถวที่ไฮไลต์ แล้วดำเนินต่อ skills ที่วางแผนไว้จะเริ่มต้นด้วยสถานะ checked, skills ที่ขัดแย้งจะเริ่มต้น unchecked และ Skip for now จะข้ามการคัดลอก skill สำหรับการรันนี้โดยยังดำเนินต่อไปยังการเลือก Plugin เมื่อ Plugin ของ Codex แบบ curated ที่ติดตั้งจากต้นทางสามารถย้ายได้และ ไม่ได้ระบุ --plugin การย้ายจะถามต่อสำหรับการเปิดใช้งาน Plugin ของ Codex แบบเนทีฟ ตามชื่อ Plugin รายการ Plugin จะเริ่มต้น checked เว้นแต่ config ของ Plugin Codex ใน OpenClaw เป้าหมายมี Plugin นั้นอยู่แล้ว Plugin เป้าหมายที่มีอยู่จะเริ่มต้น unchecked และแสดงคำใบ้ความขัดแย้ง เช่น conflict: plugin exists; เลือก Toggle all off เพื่อไม่ย้าย Plugin ของ Codex แบบเนทีฟ ในการรันนั้น หรือ Skip for now เพื่อหยุดก่อน apply สำหรับการรันแบบสคริปต์หรือ แบบเจาะจง ให้ส่ง --skill <name> หนึ่งครั้งต่อ skill เช่น:

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

ใช้ --plugin <name> เพื่อจำกัดการย้าย Plugin ของ Codex แบบเนทีฟในโหมดไม่โต้ตอบ เป็น Plugin curated ที่ติดตั้งจากต้นทางหนึ่งรายการหรือมากกว่า:

openclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

สิ่งที่ Codex นำเข้า

• ไดเรกทอรี skill ของ Codex CLI ใต้ $CODEX_HOME/skills ยกเว้น cache .system ของ Codex
• AgentSkills ส่วนตัวใต้ $HOME/.agents/skills ซึ่งคัดลอกเข้าสู่พื้นที่ทำงาน เอเจนต์ OpenClaw ปัจจุบันเมื่อคุณต้องการการเป็นเจ้าของต่อเอเจนต์
• Plugin ของ Codex แบบ openai-curated ที่ติดตั้งจากต้นทางและค้นพบผ่าน plugin/list ของ Codex app-server การวางแผนจะอ่าน plugin/read สำหรับแต่ละ Plugin ที่ติดตั้งและเปิดใช้งานอยู่ Plugin ที่มี app หนุนหลังต้องการให้ response บัญชี Codex app-server ต้นทางเป็นบัญชีสมัครสมาชิก ChatGPT; response บัญชีที่ไม่ใช่ ChatGPT หรือไม่มีจะถูกข้ามด้วย codex_subscription_required โดยค่าเริ่มต้น การย้ายจะไม่เรียก app/list ต้นทาง ดังนั้น Plugin ที่มี app หนุนหลังซึ่งผ่าน account gate จะถูกวางแผนโดยไม่มีการตรวจสอบการเข้าถึง app ต้นทาง และ ความล้มเหลวของ transport ในการค้นหาบัญชีจะถูกข้ามด้วย codex_account_unavailable ส่ง --verify-plugin-apps เมื่อคุณต้องการให้การย้ายบังคับ snapshot app/list ต้นทางใหม่ และกำหนดให้ทุก app ที่เป็นเจ้าของต้องมีอยู่ เปิดใช้งาน และ เข้าถึงได้ก่อนวางแผนการเปิดใช้งานแบบเนทีฟ ในโหมดนั้น ความล้มเหลวของ transport ในการค้นหาบัญชีจะส่งต่อไปยังการตรวจสอบ inventory ของ app ต้นทาง snapshot inventory ของ app ต้นทางจะถูกเก็บไว้ในหน่วยความจำสำหรับกระบวนการปัจจุบัน; จะ ไม่ถูกเขียนไปยังเอาต์พุตการย้ายหรือ config เป้าหมาย Plugin ที่ปิดใช้งาน, รายละเอียด Plugin ที่อ่านไม่ได้, บัญชีต้นทางที่ติด subscription gate และเมื่อ ขอการตรวจสอบ app ที่หายไป, app ที่ปิดใช้งาน, app ที่เข้าถึงไม่ได้ หรือ ความล้มเหลวของ inventory app ต้นทาง จะกลายเป็นรายการที่ข้ามแบบแมนนวลพร้อมเหตุผล ที่มีชนิด แทนที่จะเป็นรายการ config เป้าหมาย apply จะเรียก plugin/install ของ app-server สำหรับ Plugin ที่เลือกและมีสิทธิ์แต่ละรายการ แม้ว่า app-server เป้าหมายจะรายงานว่า Plugin นั้นติดตั้งและ เปิดใช้งานอยู่แล้ว Plugin ของ Codex ที่ย้ายแล้วใช้ได้เฉพาะในเซสชันที่เลือก native Codex harness; ไม่ถูกเปิดเผยให้กับ OpenClaw provider runs, ACP conversation bindings หรือ harness อื่น ๆ

สถานะ Codex ที่ต้องตรวจสอบแบบแมนนวล

Codex config.toml, hooks/hooks.json แบบเนทีฟ, marketplaces ที่ไม่ใช่ curated, cached plugin bundles ที่ไม่ใช่ Plugin curated ที่ติดตั้งจากต้นทาง และ Plugin ที่ติดตั้งจากต้นทาง ซึ่งไม่ผ่าน source subscription gate จะไม่ถูกเปิดใช้งานโดยอัตโนมัติ เมื่อมีการตั้งค่า --verify-plugin-apps Plugin ที่ไม่ผ่าน source app-inventory gate จะถูกข้ามด้วยเช่นกัน รายการเหล่านี้จะถูกคัดลอกหรือรายงานในรายงานการย้ายเพื่อ ตรวจสอบแบบแมนนวล

สำหรับ Plugin curated ที่ติดตั้งจากต้นทางและถูกย้าย apply จะเขียน:

• plugins.entries.codex.enabled: true
• plugins.entries.codex.config.codexPlugins.enabled: true
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
• รายการ Plugin ชัดเจนหนึ่งรายการพร้อม marketplaceName: "openai-curated" และ pluginName สำหรับแต่ละ Plugin ที่เลือก

การย้ายข้อมูลจะไม่เขียน plugins["*"] และจะไม่จัดเก็บพาธแคช marketplace ภายในเครื่อง ความล้มเหลวของการสมัครใช้งานฝั่งต้นทางจะถูกรายงานในรายการแบบกำหนดเองพร้อมเหตุผลที่มีชนิด เช่น codex_subscription_required, codex_account_unavailable, plugin_disabled หรือ plugin_read_unavailable เมื่อใช้ --verify-plugin-apps ความล้มเหลวของ app-inventory ต้นทางอาจปรากฏเป็น app_inaccessible, app_disabled, app_missing หรือ app_inventory_unavailable ได้เช่นกัน Plugin ที่ถูกข้าม จะไม่ถูกเขียนลงในการกำหนดค่าเป้าหมาย การติดตั้งฝั่งเป้าหมายที่ต้องใช้การยืนยันตัวตนจะถูกรายงานในรายการ Plugin ที่ได้รับผลกระทบพร้อม status: "skipped", reason: "auth_required" และตัวระบุแอปที่ผ่านการล้างข้อมูลแล้ว รายการกำหนดค่าแบบชัดเจนของรายการเหล่านั้นจะถูกเขียนเป็นปิดใช้งานไว้จนกว่าคุณจะอนุญาตอีกครั้งและ เปิดใช้งาน รายการติดตั้งล้มเหลวอื่นๆ จะเป็นผลลัพธ์ error ที่จำกัดขอบเขตตามรายการ

หากคลัง Plugin ของ app-server ของ Codex ไม่พร้อมใช้งานระหว่างการวางแผน การย้ายข้อมูล จะถอยกลับไปใช้รายการคำแนะนำ bundle ที่แคชไว้แทนที่จะทำให้การย้ายข้อมูลทั้งหมดล้มเหลว

ผู้ให้บริการ Hermes

ผู้ให้บริการ Hermes ที่รวมมาในตัวจะตรวจหาสถานะที่ ~/.hermes ตามค่าเริ่มต้น ใช้ --from <path> เมื่อ Hermes อยู่ที่อื่น

สิ่งที่ Hermes นำเข้า

• การกำหนดค่าโมเดลเริ่มต้นจาก config.yaml
• ผู้ให้บริการโมเดลที่กำหนดค่าไว้และ endpoint แบบกำหนดเองที่เข้ากันได้กับ OpenAI จาก providers และ custom_providers
• คำจำกัดความเซิร์ฟเวอร์ MCP จาก mcp_servers หรือ mcp.servers
• SOUL.md และ AGENTS.md เข้าสู่พื้นที่ทำงานของเอเจนต์ OpenClaw
• memories/MEMORY.md และ memories/USER.md ที่ผนวกเข้ากับไฟล์หน่วยความจำของพื้นที่ทำงาน
• ค่าเริ่มต้นการกำหนดค่าหน่วยความจำสำหรับหน่วยความจำไฟล์ของ OpenClaw รวมถึงรายการเก็บถาวรหรือรายการตรวจทานด้วยตนเองสำหรับผู้ให้บริการหน่วยความจำภายนอก เช่น Honcho
• Skills ที่มีไฟล์ SKILL.md อยู่ใต้ skills/<name>/
• ค่ากำหนดค่าแยกตาม Skills จาก skills.config
• ข้อมูลประจำตัว OpenAI OAuth ของ OpenCode จาก auth.json ของ OpenCode เมื่อยอมรับการย้ายข้อมูลประจำตัวแบบโต้ตอบ หรือเมื่อมีการตั้งค่า --include-secrets รายการ OAuth ใน auth.json ของ Hermes เป็นสถานะเดิมที่รายงานเพื่อให้ยืนยันตัวตน OpenAI ใหม่ด้วยตนเองหรือซ่อมแซมด้วย doctor
• API keys และ tokens ที่รองรับจาก .env ของ Hermes และ auth.json ของ OpenCode เมื่อยอมรับการย้ายข้อมูลประจำตัวแบบโต้ตอบ หรือเมื่อมีการตั้งค่า --include-secrets

คีย์ .env ที่รองรับ

• AI_GATEWAY_API_KEY
• ALIBABA_API_KEY
• ANTHROPIC_API_KEY
• ARCEEAI_API_KEY
• CEREBRAS_API_KEY
• CHUTES_API_KEY
• CLOUDFLARE_AI_GATEWAY_API_KEY
• COPILOT_GITHUB_TOKEN
• DASHSCOPE_API_KEY
• DEEPINFRA_API_KEY
• DEEPSEEK_API_KEY
• FIREWORKS_API_KEY
• GEMINI_API_KEY
• GH_TOKEN
• GITHUB_TOKEN
• GLM_API_KEY
• GOOGLE_API_KEY
• GROQ_API_KEY
• HF_TOKEN
• HUGGINGFACE_HUB_TOKEN
• KILOCODE_API_KEY
• KIMICODE_API_KEY
• KIMI_API_KEY
• MINIMAX_API_KEY
• MINIMAX_CODING_API_KEY
• MISTRAL_API_KEY
• MODELSTUDIO_API_KEY
• MOONSHOT_API_KEY
• NVIDIA_API_KEY
• OPENAI_API_KEY
• OPENCODE_API_KEY
• OPENCODE_GO_API_KEY
• OPENCODE_ZEN_API_KEY
• OPENROUTER_API_KEY
• QIANFAN_API_KEY
• QWEN_API_KEY
• TOGETHER_API_KEY
• VENICE_API_KEY
• XAI_API_KEY
• XIAOMI_API_KEY
• ZAI_API_KEY
• Z_AI_API_KEY

สถานะแบบเก็บถาวรเท่านั้น

สถานะ Hermes ที่ OpenClaw ไม่สามารถตีความได้อย่างปลอดภัยจะถูกคัดลอกลงในรายงานการย้ายข้อมูลเพื่อการตรวจทานด้วยตนเอง แต่จะไม่ถูกโหลดเข้าสู่การกำหนดค่าหรือข้อมูลประจำตัวที่ใช้งานจริงของ OpenClaw วิธีนี้จะรักษาสถานะที่คลุมเครือหรือไม่ปลอดภัยไว้โดยไม่แสร้งว่า OpenClaw สามารถเรียกใช้งานหรือเชื่อถือสถานะนั้นโดยอัตโนมัติได้:

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

หลังจากนำไปใช้

openclaw doctor

สัญญา Plugin

แหล่งที่มาของการย้ายข้อมูลคือ Plugin Plugin จะประกาศ provider ids ของตนใน openclaw.plugin.json:

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

ขณะรันไทม์ Plugin จะเรียก api.registerMigrationProvider(...) ผู้ให้บริการจะ implement detect, plan และ apply Core เป็นเจ้าของการประสานงาน CLI, นโยบายสำรองข้อมูล, prompt, เอาต์พุต JSON และการตรวจสอบความขัดแย้งล่วงหน้า Core จะส่งแผนที่ตรวจทานแล้วเข้าไปยัง apply(ctx, plan) และผู้ให้บริการอาจสร้างแผนใหม่ได้เฉพาะเมื่อไม่มีอาร์กิวเมนต์นั้นเพื่อความเข้ากันได้

Plugin ผู้ให้บริการสามารถใช้ openclaw/plugin-sdk/migration สำหรับการสร้างรายการและจำนวนสรุป รวมถึง openclaw/plugin-sdk/migration-runtime สำหรับการคัดลอกไฟล์ที่รับรู้ความขัดแย้ง, การคัดลอกรายงานแบบเก็บถาวรเท่านั้น, wrapper config-runtime ที่แคชไว้ และรายงานการย้ายข้อมูล

การผสานกับ Onboarding

Onboarding สามารถเสนอการย้ายข้อมูลเมื่อผู้ให้บริการตรวจพบแหล่งที่มาที่รู้จัก ทั้ง openclaw onboard --flow import และ openclaw setup --wizard --import-from hermes ใช้ผู้ให้บริการ Plugin สำหรับการย้ายข้อมูลเดียวกัน และยังคงแสดงตัวอย่างก่อนนำไปใช้

ที่เกี่ยวข้อง

• การย้ายจาก Hermes: คู่มือแบบทีละขั้นสำหรับผู้ใช้
• การย้ายจาก Claude: คู่มือแบบทีละขั้นสำหรับผู้ใช้
• การย้ายข้อมูล: ย้าย OpenClaw ไปยังเครื่องใหม่
• Doctor: ตรวจสุขภาพหลังนำการย้ายข้อมูลไปใช้
• Plugin: การติดตั้งและลงทะเบียน Plugin