Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
honcho-setup 1.0.4 - Clarified that data upload via `openclaw honcho setup` always requires explicit interactive user confirmation, even when `HONCHO_API_KEY` is set. - Updated documentation to warn that, after setup, the plugin persistently observes conversations and transmits data to Honcho on an ongoing basis. - Expanded instructions on disabling the plugin to stop ongoing data transmission. - No changes to files or core functionality; documentation only.
What This Skill Does
Installs the @honcho-ai/openclaw-honcho plugin and migrates legacy workspace memory files to Honcho. Uploads contents of USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/, and agent config files to api.honcho.dev or a self-hosted instance. Requires explicit user confirmation before any upload, and archives all originals locally before removal.
Handles the full migration in one guided flow with backup verification before any file is deleted, instead of requiring manual SDK calls and file operations.
When to use it
- Migrating OpenClaw file-based memory to Honcho cloud storage
- Connecting a workspace to a self-hosted local Honcho instance
- Archiving legacy workspace memory files before switching AI memory backends
- Installing the Honcho plugin into an OpenClaw workspace
- Updating SOUL.md and AGENTS.md to reference Honcho memory tools
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Set up Honcho for my OpenClaw workspace
- 1Installs @honcho-ai/openclaw-honcho via openclaw plugins install and enables the plugin
- 2Checks for HONCHO_API_KEY and verifies the Honcho API connection
- 3Scans the workspace root and presents detected legacy memory files with sizes and the upload destination URL
- 4After user confirmation, uploads each file to Honcho using the owner peer for user files and the openclaw peer for agent config files
- 5Archives originals to {workspace_root}/archive/, removes legacy-only files, and updates SOUL.md, AGENTS.md, and BOOTSTRAP.md to reference Honcho tools
Legacy memory files uploaded and archived; workspace docs updated to use honcho_profile, honcho_context, honcho_search, honcho_recall, and honcho_analyze
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.