← Back to Skills Marketplace
Openclaw Migration
by
Agung Prabowo
· GitHub ↗
· v0.1.0
· MIT-0
263
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-migration-2
Description
Migrate a user's OpenClaw customization footprint into Hermes Agent. Imports Hermes-compatible memories, SOUL.md, command allowlists, user skills, and select...
Usage Guidance
This skill mostly does what it claims (migrates OpenClaw data into Hermes), but review before running: 1) Run a dry-run first (hermes claw migrate --dry-run) and inspect the produced report. 2) Inspect the included script (scripts/openclaw_to_hermes.py) yourself — it will read ~/.openclaw and write to ~/.hermes, including config.yaml and .env. 3) Do not enable secret migration (--migrate-secrets) unless you understand exactly which keys will be moved: the SKILL.md mentions only TELEGRAM_BOT_TOKEN, but the script supports importing many provider API keys (OpenAI, Anthropic, ElevenLabs, OpenRouter, etc.). 4) Back up your ~/.hermes and any important files beforehand (the tool will attempt backups, but a manual copy is safer). 5) If you plan to let the agent run this interactively, ensure the clarify tool will be used for decisions (per SKILL.md) and confirm each conflict resolution choice. 6) If anything is unclear, run the script locally from a copy of your ~/.openclaw, or ask the skill author to clarify which secrets are migrated and to limit the scope.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-migration-2
Version: 0.1.0
The skill bundle is a legitimate migration utility designed to move user data, memories, and configurations from OpenClaw to Hermes Agent. The Python script `scripts/openclaw_to_hermes.py` performs file operations (copying, merging, and archiving) within the local filesystem and includes safety features like dry-run mode, automatic backups, and detailed reporting. While it can handle sensitive information such as API keys and bot tokens, it requires explicit user consent via the `--migrate-secrets` flag and follows a strict interaction protocol defined in `SKILL.md` to ensure the user is informed of all actions, especially regarding potential conflicts or secret migration.
Capability Assessment
Purpose & Capability
The skill's name and description match the actions present in the code: it reads ~/.openclaw, converts SOUL.md/MEMORY.md/USER.md, copies skills into ~/.hermes/skills/openclaw-imports/, merges allowlists, and writes to Hermes config/.env. These filesystem and config operations are expected for a migration helper. However, the SKILL.md text states that only TELEGRAM_BOT_TOKEN is allowlisted for --migrate-secrets, while the script's SUPPORTED_SECRET_TARGETS includes many provider keys (OpenAI, Anthropic, ElevenLabs, OpenRouter, etc.). That discrepancy is significant and unexplained.
Instruction Scope
The SKILL.md instructs dry runs and interactive prompts and constrains path resolution; the script follows that pattern and provides flags and conflict modes. But the runtime behavior includes reading and writing sensitive files (.env, config.yaml), copying entire skill directories, and archiving files from ~/.openclaw. Those actions are within migration scope but are also high-impact: they touch credentials and global Hermes config. The mismatch about which secrets may be migrated increases risk because users might enable secret migration without realizing provider API keys will be imported.
Install Mechanism
There is no remote install step or external download: this is an instruction-only skill with an included Python script. No network fetches or obscure installers are present. The script will be placed on disk as part of skill installation (normal for instruction-with-script skills).
Credentials
The skill declares no required env vars, which is fine, but the code includes a SUPPORTED_SECRET_TARGETS set that covers many sensitive API tokens (OPENAI_API_KEY, ANTHROPIC_API_KEY, ELEVENLABS_API_KEY, OPENROUTER_API_KEY, etc.) and offers a --migrate-secrets flow. The SKILL.md downplays this by mentioning only TELEGRAM_BOT_TOKEN in the top-level text; the code shows broader secret handling. Migrating provider keys into Hermes .env is sensitive and should be explicit to the user.
Persistence & Privilege
The script will write into ~/.hermes (skills directory, tts, config.yaml, and .env) and can overwrite or rename existing items (it supports conflict modes: skip/overwrite/rename and will backup). That level of persistent modification is expected for a migration tool, but it is privileged: it modifies other skill areas and global agent config. The SKILL.md promises interactive choices and dry runs, but users must ensure they complete those prompts and verify backups before allowing write operations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-migration-2 - After installation, invoke the skill by name or use
/openclaw-migration-2 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of OpenClaw migration skill.
- Enables seamless migration of OpenClaw customizations and user data into Hermes Agent.
- Imports compatible memories, SOUL.md, command allowlists, user skills, and select workspace assets.
- Provides structured dry-run previews, conflict resolution choices, and detailed migration reports.
- Supports both interactive (clarify-based) and CLI migration workflows.
- Ensures all migration decisions are collected interactively before execution.
Metadata
Frequently Asked Questions
What is Openclaw Migration?
Migrate a user's OpenClaw customization footprint into Hermes Agent. Imports Hermes-compatible memories, SOUL.md, command allowlists, user skills, and select... It is an AI Agent Skill for Claude Code / OpenClaw, with 263 downloads so far.
How do I install Openclaw Migration?
Run "/install openclaw-migration-2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openclaw Migration free?
Yes, Openclaw Migration is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Openclaw Migration support?
Openclaw Migration is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openclaw Migration?
It is built and maintained by Agung Prabowo (@agungprabowo123); the current version is v0.1.0.
More Skills