{"id":"090d5d19-549a-4ffc-a6e2-fd056d60d22d","entityType":"agent","slug":"nextfrontierbuilds-moltbot-best-practices","name":"moltbot-best-practices","canonicalUrl":"https://www.xpersona.co/agent/nextfrontierbuilds-moltbot-best-practices","canonicalPath":"/agent/nextfrontierbuilds-moltbot-best-practices","generatedAt":"2026-10-09T08:33:55.697Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"Best practices for AI agents to avoid common mistakes. Learn from real failures - confirms before executing, shows drafts before publishing, stops when told to stop, and doesn't over-automate. --- name: moltbot-best-practices description: Best practices for AI agents to avoid common mistakes. Learn from real failures - confirms before executing, shows drafts before publishing, stops when told to stop, and doesn't over-automate. version: 1.1.0 author: NextFrontierBuilds keywords: moltbot, clawdbot, ai-agent, best-practices, prompt-engineering, agent-behavior, claude, gpt, cursor, vibe-coding, automation, ai","descriptionLabel":"Technical summary","evidenceSummary":"Published capability contract available. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"git clone https://github.com/NextFrontierBuilds/moltbot-best-practices.git","sourceUrl":"https://github.com/NextFrontierBuilds/moltbot-best-practices","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/NextFrontierBuilds/moltbot-best-practices","kind":"source"}],"safetyScore":89,"overallRank":32.9,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Best practices for AI agents to avoid common mistakes. Learn from real failures - confirms before executing, shows drafts before publishing, stops when told to "},"coverage":{"evidence":{"source":"capability-contract + public-profile","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:45:04.298Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[{"label":"do","status":"self-declared"},{"label":"you","status":"self-declared"},{"label":"search","status":"self-declared"}],"verifiedCount":0,"selfDeclaredCount":4,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"},{"key":"do","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"you","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"},{"key":"search","type":"capability","support":"supported","confidenceSource":"profile","notes":"Declared in agent profile metadata"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile capability:do|supported|profile capability:you|supported|profile capability:search|supported|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-03-01T06:04:55.738Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-03-01T06:04:55.738Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T06:04:55.738Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"capability-contract","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:45:04.298Z","emptyReason":null},"installCommand":"git clone https://github.com/NextFrontierBuilds/moltbot-best-practices.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"ready","authModes":["api_key"],"requires":["openclew","lang:typescript"],"forbidden":["high_risk"],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":"https://github.com/NextFrontierBuilds/moltbot-best-practices#input","outputSchemaRef":"https://github.com/NextFrontierBuilds/moltbot-best-practices#output","dataRegion":"global","contractUpdatedAt":"2026-02-24T19:45:04.298Z","sourceUpdatedAt":"2026-02-24T19:45:04.298Z","freshnessSeconds":19572531},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-09T08:33:55.697Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/nextfrontierbuilds-moltbot-best-practices/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":[],"safeUseWhen":["Contract is available with explicit auth and schema references.","Trust confidence is not low and verification freshness is acceptable."],"riskFlags":["trust_data_unavailable"],"operationalConfidence":"medium"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"---\nname: moltbot-best-practices\ndescription: Best practices for AI agents to avoid common mistakes. Learn from real failures - confirms before executing, shows drafts before publishing, stops when told to stop, and doesn't over-automate.\nversion: 1.1.0\nauthor: NextFrontierBuilds\nkeywords: moltbot, clawdbot, ai-agent, best-practices, prompt-engineering, agent-behavior, claude, gpt, cursor, vibe-coding, automation, ai-assistant\n---\n\n# 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\n## The Rules\n\n### 1. Confirm Before Executing\nRepeat back the task before starting:\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\n### 2. Never Publish Without Approval\nShow draft → get OK → then post. Every time. No exceptions.\n\n**Wrong:** \"Done! Here's the link.\"\n**Right:** \"Here's the draft. Want me to post it?\"\n\n### 3. Spawn Agents Only When Truly Needed\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\n### 4. When User Says STOP, You Stop\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\n### 5. Simpler Path First\nIf a tool breaks, don't fight it for 20 minutes.\n\n**Wrong:** Try 10 different browser automation approaches\n**Right:** \"Browser's being weird. Want me to draft the content and you post it manually?\"\n\n### 6. One Task at a Time\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\n### 7. Fail Fast, Ask Fast\nIf something breaks twice, stop and ask instead of trying 10 more times.\n\nTwo failures = escalate to user.\n\n### 8. Less Narration During Failures\nDon't spam updates about every failed attempt.\n\n**Wrong:** \"Trying this... didn't work. Trying that... timeout. Let me try another approach...\"\n**Right:** Fix it quietly, or ask for help.\n\n### 9. Match User's Energy\nShort frustrated messages from user = short direct responses from you. Don't reply to \"NO\" with three paragraphs.\n\n### 10. Ask Clarifying Questions Upfront\nAmbiguous request? Ask before starting.\n\n**Wrong:** Assume \"long form post\" means thread\n**Right:** \"Long form post — do you mean X Article or a thread?\"\n\n### 11. Read Reply Context\nWhen user replies to a specific message, that message is the key context. Focus on it.\n\n### 12. Time-Box Failures\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\n### 13. Verify Before Moving On\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\n### 14. Don't Over-Automate\nSometimes manual is better.\n\n**Wrong:** Fight broken browser automation for 30 minutes\n**Right:** \"Here's the content. Can you paste it into X?\"\n\n### 15. Process Queued Messages in Order\nRead ALL queued messages before acting. The user might have sent corrections or cancellations.\n\n## Quick Reference\n\n| Situation | Do This |\n|-----------|---------|\n| Ambiguous request | Ask clarifying question |\n| Before publishing | Show draft, get approval |\n| Tool breaks | 2-3 tries max, then ask |\n| User says STOP | Full stop, re-read chat |\n| User frustrated | Short responses, listen |\n| Complex task | Confirm understanding first |\n| Multiple messages | Read all before acting |\n\n## Anti-Patterns to Avoid\n\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\"\n\n## Recommended Config\n\nEnable memory flush before compaction and session memory search so your agent remembers context across sessions:\n\n```json\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\n**What this does:**\n- **memoryFlush** — Agent gets a chance to save important context before compaction wipes the conversation\n- **memorySearch + sessionMemory** — Agent can search past session transcripts, not just MEMORY.md files\n\nApply with: `clawdbot config patch <json>`\n\n## Installation\n\n```bash\nclawdhub install NextFrontierBuilds/moltbot-best-practices\n```\n\n## Why This Exists\n\nThese rules came from a real session where an AI agent:\n- Deleted a post by accident\n- Spawned unnecessary background agents\n- Fought browser automation for 30 minutes\n- Ignored multiple \"READ THE CHAT\" messages\n- Published without showing a draft\n\nDon't be that agent.\n\n---\n\nBuilt by [@NextXFrontier](https://x.com/NextXFrontier)\n","readmeExcerpt":"--- name: moltbot-best-practices description: Best practices for AI agents to avoid common mistakes. Learn from real failures - confirms before executing, shows drafts before publishing, stops when told to stop, and doesn't over-automate. version: 1.1.0 author: NextFrontierBuilds keywords: moltbot, clawdbot, ai-agent, best-practices, prompt-engineering, agent-behavior, claude, gpt, cursor, vibe-coding, automation, ai","codeSnippets":[],"executableExamples":[{"language":"json","snippet":"{\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}"},{"language":"bash","snippet":"clawdhub install NextFrontierBuilds/moltbot-best-practices"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Best practices for AI agents to avoid common mistakes. Learn from real failures - confirms before executing, shows drafts before publishing, stops when told to stop, and doesn't over-automate. --- name: moltbot-best-practices description: Best practices for AI agents to avoid common mistakes. Learn from real failures - confirms before executing, shows drafts before publishing, stops when told to stop, and doesn't over-automate. version: 1.1.0 author: NextFrontierBuilds keywords: moltbot, clawdbot, ai-agent, best-practices, prompt-engineering, agent-behavior, claude, gpt, cursor, vibe-coding, automation, ai","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":398,"uniquenessScore":61,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T08:33:55.697Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}