OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

การย้ายจาก Hermes

ผู้ให้บริการการย้ายข้อมูล Hermes ที่รวมมาในชุดจะปฏิบัติตาม HERMES_HOME และโปรไฟล์ Hermes ที่ใช้งานอยู่ โดยใช้ ~/.hermes เป็นทางเลือกสำรองบน macOS/Linux หรือ %LOCALAPPDATA%\hermes บน Windows ระบบจะแสดงตัวอย่างการเปลี่ยนแปลงทั้งหมดก่อนนำไปใช้ ปกปิดข้อมูลลับในแผนและรายงาน และเขียนข้อมูลสำรอง OpenClaw ที่ผ่านการตรวจสอบก่อนดำเนินการใดๆ พาธ --from ที่ระบุอย่างชัดเจนจะมีลำดับความสำคัญสูงสุดเสมอ

สองวิธีในการนำเข้า

ตัวช่วยสร้างการเริ่มต้นใช้งาน

ตรวจหาโฮม/โปรไฟล์ Hermes ที่ใช้งานอยู่และแสดงตัวอย่างก่อนนำไปใช้

bash
openclaw onboard --flow import

หรือระบุแหล่งที่มาเฉพาะ:

bash
openclaw onboard --import-from hermes --import-source ~/.hermes

CLI

ใช้ openclaw migrate สำหรับการเรียกใช้ด้วยสคริปต์หรือการเรียกใช้ซ้ำ โปรดดูข้อมูลอ้างอิงฉบับเต็มที่ openclaw migrate

bash
openclaw migrate hermes --dry-run    # แสดงตัวอย่างเท่านั้นopenclaw migrate apply hermes --yes  # นำไปใช้โดยข้ามการยืนยัน

เพิ่ม --from <path> เพื่อแทนที่การค้นหาโฮม/โปรไฟล์ Hermes

สิ่งที่จะถูกนำเข้า

การกำหนดค่าโมเดล
  • การเลือกโมเดลเริ่มต้นจาก config.yaml ของ Hermes
  • ผู้ให้บริการโมเดลที่กำหนดค่าไว้และปลายทางแบบกำหนดเองจาก model, providers และ custom_providers รวมถึงทรานสปอร์ต Hermes Chat Completions, Codex Responses และ Anthropic Messages ที่ใช้อยู่ในปัจจุบัน
เซิร์ฟเวอร์ MCP

คำจำกัดความเซิร์ฟเวอร์ MCP จาก mcp_servers หรือ mcp.servers รวมถึงสถานะปิดใช้งาน ระยะหมดเวลา การรองรับเครื่องมือแบบขนาน ขอบเขต OAuth ฟิลด์ TLS ที่เข้ากันได้ และนโยบายเครื่องมือแบบเนทีฟ/ทรัพยากร/พรอมต์ ตัวแปรสภาพแวดล้อมและส่วนหัวที่ระบุโดยตรงต้องได้รับความยินยอมให้นำเข้าข้อมูลประจำตัว การตั้งค่าเฉพาะ Hermes สำหรับวงจรชีวิต การสุ่มตัวอย่าง การขอข้อมูล การตรวจสอบก่อนดำเนินการ keepalive ชุดใบรับรอง CA คีย์ไคลเอนต์ที่ป้องกันด้วยรหัสผ่าน และไคลเอนต์ OAuth ที่ลงทะเบียนไว้ล่วงหน้า จะกลายเป็นรายการสำหรับตรวจสอบด้วยตนเองแทนที่จะเป็นการกำหนดค่า OpenClaw ที่ไม่ถูกต้อง

ไฟล์พื้นที่ทำงาน
  • SOUL.md และ AGENTS.md จะถูกคัดลอกไปยังพื้นที่ทำงานของเอเจนต์ OpenClaw
  • memories/MEMORY.md และ memories/USER.md จะถูก ต่อท้าย ไฟล์หน่วยความจำ OpenClaw ที่ตรงกันแทนการเขียนทับ
  • พื้นผิวที่ใช้เฉพาะหน่วยความจำจะทำงานต่างออกไป: หน้าหน่วยความจำในการเริ่มต้นใช้งานและหน้านำเข้าหน่วยความจำของ Control UI จะคัดลอกไฟล์ทั้งสองนี้ไว้ภายใต้ memory/imports/hermes/ เพื่อการเรียกคืนผ่านดัชนี และไม่แก้ไขหน่วยความจำพื้นที่ทำงานที่มีอยู่
การกำหนดค่าหน่วยความจำ

ค่าเริ่มต้นการกำหนดค่าหน่วยความจำสำหรับหน่วยความจำแบบไฟล์ของ OpenClaw ผู้ให้บริการหน่วยความจำภายนอก เช่น Honcho จะถูกบันทึกเป็นรายการเก็บถาวรหรือรายการสำหรับตรวจสอบด้วยตนเอง เพื่อให้สามารถย้ายได้อย่างรอบคอบ

Skills

Skills ที่มีไฟล์ SKILL.md อยู่ที่ใดก็ตามภายใต้ skills/ จะถูกค้นหาแบบเรียกซ้ำ จัดโครงสร้างแบบแบนลงในไดเรกทอรี Skills ของพื้นที่ทำงาน OpenClaw และคัดลอกพร้อมไฟล์สนับสนุน ค่าการกำหนดค่าของแต่ละ Skill จาก skills.config จะยังคงอยู่

ข้อมูลประจำตัวการยืนยันตัวตน

openclaw migrate แบบโต้ตอบจะขออนุญาตก่อนนำเข้าข้อมูลประจำตัวการยืนยันตัวตน โดยเลือกใช่เป็นค่าเริ่มต้น การนำเข้าที่ยอมรับได้ประกอบด้วยรายการ OAuth ของ Hermes OpenAI Codex ในปัจจุบัน รายการ OpenCode OpenAI OAuth และ GitHub Copilot ตลอดจนคีย์ .env ของ Hermes ที่รองรับ ใช้ --include-secrets สำหรับการนำเข้าแบบไม่โต้ตอบ ใช้ --no-auth-credentials เพื่อข้ามข้อมูลประจำตัว หรือใช้แฟล็ก --import-secrets ของการเริ่มต้นใช้งาน หลังจากนำเข้า Hermes OAuth แล้ว อย่าให้ Hermes และ OpenClaw ใช้สิทธิ์การรีเฟรชเดียวกันต่อไป ให้ยืนยันตัวตนใหม่ที่ด้านใดด้านหนึ่งก่อนเรียกใช้ทั้งสองระบบ

สิ่งที่คงไว้เฉพาะในที่เก็บถาวร

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

  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • plans/, workspace/, skins/ และ kanban/
  • พื้นที่จัดเก็บ pairing/ และ platforms/ รวมถึงสถานะการกำหนดเส้นทาง/กระบวนการของ Gateway
  • state.db, hermes_state.db, projects.db, response_store.db, memory_store.db, verification_evidence.db, kanban.db และ retaindb_queue.db

OpenClaw ปฏิเสธที่จะดำเนินการหรือเชื่อถือสถานะนี้โดยอัตโนมัติ เนื่องจากรูปแบบและสมมติฐานด้านความเชื่อถืออาจแตกต่างกันไปในแต่ละระบบ หลังจากตรวจสอบที่เก็บถาวรแล้ว ให้ย้ายสิ่งที่ต้องการด้วยตนเอง

ขั้นตอนที่แนะนำ

  • แสดงตัวอย่างแผน

    bash
    openclaw migrate hermes --dry-run

    แผนจะแสดงรายการทุกอย่างที่จะเปลี่ยนแปลง รวมถึงข้อขัดแย้ง รายการที่ข้าม และรายการที่ละเอียดอ่อน คีย์ซ้อนที่ดูเหมือนข้อมูลลับจะถูกปกปิดในผลลัพธ์

  • นำไปใช้พร้อมข้อมูลสำรอง

    bash
    openclaw migrate apply hermes --yes

    OpenClaw จะสร้างและตรวจสอบข้อมูลสำรองก่อนนำไปใช้ ตัวอย่างแบบไม่โต้ตอบนี้จะนำเข้าเฉพาะสถานะที่ไม่ใช่ข้อมูลลับ เรียกใช้โดยไม่มี --yes เพื่อตอบพรอมต์ข้อมูลประจำตัวแบบโต้ตอบ หรือเพิ่ม --include-secrets เพื่อรวมข้อมูลประจำตัวที่รองรับในการเรียกใช้แบบไม่มีผู้ดูแล

  • เรียกใช้ Doctor

    bash
    openclaw doctor

    Doctor จะนำการย้ายการกำหนดค่าที่ยังค้างอยู่ไปใช้อีกครั้ง และตรวจหาปัญหาที่เกิดขึ้นระหว่างการนำเข้า

  • รีสตาร์ตและตรวจสอบ

    bash
    openclaw gateway restartopenclaw status

    ยืนยันว่า Gateway ทำงานเป็นปกติและโมเดล หน่วยความจำ และ Skills ที่นำเข้าได้รับการโหลดแล้ว

    • การจัดการข้อขัดแย้ง

    การนำไปใช้จะปฏิเสธที่จะดำเนินการต่อเมื่อแผนรายงานข้อขัดแย้ง (มีไฟล์หรือค่าการกำหนดค่าอยู่ที่เป้าหมายแล้ว)

    ข้อขัดแย้งเกิดขึ้นไม่บ่อยในการติดตั้งใหม่ โดยทั่วไปจะปรากฏเมื่อเรียกใช้การนำเข้าซ้ำกับการตั้งค่าที่มีการแก้ไขโดยผู้ใช้อยู่แล้ว

    หากข้อขัดแย้งเกิดขึ้นระหว่างการนำไปใช้ (ตัวอย่างเช่น เกิดภาวะแข่งขันที่ไม่คาดคิดในไฟล์การกำหนดค่า) รายการนั้นจะถูกรายงานว่าเป็นข้อขัดแย้ง ขณะที่ไฟล์ Skills ข้อมูลประจำตัว ที่เก็บถาวร และรายการการกำหนดค่าอื่นที่เป็นอิสระจะดำเนินการต่อ แก้ไขรายการที่ขัดแย้งแล้วเรียกใช้การนำเข้าอีกครั้ง การนำเข้าหน่วยความจำที่เหมือนกันสามารถดำเนินการซ้ำได้โดยให้ผลลัพธ์เดิม

    ข้อมูลลับ

    openclaw migrate แบบโต้ตอบจะถามว่าจะนำเข้าข้อมูลประจำตัวการยืนยันตัวตนที่ตรวจพบหรือไม่ โดยเลือกใช่เป็นค่าเริ่มต้น

    • การยอมรับจะนำเข้ารายการ OAuth ของ Hermes OpenAI Codex ในปัจจุบัน รายการ OpenCode OpenAI OAuth และ GitHub Copilot ตลอดจนคีย์ .env ที่รองรับ
    • ใช้ --no-auth-credentials หรือตอบไม่ที่พรอมต์ เพื่อนำเข้าเฉพาะสถานะที่ไม่ใช่ข้อมูลลับ
    • ใช้ --include-secrets เพื่อนำเข้าข้อมูลประจำตัวในการเรียกใช้ --yes แบบไม่มีผู้ดูแล
    • ใช้แฟล็ก --import-secrets ของตัวช่วยสร้างการเริ่มต้นใช้งานเพื่อนำเข้าข้อมูลประจำตัวจากตัวช่วยสร้าง

    เอาต์พุต JSON สำหรับระบบอัตโนมัติ

    bash
    openclaw migrate hermes --dry-run --jsonopenclaw migrate apply hermes --json --yes

    เมื่อใช้ --json โดยไม่มี --yes การนำไปใช้จะพิมพ์แผนและไม่เปลี่ยนแปลงสถานะ ซึ่งเป็นโหมดที่ปลอดภัยที่สุดสำหรับ CI และสคริปต์ที่ใช้ร่วมกัน

    การแก้ไขปัญหา

    การนำไปใช้ถูกปฏิเสธเนื่องจากข้อขัดแย้ง

    ตรวจสอบผลลัพธ์ของแผน ข้อขัดแย้งแต่ละรายการจะระบุพาธต้นทางและเป้าหมายที่มีอยู่ ให้ตัดสินใจเป็นรายรายการว่าจะข้าม แก้ไขเป้าหมาย หรือเรียกใช้อีกครั้งด้วย --overwrite

    Hermes อยู่นอก ~/.hermes

    ส่ง --from /actual/path (CLI) หรือ --import-source /actual/path (การเริ่มต้นใช้งาน)

    การเริ่มต้นใช้งานปฏิเสธการนำเข้าในการตั้งค่าที่มีอยู่

    การนำเข้าผ่านการเริ่มต้นใช้งานต้องใช้การตั้งค่าใหม่ ให้รีเซ็ตสถานะและเริ่มต้นใช้งานอีกครั้ง หรือใช้ openclaw migrate apply hermes โดยตรง ซึ่งรองรับ --overwrite และการควบคุมข้อมูลสำรองอย่างชัดเจน

    ไม่ได้นำเข้าคีย์ API

    openclaw migrate แบบโต้ตอบจะนำเข้าคีย์ API เฉพาะเมื่อยอมรับพรอมต์ข้อมูลประจำตัว การเรียกใช้ --yes แบบไม่โต้ตอบต้องใช้ --include-secrets ส่วนการนำเข้าผ่านการเริ่มต้นใช้งานต้องใช้ --import-secrets ระบบจะรู้จักเฉพาะคีย์ .env ที่รองรับ เท่านั้น โดยจะไม่สนใจตัวแปร .env อื่นๆ

    เนื้อหาที่เกี่ยวข้อง

    Was this useful?
    On this page

    On this page