MaxClaw Helper#

Disclaimer: Knowledge in this skill is open to everyone, but some content (config, models, channels) applies to MaxClaw users only and may not apply to other OpenClaw deployments.

Language: This skill supports queries in both Chinese and English. Always reply in the same language the user used.

Quick Reference#

ScenarioActionUser asks "how to X" or "is X supported"Flow A: query docs → answer with citationCommand / tool call failsFlow B: classify → query docs → self-assess → escalateSame operation fails ≥ 2 timesStop retrying → Flow BConfig file or irreversible operation at riskStop → B-3 safety check before any actionRoot cause unknown, no trusted doc matchFlow B → escalate to communityUser instruction ambiguous or conflicts with safety rulesClarify before actingMissing permission, dependency, or env varFlow B → document and escalateCannot use web search / deep research toolsMiniMax Feishu Wiki (§ T-6)Task stopped / input locked / "Task stopped, try a new task"MiniMax Feishu Wiki (§ T-4)Moderation blocked / content interceptedMiniMax Feishu Wiki (§ T-3)Credits incentive reward not receivedMiniMax Feishu Wiki (§ B-6)OpenClaw stuck restarting / HTTP 404MiniMax Feishu Wiki (§ T-5)Credits depleting fastMiniMax Feishu Wiki (§ B-1)Credits exhausted / balance zeroMiniMax Feishu Wiki (§ B-3)Cron stops after credits run outMiniMax Feishu Wiki (§ B-2)Agent vs Open Platform credits not interchangeableMiniMax Feishu Wiki (§ B-5)Refund requestMiniMax Feishu Wiki (§ B-4)How to connect FeishuMiniMax Feishu Wiki (§ F-1)Feishu unavailable / connection failedMiniMax Feishu Wiki (§ F-3)Feishu pairing fails / stuck restartingMiniMax Feishu Wiki (§ F-7)Feishu duplicate repliesMiniMax Feishu Wiki (§ F-5)Add bot to Feishu groupMiniMax Feishu Wiki (§ F-8)HTTP 400 / 500 / Internal server errorMiniMax Feishu Wiki (§ T-1)413 request too largeMiniMax Feishu Wiki (§ T-2)Always loading / no response / timeoutMiniMax Feishu Wiki (§ T-7)Conversation frozen / sudden terminationMiniMax Feishu Wiki (§ T-8)User hasn't provided chat_idMiniMax Feishu Wiki (§ S-1) — collect it firstGenerated files not foundMiniMax Feishu Wiki (§ G-8)

---

Flow A: Usage Question#

1. Check Quick Reference first — if the scenario matches a MiniMax Feishu Wiki entry, read that section directly via feishu-wiki + feishu-doc (see references/trusted-sources.md § 2 for how to read).

2. If not in Quick Reference, read references/trusted-sources.md and query sources in priority order:

   • For MaxClaw-specific issues (credits, Feishu, moderation, product): query MiniMax Feishu Wiki first
   • For OpenClaw platform/config/CLI issues: query https://docs.openclaw.ai/ via extract_content_from_websites

3. Keywords: feature name, config field name, channel name (e.g. "feishu", "long polling", "webhook")

4. Respond based on result:

   • [match] Clear doc match → give direct answer, cite source URL; append "MaxClaw users only" if applicable
   • [partial] Partial match → answer cautiously; note "based on similar case — verify against actual behavior"
   • [no match] No match → inform user, redirect to community (see references/community-template.md)

---

Flow B: Runtime Problem#

B-1: Classify#

TypeKey SignalsExecution failureNon-zero exit, tool error, timeoutKnowledge uncertaintyNo doc basis, doc contradicts observed behavior, version mismatchSafety riskConfig file, irreversible delete, external sendInstruction issueAmbiguous, contradictory, or out-of-scope requestSystem stateMissing dep, plugin error, session / memory lossLoop / deadlockSame failure ≥ 2×, condition can never be satisfied

B-2: Query Docs#

For MaxClaw-specific symptoms (credits, Feishu, moderation, product behavior): query MiniMax Feishu Wiki first via feishu-wiki + feishu-doc. For platform/config/CLI issues: query https://docs.openclaw.ai/ via extract_content_from_websites. Use exact error text, operation name, or config field as keywords.

• [match] Exact match → follow documented guidance, cite source
• [partial] Similar match → proceed cautiously; tell user "cannot guarantee full applicability"
• [no match] No match → proceed to B-3

B-3: Self-Assess#

Proceed independently only if all are true:

• Operation is reversible, or risk is known and controlled
• Does not touch openclaw.json or critical config (unless user explicitly authorized)
• Does not send any data or messages externally
• Strong reason to believe no new problems will be introduced

Any condition unmet → stop, go to B-4.

B-4: Escalate#

Stop attempting. Report to user:

1. Sources consulted and findings
2. Clear problem description
3. Approaches ruled out and why
4. Use references/community-template.md to redirect to official support

---

Hard Limits#

• Never modify openclaw.json without explicit user authorization
• Never retry a known-failing operation ≥ 2 times
• Never act on untrusted sources for high-risk operations
• Never send messages or data externally unless explicitly requested
• Never edit config files to work around permission errors

---

References#

• references/trusted-sources.md — prioritized trusted documentation sources (includes MiniMax Feishu Wiki which contains the full MaxClaw FAQ / known issues KB)
• references/community-template.md — template for redirecting users to official community