Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- BREAKING: Migration and setup flow now runs via openclaw honcho setup, not custom migration logic. - No workspace or memory files are deleted, moved, or modified—setup is non-destructive. - HEARTBEAT.md is now excluded from migration, as it is not memory. - Explicit interactive user confirmation is always required before any data upload, even if the API key is preset. - After setup, the plugin continuously observes and uploads conversation data to Honcho until disabled. - Plugin config is written to ~/.openclaw/openclaw.json; other credentials or workspace files remain untouched.
What This Skill Does
Installs the @honcho-ai/openclaw-honcho plugin and migrates workspace memory files (USER.md, MEMORY.md, memory/, canvas/, and agent config files) to the Honcho API. After setup, the plugin observes conversations and transmits data to Honcho persistently across sessions. Workspace files are never modified or deleted during migration.
Replaces file-based memory with an API-backed system that persists and retrieves context across sessions without manual file management.
When to use it
- Migrating file-based workspace memory to Honcho's cloud API
- Enabling persistent AI agent memory that carries over across sessions
- Connecting OpenClaw to a self-hosted Honcho instance instead of the managed cloud
- Recalling past conversation context via honcho_recall and honcho_search tools
- Consolidating scattered agent config files into a single API-backed memory backend
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Set up Honcho memory for my OpenClaw workspace
- 1Runs `openclaw plugins install @honcho-ai/openclaw-honcho` to install the plugin
- 2Runs `openclaw plugins enable openclaw-honcho` to activate it
- 3Runs `openclaw honcho setup`, prompts user for API key and shows exact file list before any upload
- 4Waits for explicit user confirmation, then migrates USER.md, MEMORY.md, memory/, canvas/, and agent config files to api.honcho.dev
- 5Runs `openclaw gateway restart` and verifies status with `openclaw honcho status`
Honcho plugin active with persistent conversation observation enabled; workspace memory uploaded to Honcho and accessible via recall and search tools
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.