# Migrate from OpenClaw to Hyperagent Source: https://www.hyperagent.com/docs/migrate/openclaw Migrate your OpenClaw agent in minutes using the import wizard. The OpenClaw import wizard brings an agent you've already built in OpenClaw into Hyperagent, including its instructions, memories, scheduled tasks, tools, channels, and skills. Your first import is free. This guide explains what gets migrated, how the import wizard works, what needs to be reconnected, and what to expect if something doesn't translate cleanly. ## Quickstart [#quickstart] 1. In Hyperagent, go to **Settings → Import from OpenClaw** (or select **Import from OpenClaw** during onboarding). 2. Locate your OpenClaw workspace folder. In many installations, it's stored at `~/.openclaw/workspace`, though the exact location may vary. 3. You can bring the workspace into Hyperagent three ways: * the workspace folder, * a `.zip` or `.tar.gz` archive, or * the individual workspace files. 4. Review the import preview, choose what to bring over, connect any tools or channels you want to use, and select **Import Agent**. *** ## What the import wizard does [#what-the-import-wizard-does] What the import wizard does The import has four steps: 1. **Upload:** Drop your `~/.openclaw/workspace` folder or a zip of it. The wizard accepts the whole thing and uses what's relevant. 2. **Preview:** You see your workspace files mapped to where they live in Hyperagent, `SOUL.md` and `AGENTS.md` into your system prompt, `HEARTBEAT.md` into schedules, `MEMORY.md` into memories, and so on. You can rename the agent, edit its instructions, and select which tools to connect before anything is committed. 3. **Connect tools:** You choose which integrations to connect and in what order. The wizard shows each tool's status. Nothing runs until you reconnect. You'll also set up Live Mode here if you want your agent to run continuously. 4. **Done:** You land in the agent config to review schedules, confirm everything looks right, and choose when to open a thread. You can start the import from the onboarding card or from **Settings**. If you want the background on what lands where, skim [Skills](/docs/concepts/skills), [Memories](/docs/concepts/memories), and [Threads](/docs/concepts/threads) while you work. *** ## Import your agent [#import-your-agent] ### Open the import wizard [#open-the-import-wizard] Select your profile icon in the lower-left corner, choose **Settings**, then open **Import from OpenClaw**. ### Export your OpenClaw workspace files [#export-your-openclaw-workspace-files] Collect the files OpenClaw needs. `AGENTS.md` is the only required file, but including the rest of your workspace helps Hyperagent import your instructions, memories, schedules, tools, and skills more accurately. If your workspace is in the common hidden folder, open it with the command for your operating system: ```bash open ~/.openclaw/workspace ``` ```powershell explorer "$env:USERPROFILE\.openclaw\workspace" ``` ```bash xdg-open ~/.openclaw/workspace ``` If your workspace lives somewhere else, use that real path instead. To create an archive manually, navigate to the workspace and package the files you want to import: ```bash cd /path/to/openclaw/workspace zip -r openclaw-export.zip AGENTS.md SOUL.md IDENTITY.md USER.md MEMORY.md HEARTBEAT.md TOOLS.md memory/ skills/ ``` ```powershell cd "$env:USERPROFILE\.openclaw\workspace" Compress-Archive -Path AGENTS.md,SOUL.md,IDENTITY.md,USER.md,MEMORY.md,HEARTBEAT.md,TOOLS.md,memory,skills -DestinationPath openclaw-export.zip ``` This creates `openclaw-export.zip` in the same folder. If you do not have daily logs or custom skills, omit `memory/` or `skills` from the command. Your workspace is processed in your browser, on your own computer. Only the agent content needed for the import is uploaded. Agent instructions, memories, schedules, skills, and the metadata needed to map tools and channels. Your OpenClaw database contents, session history, channel tokens, webhook URLs, scratch notes, logs, caches, and unrecognized files stay on your machine. To read scheduled tasks, the wizard may send database column names such as `prompt` to the server. It does not send the column contents. Drop in just your OpenClaw workspace, not your whole home folder. The wizard only uses recognized workspace files, so including virtual environments, Git repositories, caches, or other large folders only increases upload size and review time. Large uploads may exceed file count or size limits. ### Upload and preview [#upload-and-preview] Drop your folder, archive, or individual markdown files into the wizard. The wizard reads the upload locally, detects what is available, and builds a preview. If the upload contains more than one agent, you will pick one to import first. Drop in your workspace folder, archive, or files. Review the imported agent, memories, tools, and channels before you bring it home. OpenClaw-specific sections are removed during migration. Nothing is added to your account until you confirm. You can uncheck anything you do not want, edit the agent name and instructions, review memories one by one, and restore trimmed instruction text if needed. Preview is a curation step, not a blind copy. Hyperagent maps what it can, flags what needs your attention, and lets you decide what gets committed. ### Connect tools and channels [#connect-tools-and-channels] After you confirm the preview, Hyperagent invites you to connect any matched integrations. Nothing runs until you connect the tools you want to use. Telegram and Slack channels need to be reconnected. Email needs no setup because your agent gets its own email address automatically. Connect matched integrations now, or skip and finish setup later from settings. Reconnect channels so the imported agent stays reachable where it already worked. ### Meet your agent [#meet-your-agent] You land on the imported agent's page with a `Talk to {Your Agent's Name}` button. The first conversation introduces the agent in its imported voice, explains what it can now do, and suggests concrete first actions. The first import is free. Additional imports may use your normal account usage after the free allowance is used. ## What gets migrated [#what-gets-migrated] | OpenClaw File | Hyperagent Destination | Notes | | ------------- | ------------------------------------- | -------- | | `SOUL.md` | Agent system prompt (persona section) | Verbatim | | `IDENTITY.md` | Agent system prompt (operating rules) | Verbatim | | `AGENTS.md` | Merged into system prompt | Verbatim | In OpenClaw, these were separate files your agent read at the start of each session. In Hyperagent, they live in the Identity tab of your agent as a single editable system prompt. Same content, one place. The preview shows the actual text inline so you can verify your content before confirming, but this can always be adjusted later on. Anything that's OpenClaw-specific (references to HEARTBEAT.md, heartbeat syntax, OpenClaw tool names) is flagged for your review — you decide what to keep or update. | OpenClaw File | Hyperagent Destination | Notes | | ---------------------- | ---------------------- | ------------------------------------------------------------------------- | | `MEMORY.md` | Agent-scoped memories | Split into individual entries, de-duplicated | | `USER.md` | Agent-scoped memories | Same entry-merge logic | | `memory/YYYY-MM-DD.md` | Agent-scoped memories | AI distills durable takeaways; raw session logs aren't imported wholesale | In OpenClaw, memories were a flat file your agent re-read each session. In Hyperagent, memories are live and scored — on an importance scale of 1 to 5. Any memory with importance 4+ loads automatically in every conversation, lower-importance ones surface when relevant. Your agent will know more without being told more. The import is a curation moment, not just a file copy — which is better than a straight transfer, because OpenClaw memory accumulates cruft over time. Everything lands visible and editable, and your agent can never overwrite what it knows without your approval. In OpenClaw, `HEARTBEAT.md` was a checklist your agent read to know what to do and when. In Hyperagent, it can turn into two invocation types: schedules and Live Mode. * **Schedules** trigger on a fixed cadence to run a process. If the schedule is enabled, it always runs. * **Live Mode** checks whether anything needs to be done on an interval. If there is no work to act on, the agent stays quiet. Schedules run the selected process every time the cadence fires. Live Mode checks on an interval and stays quiet when there is nothing to do. After import, both schedules and Live Mode checks are paused. Review them before enabling, confirm cadence, time, timezone, and expected behavior, then toggle them live. Note: cron jobs configured outside your markdown files, including system cron job entries and shell scripts, won't be picked up. Recreate those manually under the Schedules tab. In OpenClaw, `TOOLS.md` told your agent which tools existed. In Hyperagent, integrations are live OAuth connections. Your agent can actually read your calendar, draft in Gmail, or update Linear, not just know about them. You select which tools to connect and choose the order. The connect step queues only what needs OAuth, not tools that are already live. | Channel | Setup | | -------- | ------------------------------------------------------------------ | | Telegram | Requires re-authentication with your bot token | | Slack | Requires re-authentication via OAuth | | Email | Hyperagent will provide a new email address for your agent to use. | | Discord | In Development | In OpenClaw, channels were where you talked to your agent. In Hyperagent, channels are delivery surfaces your agent can use after you reconnect them. Hyperagent does not transfer channel credentials for security reasons. The wizard queues your channel re-auth alongside your tool connections so it's one flow, not a separate manual step. If the wizard says **no message channels were configured** but you do have Telegram or Slack set up, your channel credentials likely weren't stored in the workspace markdown files. Reconnect manually after import. Custom skill packages carry over as-is and stay scoped to the imported agent. If a skill duplicates a native Hyperagent integration, the preview can start it unchecked and show the built-in replacement instead. ## What does not move [#what-does-not-move] `BOOTSTRAP.md`, one-time reminders, out-of-band cron jobs, OpenClaw plugins, channel tokens, webhook URLs, and raw session history do not move with the import. * Recreate one-time reminders manually * Reconnect channels during the import flow * Reconnect tools after the preview * Keep OpenClaw running until you are satisfied with the imported agent ## Important notes [#important-notes] Schedules and Live Mode come over paused. Nothing runs automatically until you review it and switch it on. Your agent remembers across conversations in Hyperagent. You do not need to maintain `MEMORY.md` by hand anymore. Tools and channels need one-time setup after import before the agent can act on your accounts or reach you there. If your OpenClaw folder contains several agents, run the import once for each agent. If you start an import and do not finish, your in-progress preview appears under **Pick up where you left off** the next time you open the wizard. For the most up-to-date schedules, export with the OpenClaw gateway stopped. Recent schedule changes may otherwise still be in a temporary file. ## Limits [#limits] | Import item | Limit per import | | ----------- | ---------------- | | Memories | 100 | | Schedules | 10 | | Tools | 24 | | Channels | 8 | | Skills | 20 | | Files | 300 | Anything beyond those caps is left out with a note explaining what was skipped so you can add it by hand. Individual files and the overall upload also have size limits. If you hit them, trim the largest files or zip only the workspace folder. ## After the import [#after-the-import] If you want to understand how the imported setup behaves day to day, skim [Threads](/docs/concepts/threads) for the run workspace and [Skills](/docs/concepts/skills) for repeatable methods. Confirm cadence and timezone, then enable the schedules you want running in the cloud. Scan for stale notes or log artifacts and prune anything you do not want to keep. Open a thread when you are ready and let the imported agent introduce itself. The import is a copy, not a move. Keep your old setup until you are satisfied. If your OpenClaw setup relied on heartbeats or a persistent messaging channel, turn on Live Mode after import. ## Troubleshooting [#troubleshooting] Make sure you are dropping the OpenClaw workspace folder, not a parent folder without `AGENTS.md`. Your upload contains files from more than one agent. Import them separately. Drop just the OpenClaw workspace or a zip of it, not a larger parent folder. Zip the workspace files directly rather than zipping a folder that already contains another archive. Usually transient. Try again, ideally after stopping the OpenClaw gateway. A saved preview was already completed or expired. Start a fresh upload. Hyperagent does not have a matching integration for that OpenClaw tool yet. You can continue without it. ## How AI is used [#how-ai-is-used] The wizard uses a single LLM pass during the Preview step. Its job is **judgment and translation only**, not rewriting your content: * Inferring an agent name, icon, short description, and role label from your files * Scoring memories by category (fact about you, preference, project context, etc.), importance, and whether to pin them * Translating your `HEARTBEAT.md` checklist into proper recurring schedules with the correct cadence and timezone * Matching OpenClaw tools to Hyperagent integrations and mapping your messaging channels * Flagging anything that didn't translate cleanly **The AI never rewrites, paraphrases, or "improves" your instructions or memories.** Your `SOUL.md`, `AGENTS.md`, and `IDENTITY.md` are carried over word-for-word. Your memory text is exactly what you wrote. The LLM classifies and scores by reference — it doesn't touch the content itself. Everything else in the wizard is deterministic code: unzipping, safety checks, memory splitting, agent creation, schedule import (imported paused so nothing runs until you've reviewed it), and database writes. ## FAQs [#faqs] Simple agents should not take more than 20 minutes. If you have a long list of tools to reconnect and secrets to re-enter, budget a little more time. Hyperagent translates your markdown memory files into editable agent memories. The preview lets you review each memory and uncheck anything you do not want. Yes. The preview shows the assembled instructions before anything is created. You can edit them, restore trimmed OpenClaw-specific text, or leave the cleaned version. No. Schedules and Live Mode import paused, and tools do not run until you connect them. Hyperagent supports the following models. See the [Supported Models](/docs/concepts/agents/models) documentation for more information. **Anthropic:** Claude Fable 5, Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 5, Sonnet 4.6, Haiku 4.5 **OpenAI:** GPT 5.6 Sol, GPT 5.6 Terra, GPT 5.6 Luna, GPT 5.5 **Google:** Gemini 3.6 Flash, Gemini 3.5 Flash **Moonshot AI (Kimi):** Kimi K3, Kimi K3 Fast, Kimi K2.6 **Z.ai:** GLM 5.2, GLM 5.2 Fast **Alibaba:** Qwen 3.7 Plus **DeepSeek:** DeepSeek V4 Pro **Sakana AI:** Fugu Ultra **xAI:** Grok 4.5 **Meta:** Muse Spark 1.1 **Thinking Machines:** Inkling Yes. Each agent session runs in an isolated VM. Integrations connect via OAuth, and a human-in-the-loop write gate prevents the agent from acting on injected instructions without review. No. The import is a copy, so your old setup keeps running until you decide to turn it off on your schedule. ## Get help in Discord [#get-help-in-discord] If anything looks off during the preview, if a tool is not supported, or if something did not come through the way you expected, join our [Discord community for support.](https://discord.gg/zBtVmkvZ9)