EasyClaw Config Migration
/install easyclaw-config-migration
EasyClaw Config Migration
Locate three config sources before making changes:
~/Library/Application Support/@cfmind/easyclaw/easyclaw.json— EasyClaw desktop UI settings~/.openclaw/easyclaw.json— EasyClaw/OpenClaw bridge config with reusable runtime settings~/.openclaw/openclaw.json— active OpenClaw config
Most directly reusable settings live in ~/.openclaw/easyclaw.json. The desktop easyclaw.json is mostly UI state and usually does not map cleanly into OpenClaw.
Workflow
1. Inspect and compare
Run:
python3 scripts/report_easyclaw_config.py
This prints:
- which files exist
- redacted summaries
- fields that can be migrated automatically
- fields that are desktop-only / no direct OpenClaw equivalent
If you only need a report, stop here and summarize the findings.
2. Review the migration map
Read references/mapping.md when deciding what should be copied automatically versus left for manual review.
Default stance:
- copy only fields with clear semantic equivalents
- do not invent mappings for desktop-only UX settings
- preserve user changes already present in
~/.openclaw/openclaw.jsonunless the migration is explicitly requested
3. Apply a selective merge
Run:
python3 scripts/merge_easyclaw_config.py --apply
Behavior:
- create a timestamped backup of
~/.openclaw/openclaw.json - merge only supported fields from
~/.openclaw/easyclaw.json - print changed paths
Dry run first when practical:
python3 scripts/merge_easyclaw_config.py
4. Validate and summarize
After applying, read ~/.openclaw/openclaw.json or use normal OpenClaw validation/status commands if needed. Summarize:
- what was migrated
- what was intentionally skipped
- where the backup was written
Notes
- Treat tokens, secrets, and auth blobs as sensitive. Redact them in chat unless the user explicitly wants raw values.
- If only the desktop EasyClaw file exists, explain that most of it is app/window preference state and not the main OpenClaw runtime config.
- If both
~/.openclaw/easyclaw.jsonand~/.openclaw/openclaw.jsonexist, prefer a selective merge over wholesale overwrite. - Never overwrite
~/.openclaw/openclaw.jsonwithout creating a backup first.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install easyclaw-config-migration - 安装完成后,直接呼叫该 Skill 的名称或使用
/easyclaw-config-migration触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
EasyClaw Config Migration 是什么?
Migrate settings from EasyClaw into OpenClaw by locating EasyClaw desktop/runtime config files, comparing them with ~/.openclaw/openclaw.json, and safely gen... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 237 次。
如何安装 EasyClaw Config Migration?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install easyclaw-config-migration」即可一键安装,无需额外配置。
EasyClaw Config Migration 是免费的吗?
是的,EasyClaw Config Migration 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
EasyClaw Config Migration 支持哪些平台?
EasyClaw Config Migration 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 EasyClaw Config Migration?
由 sjinopenclaw(@sjingh)开发并维护,当前版本 v0.1.0。