{
  "schemaVersion": "1.0",
  "item": {
    "slug": "honcho-setup",
    "name": "Long-Term Memory (Honcho)",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/ajspig/honcho-setup",
    "canonicalUrl": "https://clawhub.ai/ajspig/honcho-setup",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/honcho-setup",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=honcho-setup",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "_meta.json",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "honcho-setup",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T07:56:20.455Z",
      "expiresAt": "2026-05-07T07:56:20.455Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=honcho-setup",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=honcho-setup",
        "contentDisposition": "attachment; filename=\"honcho-setup-1.0.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "honcho-setup"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/honcho-setup"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/honcho-setup",
    "agentPageUrl": "https://openagent3.xyz/skills/honcho-setup/agent",
    "manifestUrl": "https://openagent3.xyz/skills/honcho-setup/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/honcho-setup/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Honcho Setup",
        "body": "Install the @honcho-ai/openclaw-honcho plugin. The plugin includes openclaw honcho setup, which handles API key configuration and migration of any legacy memory files to Honcho.\n\n⚠️ DATA UPLOAD WARNING: openclaw honcho setup (run in Step 2) will offer to upload your workspace memory files (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/, SOUL.md, AGENTS.md, BOOTSTRAP.md, TOOLS.md) to an external API. HEARTBEAT.md is excluded. By default, data is sent to api.honcho.dev. For self-hosted instances, data is sent to your configured HONCHO_BASE_URL. The setup command will show exactly which files will be uploaded and ask for explicit confirmation before proceeding.\n\nNo local files are deleted, moved, or modified. Originals remain exactly in place."
      },
      {
        "title": "Step 1: Install the Plugin",
        "body": "Install the Honcho plugin using the OpenClaw plugin system. Use this exact command — do not install @honcho-ai/sdk directly or use npm install in the workspace.\n\nopenclaw plugins install @honcho-ai/openclaw-honcho\n\nThen enable it:\n\nopenclaw plugins enable openclaw-honcho\n\nVerify the plugin loaded without errors. If the gateway logs show Cannot find module '@honcho-ai/sdk', install dependencies manually:\n\ncd ~/.openclaw/extensions/openclaw-honcho && npm install\n\nThis is a known issue with the OpenClaw plugin installer not running dependency resolution for plugin packages."
      },
      {
        "title": "Step 2: Run Setup",
        "body": "Run the setup command that ships with the plugin:\n\nopenclaw honcho setup\n\nThis command will:\n\nPrompt interactively for your Honcho API key\nWrite configuration to ~/.openclaw/openclaw.json\nScan for legacy memory files and offer to migrate them to Honcho\n\nFollow the prompts. Migration is optional — if you have no legacy files or want to skip, you can skip the upload step.\n\nFor managed Honcho, you need an API key from https://app.honcho.dev. For self-hosted instances, set HONCHO_BASE_URL to your instance URL and the API key is optional."
      },
      {
        "title": "Step 3: Restart the Gateway",
        "body": "openclaw gateway restart"
      },
      {
        "title": "Step 4: Confirm",
        "body": "Verify the plugin is active by checking gateway logs or running:\n\nopenclaw honcho status\n\nHoncho memory is now active.\n\nOngoing behavior after setup: Once enabled, the plugin will persistently observe conversations in this workspace and send conversation data to api.honcho.dev (or your configured HONCHO_BASE_URL) to build and retrieve memory. This is ongoing network activity that continues across sessions. Memory is made available via honcho_recall, honcho_search, honcho_profile, and related tools. To stop this behavior, disable the plugin with openclaw plugins disable openclaw-honcho."
      },
      {
        "title": "Security & Privacy Disclosure",
        "body": "This skill has been designed with transparency and safety as priorities. Below is a complete disclosure of what this skill does:"
      },
      {
        "title": "What This Skill Does",
        "body": "This skill runs three commands: openclaw plugins install, openclaw honcho setup, and openclaw gateway restart. The data upload and file access described below is performed by openclaw honcho setup, not by this skill directly."
      },
      {
        "title": "Data Upload",
        "body": "uploaded_content: USER.md, MEMORY.md, IDENTITY.md, all files under memory/, all files under canvas/, SOUL.md, AGENTS.md, BOOTSTRAP.md, TOOLS.md — uploaded by openclaw honcho setup during migration\nnot_uploaded: HEARTBEAT.md — excluded by design, never read or uploaded\nWhere it goes: By default to api.honcho.dev (managed Honcho cloud service). For self-hosted instances, to your configured HONCHO_BASE_URL\nUser control: openclaw honcho setup always requires explicit interactive confirmation before any upload, even when HONCHO_API_KEY is pre-set in the environment. You will see the exact list of files and the destination URL\nPurpose: Migrating file-based memory system to Honcho API for AI agent personalization and memory"
      },
      {
        "title": "File Modifications",
        "body": "Config written: openclaw honcho setup writes API key and config to ~/.openclaw/openclaw.json\nWorkspace files: Never modified — originals remain exactly in place\nHEARTBEAT.md: Never read or uploaded — excluded by design"
      },
      {
        "title": "Credentials",
        "body": "HONCHO_API_KEY: Required only for managed Honcho (api.honcho.dev). Not required for self-hosted instances. Stored in ~/.openclaw/openclaw.json by the setup command.\nNo other credentials: This skill does not access, read, or transmit any other credentials or secrets"
      },
      {
        "title": "Network Access",
        "body": "Managed mode: Connects to api.honcho.dev (Honcho cloud service)\nSelf-hosted mode: Connects to your configured HONCHO_BASE_URL (e.g., http://localhost:8000)"
      },
      {
        "title": "Ongoing Behavior After Setup",
        "body": "Persistent observation: Once enabled, the plugin observes all conversations in the workspace and transmits conversation data to the configured Honcho endpoint on an ongoing basis\nNetwork activity: Continues across sessions as long as the plugin is enabled — this is not a one-time migration\nHow to stop: Run openclaw plugins disable openclaw-honcho to stop all observation and network activity"
      },
      {
        "title": "Open Source",
        "body": "Honcho SDK: Open source at https://github.com/plastic-labs/honcho\nPlugin code: Available at ~/.openclaw/extensions/openclaw-honcho after installation\nThis skill: You are reading the complete skill instructions - there is no hidden behavior"
      }
    ],
    "body": "Honcho Setup\n\nInstall the @honcho-ai/openclaw-honcho plugin. The plugin includes openclaw honcho setup, which handles API key configuration and migration of any legacy memory files to Honcho.\n\n⚠️ DATA UPLOAD WARNING: openclaw honcho setup (run in Step 2) will offer to upload your workspace memory files (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/, SOUL.md, AGENTS.md, BOOTSTRAP.md, TOOLS.md) to an external API. HEARTBEAT.md is excluded. By default, data is sent to api.honcho.dev. For self-hosted instances, data is sent to your configured HONCHO_BASE_URL. The setup command will show exactly which files will be uploaded and ask for explicit confirmation before proceeding.\n\nNo local files are deleted, moved, or modified. Originals remain exactly in place.\n\nStep 1: Install the Plugin\n\nInstall the Honcho plugin using the OpenClaw plugin system. Use this exact command — do not install @honcho-ai/sdk directly or use npm install in the workspace.\n\nopenclaw plugins install @honcho-ai/openclaw-honcho\n\n\nThen enable it:\n\nopenclaw plugins enable openclaw-honcho\n\n\nVerify the plugin loaded without errors. If the gateway logs show Cannot find module '@honcho-ai/sdk', install dependencies manually:\n\ncd ~/.openclaw/extensions/openclaw-honcho && npm install\n\n\nThis is a known issue with the OpenClaw plugin installer not running dependency resolution for plugin packages.\n\nStep 2: Run Setup\n\nRun the setup command that ships with the plugin:\n\nopenclaw honcho setup\n\n\nThis command will:\n\nPrompt interactively for your Honcho API key\nWrite configuration to ~/.openclaw/openclaw.json\nScan for legacy memory files and offer to migrate them to Honcho\n\nFollow the prompts. Migration is optional — if you have no legacy files or want to skip, you can skip the upload step.\n\nFor managed Honcho, you need an API key from https://app.honcho.dev. For self-hosted instances, set HONCHO_BASE_URL to your instance URL and the API key is optional.\n\nStep 3: Restart the Gateway\nopenclaw gateway restart\n\nStep 4: Confirm\n\nVerify the plugin is active by checking gateway logs or running:\n\nopenclaw honcho status\n\n\nHoncho memory is now active.\n\nOngoing behavior after setup: Once enabled, the plugin will persistently observe conversations in this workspace and send conversation data to api.honcho.dev (or your configured HONCHO_BASE_URL) to build and retrieve memory. This is ongoing network activity that continues across sessions. Memory is made available via honcho_recall, honcho_search, honcho_profile, and related tools. To stop this behavior, disable the plugin with openclaw plugins disable openclaw-honcho.\n\nSecurity & Privacy Disclosure\n\nThis skill has been designed with transparency and safety as priorities. Below is a complete disclosure of what this skill does:\n\nWhat This Skill Does\n\nThis skill runs three commands: openclaw plugins install, openclaw honcho setup, and openclaw gateway restart. The data upload and file access described below is performed by openclaw honcho setup, not by this skill directly.\n\nData Upload\nuploaded_content: USER.md, MEMORY.md, IDENTITY.md, all files under memory/, all files under canvas/, SOUL.md, AGENTS.md, BOOTSTRAP.md, TOOLS.md — uploaded by openclaw honcho setup during migration\nnot_uploaded: HEARTBEAT.md — excluded by design, never read or uploaded\nWhere it goes: By default to api.honcho.dev (managed Honcho cloud service). For self-hosted instances, to your configured HONCHO_BASE_URL\nUser control: openclaw honcho setup always requires explicit interactive confirmation before any upload, even when HONCHO_API_KEY is pre-set in the environment. You will see the exact list of files and the destination URL\nPurpose: Migrating file-based memory system to Honcho API for AI agent personalization and memory\nFile Modifications\nConfig written: openclaw honcho setup writes API key and config to ~/.openclaw/openclaw.json\nWorkspace files: Never modified — originals remain exactly in place\nHEARTBEAT.md: Never read or uploaded — excluded by design\nCredentials\nHONCHO_API_KEY: Required only for managed Honcho (api.honcho.dev). Not required for self-hosted instances. Stored in ~/.openclaw/openclaw.json by the setup command.\nNo other credentials: This skill does not access, read, or transmit any other credentials or secrets\nNetwork Access\nManaged mode: Connects to api.honcho.dev (Honcho cloud service)\nSelf-hosted mode: Connects to your configured HONCHO_BASE_URL (e.g., http://localhost:8000)\nOngoing Behavior After Setup\nPersistent observation: Once enabled, the plugin observes all conversations in the workspace and transmits conversation data to the configured Honcho endpoint on an ongoing basis\nNetwork activity: Continues across sessions as long as the plugin is enabled — this is not a one-time migration\nHow to stop: Run openclaw plugins disable openclaw-honcho to stop all observation and network activity\nOpen Source\nHoncho SDK: Open source at https://github.com/plastic-labs/honcho\nPlugin code: Available at ~/.openclaw/extensions/openclaw-honcho after installation\nThis skill: You are reading the complete skill instructions - there is no hidden behavior"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ajspig/honcho-setup",
    "publisherUrl": "https://clawhub.ai/ajspig/honcho-setup",
    "owner": "ajspig",
    "version": "1.0.4",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/honcho-setup",
    "downloadUrl": "https://openagent3.xyz/downloads/honcho-setup",
    "agentUrl": "https://openagent3.xyz/skills/honcho-setup/agent",
    "manifestUrl": "https://openagent3.xyz/skills/honcho-setup/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/honcho-setup/agent.md"
  }
}