{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}
Di chuyển OpenClaw

Di chuyển dấu chân tùy chỉnh OpenClaw của người dùng vào Đại lý Hermes. Nhập các ký ức tương thích với Hermes, SOUL.md, danh sách cho phép lệnh, kỹ năng người dùng và nội dung không gian làm việc đã chọn từ ~/.OpenClaw, sau đó báo cáo chính xác những gì không thể di chuyển được và lý do.
Siêu dữ liệu kỹ năng


Nguồn	Tùy chọn — cài đặt với
`Hermes skills install official/migration/OpenClaw-migration
`
Đường dẫn
optional-skills/migration/OpenClaw-migration ` | | Phiên bản |
Migration
, `OpenClaw
, `Hermes
, `Memory
, `Persona
, Import | | Kỹ năng liên quan | XPROTECTX16XPROTECTX |
Tham khảo: đầy đủ SKILL.md

thông tin
Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.
OpenClaw -> Di chuyển Hermes

Sử dụng kỹ năng này khi người dùng muốn chuyển thiết lập OpenClaw của họ sang Đại lý Hermes mà không cần dọn dẹp thủ công.
Lệnh CLI

Để di chuyển nhanh chóng, không tương tác, hãy sử dụng lệnh CLI tích hợp:
Hermes claw migrate              # Full interactive migration
Hermes claw migrate --dry-run    # Preview what would be migrated
Hermes claw migrate --preset user-data   # Migrate without secrets
Hermes claw migrate --overwrite  # Overwrite existing conflicts
Hermes claw migrate --source /custom/path/.OpenClaw  # Custom source

`
``Lệnh CLI chạy tập lệnh di chuyển tương tự được mô tả bên dưới. Sử dụng kỹ năng này (thông qua tác nhân) khi bạn muốn di chuyển có hướng dẫn, mang tính tương tác với các bản xem trước chạy thử và giải quyết xung đột theo từng mục.

**Thiết lập lần đầu:** Trình hướng dẫn 
`Hermes setup
` tự động phát hiện 

~/.OpenClaw
` và cung cấp quá trình di chuyển trước khi bắt đầu cấu hình.

## Kỹ năng này có tác dụng gì

Nó sử dụng 
`scripts/OpenClaw_to_Hermes.py
` để:
- nhập 
`SOUL.md
` vào thư mục chính của Hermes dưới dạng 
`SOUL.md

`
- chuyển đổi OpenClaw 
`MEMORY.md
` và 
`USER.md
` thành các mục bộ nhớ Hermes
- hợp nhất các mẫu phê duyệt lệnh OpenClaw vào Hermes 
`command_allowlist

- di chuyển các cài đặt nhắn tin tương thích với Hermes như 
`Telegram_ALLOWED_USERS
` và 
`MESSAGING_CWD

- sao chép các kỹ năng OpenClaw vào 

~/.Hermes/skills/OpenClaw-imports/

- tùy chọn sao chép tệp hướng dẫn không gian làm việc OpenClaw vào không gian làm việc Hermes đã chọn
- phản chiếu các nội dung không gian làm việc tương thích như 
`workspace/tts/
` vào 

~/.Hermes/tts/

- lưu trữ các tài liệu không bí mật không có đích đến Hermes trực tiếp
- tạo một báo cáo có cấu trúc liệt kê các mục đã di chuyển, xung đột, các mục bị bỏ qua và lý do

## Độ phân giải đường dẫn

Tập lệnh trợ giúp nằm trong thư mục kỹ năng này tại:
- 
`scripts/OpenClaw_to_Hermes.py
``Khi kỹ năng này được cài đặt từ Trung tâm kỹ năng, vị trí bình thường là:
- 

~/.Hermes/skills/migration/OpenClaw-migration/scripts/OpenClaw_to_Hermes.py
``Đừng đoán đường đi ngắn hơn như 

~/.Hermes/skills/OpenClaw-migration/...

.

Trước khi chạy trình trợ giúp:
1. Ưu tiên đường dẫn được cài đặt trong 

~/.Hermes/skills/migration/OpenClaw-migration/

.
2. Nếu đường dẫn đó không thành công, hãy kiểm tra thư mục kỹ năng đã cài đặt và giải quyết tập lệnh liên quan đến 
`SKILL.md
` đã cài đặt.
3. Chỉ sử dụng 
`find
` làm phương án dự phòng nếu thiếu vị trí cài đặt hoặc kỹ năng được di chuyển theo cách thủ công.
4. Khi gọi công cụ đầu cuối, không vượt qua 
`workdir: "~"

. Sử dụng một thư mục tuyệt đối chẳng hạn như thư mục chính của người dùng hoặc bỏ qua hoàn toàn 
`workdir

.

Với 

--migrate-secrets

, nó cũng sẽ nhập một nhóm nhỏ các bí mật tương thích với Hermes trong danh sách cho phép, hiện tại:
- 
`Telegram_BOT_TOKEN

## Quy trình làm việc mặc định
1. Kiểm tra trước bằng cách chạy khô.
2. Trình bày một bản tóm tắt đơn giản về những gì có thể được di chuyển, những gì không thể di chuyển và những gì sẽ được lưu trữ.
3. Nếu có sẵn công cụ 
`clarify

, hãy sử dụng công cụ này cho các quyết định của người dùng thay vì yêu cầu trả lời bằng văn xuôi dạng tự do.
4. Nếu quá trình chạy thử phát hiện xung đột thư mục kỹ năng đã nhập, hãy hỏi cách xử lý những xung đột đó trước khi thực hiện.
5. Yêu cầu người dùng chọn giữa hai chế độ di chuyển được hỗ trợ trước khi thực hiện.
6. Chỉ yêu cầu đường dẫn không gian làm việc đích nếu người dùng muốn mang tệp hướng dẫn không gian làm việc đến.
7. Thực hiện di chuyển với giá trị đặt trước và cờ phù hợp.
8. Tóm tắt kết quả, đặc biệt:
   - những gì đã được di chuyển
   - những gì đã được lưu trữ để xem xét thủ công
   - cái gì đã bị bỏ qua và tại sao

## Giao thức tương tác người dùng

Hermes CLI hỗ trợ công cụ 
`clarify
` cho lời nhắc tương tác nhưng bị giới hạn ở:
- một lựa chọn tại một thời điểm
- tối đa 4 lựa chọn được xác định trước
- tùy chọn văn bản tự do 
`Other
` tự động

Nó **không** hỗ trợ các hộp kiểm nhiều lựa chọn thực sự trong một lời nhắc.Đối với mỗi cuộc gọi 
`clarify

:
- luôn bao gồm 
`question
` không trống
- chỉ bao gồm 
`choices
` cho các lời nhắc có thể lựa chọn thực sự
- giữ 
`choices
` ở 2-4 tùy chọn chuỗi đơn giản
- không bao giờ phát ra các tùy chọn giữ chỗ hoặc cắt ngắn như 

...

- không bao giờ đệm hoặc cách điệu các lựa chọn bằng khoảng trắng thừa
- không bao giờ bao gồm các trường biểu mẫu giả mạo trong câu hỏi, chẳng hạn như 
`enter directory here

, các dòng trống để điền hoặc dấu gạch dưới như 
`_____

- đối với các câu hỏi mở, chỉ hỏi câu đơn giản; người dùng gõ vào dấu nhắc CLI bình thường bên dưới bảng điều khiển

Nếu lệnh gọi 
`clarify
` trả về lỗi, hãy kiểm tra văn bản lỗi, sửa tải trọng và thử lại một lần với 
`question
` hợp lệ và các lựa chọn rõ ràng.

Khi 
`clarify
` khả dụng và quá trình chạy thử sẽ hiển thị bất kỳ quyết định bắt buộc nào của người dùng, **hành động tiếp theo của bạn phải là lệnh gọi công cụ 
`clarify

**.
Đừng kết thúc lượt chơi bằng một tin nhắn trợ lý thông thường như:
- "Hãy để tôi trình bày các lựa chọn"
- "Bạn muốn làm gì?"
- "Đây là các lựa chọn"

Nếu cần có quyết định của người dùng, hãy thu thập quyết định đó qua 
`clarify
` trước khi tạo thêm văn xuôi.
Nếu vẫn còn nhiều quyết định chưa được giải quyết, đừng chèn thông báo trợ lý giải thích giữa chúng. Sau khi nhận được một phản hồi 
`clarify

, hành động tiếp theo của bạn thường sẽ là lệnh gọi 
`clarify
` được yêu cầu tiếp theo.

Hãy coi 
`workspace-agents
` là một quyết định chưa được giải quyết bất cứ khi nào báo cáo chạy thử:
- 
`kind="workspace-agents"

- 
`status="skipped"

- lý do chứa 
`No workspace target was provided
``Trong trường hợp đó, bạn phải hỏi về hướng dẫn về không gian làm việc trước khi thực hiện. Đừng im lặng coi đó là một quyết định bỏ qua.

Do hạn chế đó, hãy sử dụng luồng quyết định đơn giản hóa này:
1. Đối với xung đột 
`SOUL.md

, hãy sử dụng 
`clarify
` với các lựa chọn như:
   - 
`keep existing

   - 
`overwrite with backup

   - 
`review first

2. Nếu quá trình chạy thử hiển thị một hoặc nhiều mục 
`kind="skill"
` có 
`status="conflict"

, hãy sử dụng 
`clarify
` với các lựa chọn như:
   - 
`keep existing skills

   - 
`overwrite conflicting skills with backup

   - 
`import conflicting skills under renamed folders

3. Để biết hướng dẫn về không gian làm việc, hãy sử dụng 
`clarify
` với các lựa chọn như:
   - 
`skip workspace instructions

   - 
`copy to a workspace path

   - 
`decide later

4. Nếu người dùng chọn sao chép hướng dẫn không gian làm việc, hãy hỏi một câu hỏi 
`clarify
` mở tiếp theo yêu cầu **đường dẫn tuyệt đối**.
5. Nếu người dùng chọn 
`skip workspace instructions
` hoặc 
`decide later

, hãy tiếp tục mà không chọn 

--workspace-target

.
5. Đối với chế độ di chuyển, sử dụng 
`clarify
` với 3 lựa chọn sau:
   - 
`user-data only

   - 
`full compatible migration

   - 
`cancel

6. 
`user-data only
` có nghĩa là: di chuyển dữ liệu người dùng và cấu hình tương thích nhưng **không** nhập các bí mật nằm trong danh sách cho phép.
7. 
`full compatible migration
` có nghĩa là: di chuyển cùng một dữ liệu người dùng tương thích cộng với các bí mật nằm trong danh sách cho phép khi có.
8. Nếu không có 
`clarify

, hãy đặt câu hỏi tương tự bằng văn bản thông thường nhưng vẫn giới hạn câu trả lời ở 
`user-data only

, 
`full compatible migration
` hoặc 
`cancel

.

Cổng thực hiện:
- Không thực thi trong khi việc bỏ qua 
`workspace-agents
` do 
`No workspace target was provided
` gây ra vẫn chưa được giải quyết.
- Cách giải quyết hợp lệ duy nhất là:
  - người dùng chọn 
`skip workspace instructions
` một cách rõ ràng
  - người dùng chọn 
`decide later
` một cách rõ ràng
  - người dùng cung cấp đường dẫn không gian làm việc sau khi chọn 
`copy to a workspace path

- Sự vắng mặt của mục tiêu không gian làm việc trong quá trình chạy thử không được phép thực thi.
- Không thực thi khi mọi quyết định 
`clarify
` được yêu cầu vẫn chưa được giải quyết.

Sử dụng các hình dạng tải trọng 
`clarify
` chính xác này làm mẫu mặc định:
- 

\&#123;"question":"Your existing SOUL.md conflicts with the imported one. What should I do?","choices":["keep existing","overwrite with backup","review first"]&#125;

- 

\&#123;"question":"One or more imported OpenClaw skills already exist in Hermes. How should I handle those skill conflicts?","choices":["keep existing skills","overwrite conflicting skills with backup","import conflicting skills under renamed folders"]&#125;

- 

\&#123;"question":"Choose migration mode: migrate only user data, or run the full compatible migration including allowlisted secrets?","choices":["user-data only","full compatible migration","cancel"]&#125;

- 

\&#123;"question":"Do you want to copy the OpenClaw workspace instructions file into a Hermes workspace?","choices":["skip workspace instructions","copy to a workspace path","decide later"]&#125;

- 

\&#123;"question":"Please provide an absolute path where the workspace instructions should be copied."&#125;

## Ánh xạ quyết định theo lệnh

Ánh xạ các quyết định của người dùng để ra lệnh cờ chính xác:- Nếu người dùng chọn 
`keep existing
` cho 
`SOUL.md

, **không** thêm 

--overwrite

.
- Nếu người dùng chọn 
`overwrite with backup
` thì thêm 

--overwrite

.
- Nếu người dùng chọn 
`review first

, hãy dừng lại trước khi thực hiện và xem lại các tệp có liên quan.
- Nếu người dùng chọn 
`keep existing skills
` thì thêm 

--skill-conflict skip

.
- Nếu người dùng chọn 
`overwrite conflicting skills with backup
` thì thêm 

--skill-conflict overwrite

.
- Nếu người dùng chọn 
`import conflicting skills under renamed folders
` thì thêm 

--skill-conflict rename

.
- Nếu người dùng chọn 
`user-data only

, hãy thực thi với 

--preset user-data
` và **không** thêm 

--migrate-secrets

.
- Nếu người dùng chọn 
`full compatible migration
` thì thực thi với 

--preset full --migrate-secrets

.
- Chỉ thêm 

--workspace-target
` nếu người dùng đã cung cấp rõ ràng đường dẫn không gian làm việc tuyệt đối.
- Nếu người dùng chọn 
`skip workspace instructions
` hoặc 
`decide later
` thì không thêm 

--workspace-target

.

Trước khi thực hiện, hãy trình bày lại kế hoạch lệnh chính xác bằng ngôn ngữ đơn giản và đảm bảo nó phù hợp với lựa chọn của người dùng.

## Quy tắc báo cáo sau khi chạy

Sau khi thực thi, hãy coi đầu ra JSON của tập lệnh là nguồn đáng tin cậy.
1. Căn cứ vào 
`report.summary

.
2. Chỉ liệt kê một mục trong "Đã di chuyển thành công" nếu 
`status
` của nó chính xác là 
`migrated

.
3. Không tuyên bố xung đột đã được giải quyết trừ khi báo cáo hiển thị mục đó là 
`migrated

.
4. Không nói 
`SOUL.md
` bị ghi đè trừ khi mục báo cáo cho 
`kind="soul"
` có 
`status="migrated"

.
5. Nếu 
`report.summary.conflict > 0

, hãy đưa vào phần xung đột thay vì âm thầm ngụ ý thành công.
6. Nếu số lượng và các mục được liệt kê không đồng ý, hãy sửa danh sách cho khớp với báo cáo trước khi phản hồi.
7. Bao gồm đường dẫn 
`output_dir
` từ báo cáo khi có sẵn để người dùng có thể kiểm tra 
`report.JSON

, 
`summary.md

, bản sao lưu và tệp lưu trữ.
8. Đối với trường hợp tràn bộ nhớ hoặc hồ sơ người dùng, đừng nói rằng các mục nhập đã được lưu trữ trừ khi báo cáo hiển thị rõ ràng đường dẫn lưu trữ. Nếu 
`details.overflow_file
` tồn tại, giả sử danh sách tràn đầy đủ đã được xuất ở đó.
9. Nếu một kỹ năng được nhập vào thư mục đã được đổi tên, hãy báo cáo đích cuối cùng và đề cập đến 
`details.renamed_from

.
10. Nếu có 
`report.skill_conflict_mode

, hãy sử dụng nó làm nguồn sự thật cho chính sách xung đột kỹ năng nhập khẩu đã chọn.
11. Nếu một mục có 
`status="skipped"

, đừng mô tả mục đó là bị ghi đè, sao lưu, di chuyển hoặc đã giải quyết.
12. Nếu 
`kind="soul"
` có 
`status="skipped"
` với lý do 
`Target already matches source

, hãy nói rằng nó không thay đổi và không đề cập đến bản sao lưu.
13. Nếu một kỹ năng đã nhập được đổi tên có 
`details.backup
` trống, không có nghĩa là kỹ năng Hermes hiện có đã được đổi tên hoặc sao lưu. Chỉ nói rằng bản sao đã nhập đã được đặt ở đích mới và tham chiếu 
`details.renamed_from
` là thư mục tồn tại từ trước vẫn được giữ nguyên.

## Cài đặt trước di chuyển

Thích hai cài đặt trước này trong sử dụng bình thường:
- 
`user-data

- 
`full
```user-data
` bao gồm:
- 
`soul

- 
`workspace-agents

- 
`memory

- 
`user-profile

- 
`messaging-settings

- 
`command-allowlist

- 
`skills

- 
`tts-assets

- 
`archive
```full
` bao gồm mọi thứ trong 
`user-data
` cộng thêm:
- 
`secret-settings
``Tập lệnh trợ giúp vẫn hỗ trợ 

--include
` / 

--exclude
` cấp danh mục, nhưng coi đó là dự phòng nâng cao thay vì UX mặc định.

## Lệnh

Chạy khô với khám phá đầy đủ:

``` bash
Python3 ~/.Hermes/skills/migration/OpenClaw-migration/scripts/OpenClaw_to_Hermes.py

`
``Khi sử dụng công cụ đầu cuối, hãy ưu tiên mẫu lệnh gọi tuyệt đối, chẳng hạn như:

`JSON
\&#123;"command":"Python3 /home/USER/.Hermes/skills/migration/OpenClaw-migration/scripts/OpenClaw_to_Hermes.py","workdir":"/home/USER"&#125;

`
``Chạy khô với cài đặt trước dữ liệu người dùng:

`bash
Python3 ~/.Hermes/skills/migration/OpenClaw-migration/scripts/OpenClaw_to_Hermes.py --preset user-data

`
``Thực hiện di chuyển dữ liệu người dùng:

`bash
Python3 ~/.Hermes/skills/migration/OpenClaw-migration/scripts/OpenClaw_to_Hermes.py --execute --preset user-data --skill-conflict skip

`
``Thực hiện di chuyển tương thích đầy đủ:

`bash
Python3 ~/.Hermes/skills/migration/OpenClaw-migration/scripts/OpenClaw_to_Hermes.py --execute --preset full --migrate-secrets --skill-conflict skip

`
``Thực hiện với các hướng dẫn không gian làm việc bao gồm:

`bash
Python3 ~/.Hermes/skills/migration/OpenClaw-migration/scripts/OpenClaw_to_Hermes.py --execute --preset user-data --skill-conflict rename --workspace-target "/absolute/workspace/path"

`
``Theo mặc định, không sử dụng 

$PWD
` hoặc thư mục chính làm mục tiêu không gian làm việc. Trước tiên, hãy yêu cầu đường dẫn không gian làm việc rõ ràng.

## Quy tắc quan trọng1. Chạy thử trước khi viết trừ khi người dùng nói rõ ràng là phải tiếp tục ngay lập tức.

2. Không di chuyển bí mật theo mặc định. Mã thông báo, đốm màu xác thực, thông tin xác thực thiết bị và cấu hình cổng thô sẽ không được đưa vào Hermes trừ khi người dùng yêu cầu di chuyển bí mật một cách rõ ràng.
3. Không âm thầm ghi đè lên các mục tiêu Hermes không trống trừ khi người dùng rõ ràng muốn điều đó. Tập lệnh trợ giúp sẽ lưu giữ các bản sao lưu khi tính năng ghi đè được bật.
4. Luôn cung cấp cho người dùng báo cáo về các mục bị bỏ qua. Báo cáo đó là một phần của quá trình di chuyển, không phải là phần bổ sung tùy chọn.
5. Ưu tiên không gian làm việc OpenClaw chính (

~/.OpenClaw/workspace/

) hơn 
`workspace.default/

. Chỉ sử dụng không gian làm việc mặc định làm dự phòng khi thiếu tệp chính.
6. Ngay cả trong chế độ di chuyển bí mật, chỉ di chuyển các bí mật có đích đến Hermes sạch sẽ. Các đốm màu xác thực không được hỗ trợ vẫn phải được báo cáo là bị bỏ qua.
7. Nếu quá trình chạy thử hiển thị bản sao nội dung lớn, 
`SOUL.md
` xung đột hoặc các mục nhập bộ nhớ bị tràn, hãy gọi riêng các mục đó trước khi thực thi.
8. Mặc định là 
`user-data only
` nếu người dùng không chắc chắn.
9. Chỉ bao gồm 
`workspace-agents
` khi người dùng đã cung cấp rõ ràng đường dẫn không gian làm việc đích.
10. Coi 

--include
` / 

--exclude
` cấp danh mục như một cửa thoát hiểm nâng cao, không phải dòng chảy thông thường.
11. Đừng kết thúc bản tóm tắt ngắn gọn bằng câu nói mơ hồ “Bạn muốn làm gì?” nếu 
`clarify
` có sẵn. Thay vào đó, hãy sử dụng lời nhắc theo dõi có cấu trúc.
12. Không sử dụng lời nhắc 
`clarify
` kết thúc mở khi lời nhắc lựa chọn thực sự có tác dụng. Ưu tiên các lựa chọn có thể lựa chọn trước, sau đó chỉ văn bản miễn phí cho các đường dẫn tuyệt đối hoặc yêu cầu xem xét tệp.
13. Sau khi chạy thử, đừng bao giờ dừng lại sau khi tóm tắt nếu vẫn còn một quyết định chưa được giải quyết. Sử dụng ngay 
`clarify
` để có quyết định chặn ưu tiên cao nhất.
14. Thứ tự ưu tiên cho các câu hỏi tiếp theo:
    - Xung đột 
`SOUL.md

    - xung đột kỹ năng nhập khẩu
    - chế độ di chuyển
    - đích hướng dẫn không gian làm việc
15. Đừng hứa sẽ trình bày các lựa chọn sau này trong cùng một tin nhắn. Trình bày chúng bằng cách gọi 
`clarify

.
16. Sau câu trả lời về chế độ di chuyển, hãy kiểm tra rõ ràng xem 
`workspace-agents
` có còn chưa được giải quyết hay không. Nếu đúng như vậy, hành động tiếp theo của bạn phải là lệnh gọi 
`clarify
` hướng dẫn không gian làm việc.
17. Sau bất kỳ câu trả lời 
`clarify
` nào, nếu vẫn còn một quyết định bắt buộc khác, đừng thuật lại những gì vừa được quyết định. Đặt câu hỏi bắt buộc tiếp theo ngay lập tức.`##Kết quả mong đợi

Sau khi chạy thành công, người dùng sẽ có:
- Nhà nước Hermes cá tính nhập khẩu
- Các tệp bộ nhớ Hermes chứa kiến thức OpenClaw đã được chuyển đổi
- Các kỹ năng OpenClaw có sẵn trong 

~/.Hermes/skills/OpenClaw-imports/

- báo cáo di chuyển hiển thị mọi xung đột, thiếu sót hoặc dữ liệu không được hỗ trợ
Siêu dữ liệu kỹ năng​

Tham khảo: đầy đủ SKILL.md​

OpenClaw -> Di chuyển Hermes

Lệnh CLI​

Siêu dữ liệu kỹ năng

Tham khảo: đầy đủ SKILL.md

Lệnh CLI
