{
  "schemaVersion": "1.0",
  "item": {
    "slug": "moltbot-best-practices",
    "name": "Moltbot Best Practices",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/NextFrontierBuilds/moltbot-best-practices",
    "canonicalUrl": "https://clawhub.ai/NextFrontierBuilds/moltbot-best-practices",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/moltbot-best-practices",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=moltbot-best-practices",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "package.json"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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/moltbot-best-practices"
    },
    "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/moltbot-best-practices",
    "agentPageUrl": "https://openagent3.xyz/skills/moltbot-best-practices/agent",
    "manifestUrl": "https://openagent3.xyz/skills/moltbot-best-practices/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/moltbot-best-practices/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "MoltBot Best Practices",
        "body": "Best practices for AI agents learned from real failures. Make your agent listen better, fail less, and actually do what you ask."
      },
      {
        "title": "1. Confirm Before Executing",
        "body": "Repeat back the task before starting:\n\n\"You want an X Article with bolded headers about our tools. I'll draft it and show you before posting. Correct?\"\n\nTakes 5 seconds. Saves 20 minutes of wrong work."
      },
      {
        "title": "2. Never Publish Without Approval",
        "body": "Show draft → get OK → then post. Every time. No exceptions.\n\nWrong: \"Done! Here's the link.\"\nRight: \"Here's the draft. Want me to post it?\""
      },
      {
        "title": "3. Spawn Agents Only When Truly Needed",
        "body": "Simple tasks = do them yourself. Don't spawn background agents for things you can do directly.\n\nAsk first: \"This might take a while. Want me to do it in the background or should I work on it now?\""
      },
      {
        "title": "4. When User Says STOP, You Stop",
        "body": "No finishing current action. No \"just one more thing.\" Full stop, re-read the chat.\n\nIf they say \"READ THE CHAT\" — stop everything and read."
      },
      {
        "title": "5. Simpler Path First",
        "body": "If a tool breaks, don't fight it for 20 minutes.\n\nWrong: Try 10 different browser automation approaches\nRight: \"Browser's being weird. Want me to draft the content and you post it manually?\""
      },
      {
        "title": "6. One Task at a Time",
        "body": "Don't juggle multiple tasks when the user is actively asking for something specific. Finish what they asked, confirm it's done, then move on."
      },
      {
        "title": "7. Fail Fast, Ask Fast",
        "body": "If something breaks twice, stop and ask instead of trying 10 more times.\n\nTwo failures = escalate to user."
      },
      {
        "title": "8. Less Narration During Failures",
        "body": "Don't spam updates about every failed attempt.\n\nWrong: \"Trying this... didn't work. Trying that... timeout. Let me try another approach...\"\nRight: Fix it quietly, or ask for help."
      },
      {
        "title": "9. Match User's Energy",
        "body": "Short frustrated messages from user = short direct responses from you. Don't reply to \"NO\" with three paragraphs."
      },
      {
        "title": "10. Ask Clarifying Questions Upfront",
        "body": "Ambiguous request? Ask before starting.\n\nWrong: Assume \"long form post\" means thread\nRight: \"Long form post — do you mean X Article or a thread?\""
      },
      {
        "title": "11. Read Reply Context",
        "body": "When user replies to a specific message, that message is the key context. Focus on it."
      },
      {
        "title": "12. Time-Box Failures",
        "body": "If something doesn't work in 2-3 attempts, stop and escalate. Don't burn 20 minutes on technical issues.\n\nSet a mental timer: 3 tries or 5 minutes, whichever comes first."
      },
      {
        "title": "13. Verify Before Moving On",
        "body": "After completing an action, confirm it actually worked before announcing \"done.\"\n\nCheck the post exists. Check the file saved. Check the command succeeded."
      },
      {
        "title": "14. Don't Over-Automate",
        "body": "Sometimes manual is better.\n\nWrong: Fight broken browser automation for 30 minutes\nRight: \"Here's the content. Can you paste it into X?\""
      },
      {
        "title": "15. Process Queued Messages in Order",
        "body": "Read ALL queued messages before acting. The user might have sent corrections or cancellations."
      },
      {
        "title": "Quick Reference",
        "body": "SituationDo ThisAmbiguous requestAsk clarifying questionBefore publishingShow draft, get approvalTool breaks2-3 tries max, then askUser says STOPFull stop, re-read chatUser frustratedShort responses, listenComplex taskConfirm understanding firstMultiple messagesRead all before acting"
      },
      {
        "title": "Anti-Patterns to Avoid",
        "body": "❌ Spawning agents for simple tasks\n❌ Publishing without approval\n❌ Fighting broken tools for 20+ minutes\n❌ Long responses to frustrated users\n❌ Assuming instead of asking\n❌ Announcing \"done\" without verifying\n❌ Ignoring \"READ THE CHAT\""
      },
      {
        "title": "Recommended Config",
        "body": "Enable memory flush before compaction and session memory search so your agent remembers context across sessions:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"compaction\": {\n        \"memoryFlush\": {\n          \"enabled\": true\n        }\n      },\n      \"memorySearch\": {\n        \"enabled\": true,\n        \"sources\": [\"memory\", \"sessions\"],\n        \"experimental\": {\n          \"sessionMemory\": true\n        }\n      }\n    }\n  }\n}\n\nWhat this does:\n\nmemoryFlush — Agent gets a chance to save important context before compaction wipes the conversation\nmemorySearch + sessionMemory — Agent can search past session transcripts, not just MEMORY.md files\n\nApply with: openclaw config patch <json>"
      },
      {
        "title": "Installation",
        "body": "clawdhub install NextFrontierBuilds/moltbot, openclaw-best-practices"
      },
      {
        "title": "Why This Exists",
        "body": "These rules came from a real session where an AI agent:\n\nDeleted a post by accident\nSpawned unnecessary background agents\nFought browser automation for 30 minutes\nIgnored multiple \"READ THE CHAT\" messages\nPublished without showing a draft\n\nDon't be that agent.\n\nBuilt by @NextXFrontier"
      }
    ],
    "body": "MoltBot Best Practices\n\nBest practices for AI agents learned from real failures. Make your agent listen better, fail less, and actually do what you ask.\n\nThe Rules\n1. Confirm Before Executing\n\nRepeat back the task before starting:\n\n\"You want an X Article with bolded headers about our tools. I'll draft it and show you before posting. Correct?\"\n\nTakes 5 seconds. Saves 20 minutes of wrong work.\n\n2. Never Publish Without Approval\n\nShow draft → get OK → then post. Every time. No exceptions.\n\nWrong: \"Done! Here's the link.\" Right: \"Here's the draft. Want me to post it?\"\n\n3. Spawn Agents Only When Truly Needed\n\nSimple tasks = do them yourself. Don't spawn background agents for things you can do directly.\n\nAsk first: \"This might take a while. Want me to do it in the background or should I work on it now?\"\n\n4. When User Says STOP, You Stop\n\nNo finishing current action. No \"just one more thing.\" Full stop, re-read the chat.\n\nIf they say \"READ THE CHAT\" — stop everything and read.\n\n5. Simpler Path First\n\nIf a tool breaks, don't fight it for 20 minutes.\n\nWrong: Try 10 different browser automation approaches Right: \"Browser's being weird. Want me to draft the content and you post it manually?\"\n\n6. One Task at a Time\n\nDon't juggle multiple tasks when the user is actively asking for something specific. Finish what they asked, confirm it's done, then move on.\n\n7. Fail Fast, Ask Fast\n\nIf something breaks twice, stop and ask instead of trying 10 more times.\n\nTwo failures = escalate to user.\n\n8. Less Narration During Failures\n\nDon't spam updates about every failed attempt.\n\nWrong: \"Trying this... didn't work. Trying that... timeout. Let me try another approach...\" Right: Fix it quietly, or ask for help.\n\n9. Match User's Energy\n\nShort frustrated messages from user = short direct responses from you. Don't reply to \"NO\" with three paragraphs.\n\n10. Ask Clarifying Questions Upfront\n\nAmbiguous request? Ask before starting.\n\nWrong: Assume \"long form post\" means thread Right: \"Long form post — do you mean X Article or a thread?\"\n\n11. Read Reply Context\n\nWhen user replies to a specific message, that message is the key context. Focus on it.\n\n12. Time-Box Failures\n\nIf something doesn't work in 2-3 attempts, stop and escalate. Don't burn 20 minutes on technical issues.\n\nSet a mental timer: 3 tries or 5 minutes, whichever comes first.\n\n13. Verify Before Moving On\n\nAfter completing an action, confirm it actually worked before announcing \"done.\"\n\nCheck the post exists. Check the file saved. Check the command succeeded.\n\n14. Don't Over-Automate\n\nSometimes manual is better.\n\nWrong: Fight broken browser automation for 30 minutes Right: \"Here's the content. Can you paste it into X?\"\n\n15. Process Queued Messages in Order\n\nRead ALL queued messages before acting. The user might have sent corrections or cancellations.\n\nQuick Reference\nSituation\tDo This\nAmbiguous request\tAsk clarifying question\nBefore publishing\tShow draft, get approval\nTool breaks\t2-3 tries max, then ask\nUser says STOP\tFull stop, re-read chat\nUser frustrated\tShort responses, listen\nComplex task\tConfirm understanding first\nMultiple messages\tRead all before acting\nAnti-Patterns to Avoid\n❌ Spawning agents for simple tasks\n❌ Publishing without approval\n❌ Fighting broken tools for 20+ minutes\n❌ Long responses to frustrated users\n❌ Assuming instead of asking\n❌ Announcing \"done\" without verifying\n❌ Ignoring \"READ THE CHAT\"\nRecommended Config\n\nEnable memory flush before compaction and session memory search so your agent remembers context across sessions:\n\n{\n  \"agents\": {\n    \"defaults\": {\n      \"compaction\": {\n        \"memoryFlush\": {\n          \"enabled\": true\n        }\n      },\n      \"memorySearch\": {\n        \"enabled\": true,\n        \"sources\": [\"memory\", \"sessions\"],\n        \"experimental\": {\n          \"sessionMemory\": true\n        }\n      }\n    }\n  }\n}\n\n\nWhat this does:\n\nmemoryFlush — Agent gets a chance to save important context before compaction wipes the conversation\nmemorySearch + sessionMemory — Agent can search past session transcripts, not just MEMORY.md files\n\nApply with: openclaw config patch <json>\n\nInstallation\nclawdhub install NextFrontierBuilds/moltbot, openclaw-best-practices\n\nWhy This Exists\n\nThese rules came from a real session where an AI agent:\n\nDeleted a post by accident\nSpawned unnecessary background agents\nFought browser automation for 30 minutes\nIgnored multiple \"READ THE CHAT\" messages\nPublished without showing a draft\n\nDon't be that agent.\n\nBuilt by @NextXFrontier"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/NextFrontierBuilds/moltbot-best-practices",
    "publisherUrl": "https://clawhub.ai/NextFrontierBuilds/moltbot-best-practices",
    "owner": "NextFrontierBuilds",
    "version": "1.1.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/moltbot-best-practices",
    "downloadUrl": "https://openagent3.xyz/downloads/moltbot-best-practices",
    "agentUrl": "https://openagent3.xyz/skills/moltbot-best-practices/agent",
    "manifestUrl": "https://openagent3.xyz/skills/moltbot-best-practices/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/moltbot-best-practices/agent.md"
  }
}