Skip to content

docs(kilo-docs): add workspace migration section to KiloClaw FAQ#8287

Merged
alexkgold merged 5 commits intomainfrom
docs/kiloclaw-workspace-migration
Apr 6, 2026
Merged

docs(kilo-docs): add workspace migration section to KiloClaw FAQ#8287
alexkgold merged 5 commits intomainfrom
docs/kiloclaw-workspace-migration

Conversation

@kilo-code-bot
Copy link
Copy Markdown
Contributor

@kilo-code-bot kilo-code-bot bot commented Apr 3, 2026

Summary

  • Rewrites the workspace migration FAQ section to explicitly cover all three migration scenarios:
    • Migrating from another OpenClaw provider to KiloClaw
    • Moving between KiloClaw instances (e.g., individual to org, or vice versa)
    • Leaving KiloClaw for another OpenClaw provider
  • Makes clear that the process is the same for all three cases: back up workspace, set up new provider/Claw, restore workspace files, reconfigure integrations
  • Distinguishes what migrates automatically via backup/restore (workspace files, memory, context) from what needs manual reconfiguration (Google, GitHub, GitLab, Linear, Telegram, Discord, Slack integrations)
  • Includes both backup options: GitHub export and manual download via Google Drive
  • Keeps the content practical and concise with a clear 4-step process

Built for Alex Gold by Kilo for Slack

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs (docs-staging) Ready Ready Preview, Comment Apr 6, 2026 2:01pm

Request Review


Ask your Claw to push the workspace to a GitHub repository:

> Create a new GitHub repo and push your entire workspace there with the `gh` CLI. Tell me the URL of the repo you used.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WARNING: GitHub repo backup can produce incomplete restores

Pushing the entire workspace into a new GitHub repository does not faithfully preserve common /root/clawd layouts. Nested project repositories are typically recorded as gitlinks instead of full contents, and anything not committed into the temporary backup repo is dropped on restore. That makes this migration path prone to silent data loss unless it is limited to non-nested workspaces or changed to use an archive-based backup.

@kilo-code-bot
Copy link
Copy Markdown
Contributor Author

kilo-code-bot bot commented Apr 3, 2026

Code Review Summary

Status: 1 Issues Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
packages/kilo-docs/pages/kiloclaw/faq/general.md 49 GitHub repo backup instructions can silently lose nested repository contents and git metadata during restore.
Other Observations (not in diff)

No additional issues found outside the diff.

Files Reviewed (1 file)
  • packages/kilo-docs/pages/kiloclaw/faq/general.md - 1 issue

Fix these issues in Kilo Cloud


Reviewed by gpt-5.4-20260305 · 136,500 tokens

…AQ page

Move the 'Migrating Your Workspace' content from dashboard.md to
faq/general.md where it better fits as a frequently asked question.
The FAQ version is expanded with a clear what-migrates/what-doesn't
breakdown, workspace memory/context note, and step-by-step
integration reconfiguration instructions.
@kilo-code-bot kilo-code-bot bot changed the title docs(kilo-docs): add workspace migration section to KiloClaw dashboard docs(kilo-docs): add workspace migration section to KiloClaw FAQ Apr 3, 2026
Comment thread packages/kilo-docs/pages/kiloclaw/faq/general.md
…n scenarios

Rewrite the migration section to explicitly cover three use cases:
- Migrating from another OpenClaw provider to KiloClaw
- Moving between KiloClaw instances (individual to org or vice versa)
- Leaving KiloClaw for another OpenClaw provider

Clarify that the process is the same for all three, and distinguish
what migrates via backup/restore (workspace files, memory, context)
from what needs manual reconfiguration (integrations).
Updated migration instructions for OpenClaw to clarify workspace migration process and reconfiguration of integrations.
@alexkgold alexkgold merged commit dbc635e into main Apr 6, 2026
15 checks passed
@alexkgold alexkgold deleted the docs/kiloclaw-workspace-migration branch April 6, 2026 14:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants