---
read_when:
    - คุณกำลังย้ายมาจาก Hermes และต้องการเก็บการกำหนดค่าโมเดล พรอมป์ หน่วยความจำ และ Skills ของคุณไว้
    - คุณต้องการทราบว่า OpenClaw นำเข้าสิ่งใดโดยอัตโนมัติ และสิ่งใดเก็บไว้เป็นไฟล์ถาวรเท่านั้น
    - คุณต้องมีแนวทางการย้ายระบบที่สะอาดและทำงานด้วยสคริปต์ (CI, แล็ปท็อปเครื่องใหม่, ระบบอัตโนมัติ)
summary: ย้ายจาก Hermes ไปยัง OpenClaw ด้วยการนำเข้าที่ดูตัวอย่างล่วงหน้าและย้อนกลับได้
title: การย้ายจาก Hermes
x-i18n:
    generated_at: "2026-07-19T07:21:16Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 6b75d8bb1c5d40693354a8902e35ade4239dc001705abeee04a004e2cbaaa94c
    source_path: install/migrating-hermes.md
    workflow: 16
---

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

<Note>
การนำเข้าต้องใช้การตั้งค่า OpenClaw ใหม่ หากมีสถานะ OpenClaw ภายในเครื่องอยู่แล้ว ให้รีเซ็ตการกำหนดค่า ข้อมูลประจำตัว เซสชัน และพื้นที่ทำงานก่อน หรือใช้ `openclaw migrate apply hermes` โดยตรงกับ `--overwrite` หลังจากตรวจสอบแผนแล้ว
</Note>

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

<Tabs>
  <Tab title="ตัวช่วยสร้างการเริ่มต้นใช้งาน">
    ตรวจหาโฮม/โปรไฟล์ Hermes ที่ใช้งานอยู่และแสดงตัวอย่างก่อนนำไปใช้

    ```bash
    openclaw onboard --flow import
    ```

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

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

  </Tab>
  <Tab title="CLI">
    ใช้ `openclaw migrate` สำหรับการเรียกใช้ด้วยสคริปต์หรือการเรียกใช้ซ้ำ โปรดดูข้อมูลอ้างอิงฉบับเต็มที่ [`openclaw migrate`](/th/cli/migrate)

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

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

  </Tab>
</Tabs>

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

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

  </Accordion>
  <Accordion title="เซิร์ฟเวอร์ MCP">
    คำจำกัดความเซิร์ฟเวอร์ MCP จาก `mcp_servers` หรือ `mcp.servers` รวมถึงสถานะปิดใช้งาน ระยะหมดเวลา การรองรับเครื่องมือแบบขนาน ขอบเขต OAuth ฟิลด์ TLS ที่เข้ากันได้ และนโยบายเครื่องมือแบบเนทีฟ/ทรัพยากร/พรอมต์ ตัวแปรสภาพแวดล้อมและส่วนหัวที่ระบุโดยตรงต้องได้รับความยินยอมให้นำเข้าข้อมูลประจำตัว การตั้งค่าเฉพาะ Hermes สำหรับวงจรชีวิต การสุ่มตัวอย่าง การขอข้อมูล การตรวจสอบก่อนดำเนินการ keepalive ชุดใบรับรอง CA คีย์ไคลเอนต์ที่ป้องกันด้วยรหัสผ่าน และไคลเอนต์ OAuth ที่ลงทะเบียนไว้ล่วงหน้า จะกลายเป็นรายการสำหรับตรวจสอบด้วยตนเองแทนที่จะเป็นการกำหนดค่า OpenClaw ที่ไม่ถูกต้อง
  </Accordion>
  <Accordion title="ไฟล์พื้นที่ทำงาน">
    - `SOUL.md` และ `AGENTS.md` จะถูกคัดลอกไปยังพื้นที่ทำงานของเอเจนต์ OpenClaw
    - `memories/MEMORY.md` และ `memories/USER.md` จะถูก **ต่อท้าย** ไฟล์หน่วยความจำ OpenClaw ที่ตรงกันแทนการเขียนทับ
    - พื้นผิวที่ใช้เฉพาะหน่วยความจำจะทำงานต่างออกไป: หน้าหน่วยความจำในการเริ่มต้นใช้งานและหน้านำเข้าหน่วยความจำของ Control UI จะคัดลอกไฟล์ทั้งสองนี้ไว้ภายใต้ `memory/imports/hermes/` เพื่อการเรียกคืนผ่านดัชนี และไม่แก้ไขหน่วยความจำพื้นที่ทำงานที่มีอยู่

  </Accordion>
  <Accordion title="การกำหนดค่าหน่วยความจำ">
    ค่าเริ่มต้นการกำหนดค่าหน่วยความจำสำหรับหน่วยความจำแบบไฟล์ของ OpenClaw ผู้ให้บริการหน่วยความจำภายนอก เช่น Honcho จะถูกบันทึกเป็นรายการเก็บถาวรหรือรายการสำหรับตรวจสอบด้วยตนเอง เพื่อให้สามารถย้ายได้อย่างรอบคอบ
  </Accordion>
  <Accordion title="Skills">
    Skills ที่มีไฟล์ `SKILL.md` อยู่ที่ใดก็ตามภายใต้ `skills/` จะถูกค้นหาแบบเรียกซ้ำ จัดโครงสร้างแบบแบนลงในไดเรกทอรี Skills ของพื้นที่ทำงาน OpenClaw และคัดลอกพร้อมไฟล์สนับสนุน ค่าการกำหนดค่าของแต่ละ Skill จาก `skills.config` จะยังคงอยู่
  </Accordion>
  <Accordion title="ข้อมูลประจำตัวการยืนยันตัวตน">
    `openclaw migrate` แบบโต้ตอบจะขออนุญาตก่อนนำเข้าข้อมูลประจำตัวการยืนยันตัวตน โดยเลือกใช่เป็นค่าเริ่มต้น การนำเข้าที่ยอมรับได้ประกอบด้วยรายการ OAuth ของ Hermes OpenAI Codex ในปัจจุบัน รายการ OpenCode OpenAI OAuth และ GitHub Copilot ตลอดจน[คีย์ `.env` ของ Hermes ที่รองรับ](/th/cli/migrate#supported-env-keys) ใช้ `--include-secrets` สำหรับการนำเข้าแบบไม่โต้ตอบ ใช้ `--no-auth-credentials` เพื่อข้ามข้อมูลประจำตัว หรือใช้แฟล็ก `--import-secrets` ของการเริ่มต้นใช้งาน หลังจากนำเข้า Hermes OAuth แล้ว อย่าให้ Hermes และ OpenClaw ใช้สิทธิ์การรีเฟรชเดียวกันต่อไป ให้ยืนยันตัวตนใหม่ที่ด้านใดด้านหนึ่งก่อนเรียกใช้ทั้งสองระบบ
  </Accordion>
</AccordionGroup>

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

ผู้ให้บริการจะคัดลอกรายการเหล่านี้ไปยังไดเรกทอรีรายงานการย้ายข้อมูลเพื่อตรวจสอบด้วยตนเอง แต่จะ **ไม่** โหลดลงในการกำหนดค่าหรือข้อมูลประจำตัว 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 ปฏิเสธที่จะดำเนินการหรือเชื่อถือสถานะนี้โดยอัตโนมัติ เนื่องจากรูปแบบและสมมติฐานด้านความเชื่อถืออาจแตกต่างกันไปในแต่ละระบบ หลังจากตรวจสอบที่เก็บถาวรแล้ว ให้ย้ายสิ่งที่ต้องการด้วยตนเอง

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

<Steps>
  <Step title="แสดงตัวอย่างแผน">
    ```bash
    openclaw migrate hermes --dry-run
    ```

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

  </Step>
  <Step title="นำไปใช้พร้อมข้อมูลสำรอง">
    ```bash
    openclaw migrate apply hermes --yes
    ```

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

  </Step>
  <Step title="เรียกใช้ Doctor">
    ```bash
    openclaw doctor
    ```

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

  </Step>
  <Step title="รีสตาร์ตและตรวจสอบ">
    ```bash
    openclaw gateway restart
    openclaw status
    ```

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

  </Step>
</Steps>

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

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

<Warning>
เรียกใช้อีกครั้งด้วย `--overwrite` เฉพาะเมื่อตั้งใจแทนที่เป้าหมายที่มีอยู่ ผู้ให้บริการอาจยังคงเขียนข้อมูลสำรองระดับรายการสำหรับไฟล์ที่ถูกเขียนทับไว้ในไดเรกทอรีรายงานการย้ายข้อมูล
</Warning>

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

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

## ข้อมูลลับ

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

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

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

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

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

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

<AccordionGroup>
  <Accordion title="การนำไปใช้ถูกปฏิเสธเนื่องจากข้อขัดแย้ง">
    ตรวจสอบผลลัพธ์ของแผน ข้อขัดแย้งแต่ละรายการจะระบุพาธต้นทางและเป้าหมายที่มีอยู่ ให้ตัดสินใจเป็นรายรายการว่าจะข้าม แก้ไขเป้าหมาย หรือเรียกใช้อีกครั้งด้วย `--overwrite`
  </Accordion>
  <Accordion title="Hermes อยู่นอก ~/.hermes">
    ส่ง `--from /actual/path` (CLI) หรือ `--import-source /actual/path` (การเริ่มต้นใช้งาน)
  </Accordion>
  <Accordion title="การเริ่มต้นใช้งานปฏิเสธการนำเข้าในการตั้งค่าที่มีอยู่">
    การนำเข้าผ่านการเริ่มต้นใช้งานต้องใช้การตั้งค่าใหม่ ให้รีเซ็ตสถานะและเริ่มต้นใช้งานอีกครั้ง หรือใช้ `openclaw migrate apply hermes` โดยตรง ซึ่งรองรับ `--overwrite` และการควบคุมข้อมูลสำรองอย่างชัดเจน
  </Accordion>
  <Accordion title="ไม่ได้นำเข้าคีย์ API">
    `openclaw migrate` แบบโต้ตอบจะนำเข้าคีย์ API เฉพาะเมื่อยอมรับพรอมต์ข้อมูลประจำตัว การเรียกใช้ `--yes` แบบไม่โต้ตอบต้องใช้ `--include-secrets` ส่วนการนำเข้าผ่านการเริ่มต้นใช้งานต้องใช้ `--import-secrets` ระบบจะรู้จักเฉพาะ[คีย์ `.env` ที่รองรับ](/th/cli/migrate#supported-env-keys) เท่านั้น โดยจะไม่สนใจตัวแปร `.env` อื่นๆ
  </Accordion>
</AccordionGroup>

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

- [`openclaw migrate`](/th/cli/migrate): ข้อมูลอ้างอิง CLI ฉบับเต็ม สัญญา Plugin และโครงสร้าง JSON
- [การเริ่มต้นใช้งาน](/th/cli/onboard): ขั้นตอนตัวช่วยสร้างและแฟล็กแบบไม่โต้ตอบ
- [การย้ายข้อมูล](/th/install/migrating): ย้ายการติดตั้ง OpenClaw ระหว่างเครื่อง
- [Doctor](/th/gateway/doctor): การตรวจสอบสถานะหลังการย้ายข้อมูล
- [พื้นที่ทำงานของเอเจนต์](/th/concepts/agent-workspace): ตำแหน่งของ `SOUL.md`, `AGENTS.md` และไฟล์หน่วยความจำ