Maintenance
مهاجرت از Claude
OpenClaw وضعیت محلی Claude را از طریق provider مهاجرت Claude که بهصورت همراه ارائه شده است، وارد میکند. این provider پیش از تغییر وضعیت، هر مورد را پیشنمایش میکند، اسرار را در طرحها و گزارشها بازنویسی محرمانه میکند، و پیش از اعمال، یک پشتیبان تاییدشده ایجاد میکند.
دو روش برای واردسازی
Onboarding wizard
وقتی wizard وضعیت محلی Claude را تشخیص دهد، Claude را پیشنهاد میدهد.
openclaw onboard --flow import
یا آن را به یک منبع مشخص اشاره دهید:
openclaw onboard --import-from claude --import-source ~/.claude
CLI
برای اجراهای اسکریپتشده یا تکرارپذیر از openclaw migrate استفاده کنید. برای مرجع کامل، openclaw migrate را ببینید.
openclaw migrate claude --dry-run
openclaw migrate apply claude --yes
برای واردسازی یک خانه Claude Code یا ریشه پروژه مشخص، --from <path> را اضافه کنید.
چه چیزهایی وارد میشوند
Instructions and memory
- محتوای
CLAUDE.mdپروژه و.claude/CLAUDE.mdدر workspace عامل OpenClaw یعنیAGENTS.mdکپی یا به آن افزوده میشود. - محتوای
~/.claude/CLAUDE.mdکاربر بهUSER.mdدر workspace افزوده میشود.
MCP servers
تعریفهای سرور MCP، در صورت وجود، از .mcp.json پروژه، فایل ~/.claude.json مربوط به Claude Code، و claude_desktop_config.json مربوط به Claude Desktop وارد میشوند.
Skills and commands
- Skills مربوط به Claude که فایل
SKILL.mdدارند، در دایرکتوری skills مربوط به workspace در OpenClaw کپی میشوند. - فایلهای Markdown فرمان Claude زیر
.claude/commands/یا~/.claude/commands/به skills در OpenClaw باdisable-model-invocation: trueتبدیل میشوند.
چه چیزهایی فقط بهصورت آرشیو باقی میمانند
provider این موارد را برای بازبینی دستی در گزارش مهاجرت کپی میکند، اما آنها را در پیکربندی زنده OpenClaw بارگذاری نمیکند:
- hookهای Claude
- مجوزهای Claude و فهرستهای مجاز گسترده ابزارها
- پیشفرضهای محیطی Claude
CLAUDE.local.md.claude/rules/- زیرعاملهای Claude زیر
.claude/agents/یا~/.claude/agents/ - cacheها، طرحها و دایرکتوریهای تاریخچه پروژه Claude Code
- افزونههای Claude Desktop و اعتبارنامههای ذخیرهشده در سیستمعامل
OpenClaw از اجرای خودکار hookها، اعتماد به فهرستهای مجاز مجوز، یا رمزگشایی وضعیت مبهم OAuth و اعتبارنامههای Desktop خودداری میکند. پس از بررسی آرشیو، موارد موردنیازتان را بهصورت دستی منتقل کنید.
انتخاب منبع
بدون --from، OpenClaw خانه پیشفرض Claude Code در ~/.claude، فایل وضعیت نمونهبرداریشده ~/.claude.json مربوط به Claude Code، و پیکربندی MCP مربوط به Claude Desktop در macOS را بررسی میکند.
وقتی --from به ریشه یک پروژه اشاره کند، OpenClaw فقط فایلهای Claude مربوط به همان پروژه را وارد میکند، مانند CLAUDE.md، .claude/settings.json، .claude/commands/، .claude/skills/، و .mcp.json. هنگام واردسازی از ریشه پروژه، خانه سراسری Claude شما را نمیخواند.
روند پیشنهادی
Preview the plan
openclaw migrate claude --dry-run
این طرح همه چیزهایی را که تغییر خواهند کرد فهرست میکند، از جمله conflictها، موارد ردشده، و مقادیر حساس بازنویسی محرمانهشده از فیلدهای تودرتوی env یا headers مربوط به MCP.
Apply with backup
openclaw migrate apply claude --yes
OpenClaw پیش از اعمال، یک پشتیبان ایجاد و تایید میکند.
Run doctor
openclaw doctor
Doctor پس از واردسازی، مشکلات پیکربندی یا وضعیت را بررسی میکند.
Restart and verify
openclaw gateway restart
openclaw status
تایید کنید که Gateway سالم است و دستورالعملهای واردشده، سرورهای MCP و skills شما بارگذاری شدهاند.
مدیریت conflictها
اگر طرح conflictهایی را گزارش کند، apply از ادامه کار خودداری میکند (یعنی یک فایل یا مقدار پیکربندی از قبل در مقصد وجود دارد).
برای یک نصب تازه OpenClaw، conflictها غیرمعمول هستند. آنها معمولا وقتی ظاهر میشوند که واردسازی را روی نصبی دوباره اجرا کنید که از قبل ویرایشهای کاربر را دارد.
خروجی JSON برای خودکارسازی
openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
با --json و بدون --yes، apply طرح را چاپ میکند و وضعیت را تغییر نمیدهد. این امنترین حالت برای CI و اسکریپتهای مشترک است.
عیبیابی
Claude state lives outside ~/.claude
--from /actual/path (CLI) یا --import-source /actual/path (راهاندازی اولیه) را ارسال کنید.
Onboarding refuses to import on an existing setup
واردسازیهای راهاندازی اولیه به یک نصب تازه نیاز دارند. یا وضعیت را بازنشانی کنید و دوباره راهاندازی اولیه را انجام دهید، یا مستقیما از openclaw migrate apply claude استفاده کنید که از --overwrite و کنترل صریح پشتیبان پشتیبانی میکند.
MCP servers from Claude Desktop did not import
Claude Desktop فایل claude_desktop_config.json را از یک مسیر وابسته به پلتفرم میخواند. اگر OpenClaw آن را بهصورت خودکار تشخیص نداد، --from را به دایرکتوری همان فایل اشاره دهید.
Claude commands became skills with model invocation disabled
این رفتار تعمدی است. فرمانهای Claude توسط کاربر راهاندازی میشوند، بنابراین OpenClaw آنها را بهصورت skills با disable-model-invocation: true وارد میکند. اگر میخواهید عامل آنها را بهصورت خودکار فراخوانی کند، frontmatter هر skill را ویرایش کنید.
مرتبط
openclaw migrate: مرجع کامل CLI، قرارداد Plugin، و ساختارهای JSON.- راهنمای مهاجرت: همه مسیرهای مهاجرت.
- مهاجرت از Hermes: مسیر دیگر واردسازی میانسیستمی.
- راهاندازی اولیه: جریان wizard و flagهای غیرتعاملی.
- Doctor: بررسی سلامت پس از مهاجرت.
- workspace عامل: جایی که
AGENTS.md،USER.md، و skills قرار دارند.