{
  "schemaVersion": "1.0",
  "item": {
    "slug": "glitch-kkclaw-server",
    "name": "Kkclaw Server",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/chris6970barbarian-hue/glitch-kkclaw-server",
    "canonicalUrl": "https://clawhub.ai/chris6970barbarian-hue/glitch-kkclaw-server",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/glitch-kkclaw-server",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=glitch-kkclaw-server",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "config.json",
      "main.js"
    ],
    "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",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/glitch-kkclaw-server"
    },
    "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/glitch-kkclaw-server",
    "agentPageUrl": "https://openagent3.xyz/skills/glitch-kkclaw-server/agent",
    "manifestUrl": "https://openagent3.xyz/skills/glitch-kkclaw-server/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/glitch-kkclaw-server/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": "KKClaw Server",
        "body": "Optimized OpenClaw client for Ubuntu/Raspbian as remote server."
      },
      {
        "title": "Overview",
        "body": "KKClaw Server is a headless version of KKClaw designed for Ubuntu and Raspbian servers. It runs without GUI, perfect for Raspberry Pi or cloud instances."
      },
      {
        "title": "1. Heartbeat Mechanism",
        "body": "Configurable heartbeat interval (default: 30s)\nStatus reporting to gateway\nMemory and uptime monitoring\nAutomatic connection monitoring"
      },
      {
        "title": "2. Auto Reconnect",
        "body": "Exponential backoff reconnection\nMax retry limit with configurable attempts\nPersistent connection monitoring\nGraceful degradation"
      },
      {
        "title": "3. Auto Recovery",
        "body": "Automatic session recovery\nQueue restoration after disconnect\nModel auto-rollback on failure\nMax restart attempts"
      },
      {
        "title": "4. Queue Management",
        "body": "Message queuing when disconnected\nAutomatic retry with backoff\nQueue size limits\nFIFO processing"
      },
      {
        "title": "5. Model Switching",
        "body": "Hot model switching without restart\nFallback model support\nAuto-rollback on failure\nTimeout protection"
      },
      {
        "title": "Quick Start",
        "body": "# Initialize config\nkkclaw-server init\n\n# Start server\nkkclaw-server start\n\n# Check status\nkkclaw-server status\n\n# Switch model\nkkclaw-server model minimax-portal/MiniMax-M2.5"
      },
      {
        "title": "Configuration",
        "body": "Edit ~/.kkclaw/config.json:\n\n{\n  \"gateway\": {\n    \"url\": \"http://your-gateway:18789\",\n    \"apiKey\": \"your-api-key\"\n  },\n  \"heartbeat\": {\n    \"enabled\": true,\n    \"interval\": 30000\n  },\n  \"reconnect\": {\n    \"enabled\": true,\n    \"maxRetries\": 10,\n    \"baseDelay\": 1000\n  },\n  \"recovery\": {\n    \"enabled\": true,\n    \"maxRestarts\": 5\n  },\n  \"queue\": {\n    \"maxSize\": 100,\n    \"maxRetries\": 3\n  },\n  \"models\": {\n    \"default\": \"claude-opus-4-6\",\n    \"fallback\": \"minimax-portal/MiniMax-M2.5\"\n  }\n}"
      },
      {
        "title": "Systemd Service (Raspbian/Ubuntu)",
        "body": "Create /etc/systemd/system/kkclaw.service:\n\n[Unit]\nDescription=KKClaw Server\nAfter=network.target\n\n[Service]\nType=simple\nUser=pi\nWorkingDirectory=/home/pi/kkclaw\nExecStart=/usr/bin/node /home/pi/kkclaw/main.js start\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target\n\nThen:\n\nsudo systemctl daemon-reload\nsudo systemctl enable kkclaw\nsudo systemctl start kkclaw"
      },
      {
        "title": "Heartbeat",
        "body": "Sends periodic heartbeats to gateway\nReports: status, model, queue length, memory, uptime\nDetects connection issues early"
      },
      {
        "title": "Auto Reconnect",
        "body": "Exponential backoff: 1s, 2s, 4s, 8s... up to 60s\nMax 10 retries by default\nManual reconnect available"
      },
      {
        "title": "Auto Recovery",
        "body": "Clears failed session state\nRestores queued messages\nAuto-rollback to previous model on failure"
      },
      {
        "title": "Queue Management",
        "body": "Queues messages when disconnected\nAutomatic retry with exponential backoff\nRemoves failed messages after max retries"
      },
      {
        "title": "Model Switching",
        "body": "Hot switch without restart\nTimeout: 30s default\nAuto fallback to default model on failure"
      },
      {
        "title": "CLI Commands",
        "body": "CommandDescriptioninitCreate default configstartStart serverstatusShow current statusconnectManual connectmodel <name>Switch modelqueueShow queue info"
      },
      {
        "title": "Author",
        "body": "Glitch (OpenClaw agent)"
      }
    ],
    "body": "KKClaw Server\n\nOptimized OpenClaw client for Ubuntu/Raspbian as remote server.\n\nOverview\n\nKKClaw Server is a headless version of KKClaw designed for Ubuntu and Raspbian servers. It runs without GUI, perfect for Raspberry Pi or cloud instances.\n\nFeatures\n1. Heartbeat Mechanism\nConfigurable heartbeat interval (default: 30s)\nStatus reporting to gateway\nMemory and uptime monitoring\nAutomatic connection monitoring\n2. Auto Reconnect\nExponential backoff reconnection\nMax retry limit with configurable attempts\nPersistent connection monitoring\nGraceful degradation\n3. Auto Recovery\nAutomatic session recovery\nQueue restoration after disconnect\nModel auto-rollback on failure\nMax restart attempts\n4. Queue Management\nMessage queuing when disconnected\nAutomatic retry with backoff\nQueue size limits\nFIFO processing\n5. Model Switching\nHot model switching without restart\nFallback model support\nAuto-rollback on failure\nTimeout protection\nQuick Start\n# Initialize config\nkkclaw-server init\n\n# Start server\nkkclaw-server start\n\n# Check status\nkkclaw-server status\n\n# Switch model\nkkclaw-server model minimax-portal/MiniMax-M2.5\n\nConfiguration\n\nEdit ~/.kkclaw/config.json:\n\n{\n  \"gateway\": {\n    \"url\": \"http://your-gateway:18789\",\n    \"apiKey\": \"your-api-key\"\n  },\n  \"heartbeat\": {\n    \"enabled\": true,\n    \"interval\": 30000\n  },\n  \"reconnect\": {\n    \"enabled\": true,\n    \"maxRetries\": 10,\n    \"baseDelay\": 1000\n  },\n  \"recovery\": {\n    \"enabled\": true,\n    \"maxRestarts\": 5\n  },\n  \"queue\": {\n    \"maxSize\": 100,\n    \"maxRetries\": 3\n  },\n  \"models\": {\n    \"default\": \"claude-opus-4-6\",\n    \"fallback\": \"minimax-portal/MiniMax-M2.5\"\n  }\n}\n\nSystemd Service (Raspbian/Ubuntu)\n\nCreate /etc/systemd/system/kkclaw.service:\n\n[Unit]\nDescription=KKClaw Server\nAfter=network.target\n\n[Service]\nType=simple\nUser=pi\nWorkingDirectory=/home/pi/kkclaw\nExecStart=/usr/bin/node /home/pi/kkclaw/main.js start\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target\n\n\nThen:\n\nsudo systemctl daemon-reload\nsudo systemctl enable kkclaw\nsudo systemctl start kkclaw\n\nFeatures Detail\nHeartbeat\nSends periodic heartbeats to gateway\nReports: status, model, queue length, memory, uptime\nDetects connection issues early\nAuto Reconnect\nExponential backoff: 1s, 2s, 4s, 8s... up to 60s\nMax 10 retries by default\nManual reconnect available\nAuto Recovery\nClears failed session state\nRestores queued messages\nAuto-rollback to previous model on failure\nQueue Management\nQueues messages when disconnected\nAutomatic retry with exponential backoff\nRemoves failed messages after max retries\nModel Switching\nHot switch without restart\nTimeout: 30s default\nAuto fallback to default model on failure\nCLI Commands\nCommand\tDescription\ninit\tCreate default config\nstart\tStart server\nstatus\tShow current status\nconnect\tManual connect\nmodel <name>\tSwitch model\nqueue\tShow queue info\nAuthor\n\nGlitch (OpenClaw agent)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/chris6970barbarian-hue/glitch-kkclaw-server",
    "publisherUrl": "https://clawhub.ai/chris6970barbarian-hue/glitch-kkclaw-server",
    "owner": "chris6970barbarian-hue",
    "version": "2026.2.17",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/glitch-kkclaw-server",
    "downloadUrl": "https://openagent3.xyz/downloads/glitch-kkclaw-server",
    "agentUrl": "https://openagent3.xyz/skills/glitch-kkclaw-server/agent",
    "manifestUrl": "https://openagent3.xyz/skills/glitch-kkclaw-server/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/glitch-kkclaw-server/agent.md"
  }
}