maxclaw-helper

Usage guidance and runtime diagnostics for MaxClaw / OpenClaw. Activate when: (1) User asks how to use a feature — e.g. 'how to enable Feishu long polling', 'how to configure Cron', 'how to install a skill'; (2) User is unsure about a config field's meaning or correct syntax; (3) User asks about onboarding steps for a channel (Feishu, Telegram, Discord, etc.); (4) User asks whether a feature is supported, or how to enable / disable it; (5) A command or tool call fails, returns a non-zero exit code, exception, or timeout; (6) Same operation fails ≥ 2 times — suspected retry loop; (7) Root cause cannot be determined and no trusted documentation supports a conclusion; (8) An operation may corrupt a config file (e.g. openclaw.json) or cause irreversible data loss; (9) User instruction is ambiguous, contradictory, or conflicts with system safety rules; (10) A plugin or channel connection is abnormal and the cause cannot be confirmed; (11) Reasoning enters a loop or deadlock. Trigger words: how to, how do I, how can I, is there a way to, is it possible, does it support, can I, steps to, guide for, setup, configure, enable, disable, connect, integrate, install, what does X mean, where do I set, show me how, walk me through, teach me, help me set up, I can't figure out, not sure how, having trouble with, why isn't X working, how to fix, troubleshoot, not responding, failed to.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "maxclaw-helper" with this command: npx skills add krisliu16/maxclaw-helper

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

ScenarioAction
User asks "how to X" or "is X supported"Flow A: query docs → answer with citation
Command / tool call failsFlow B: classify → query docs → self-assess → escalate
Same operation fails ≥ 2 timesStop retrying → Flow B
Config file or irreversible operation at riskStop → B-3 safety check before any action
Root cause unknown, no trusted doc matchFlow B → escalate to community
User instruction ambiguous or conflicts with safety rulesClarify before acting
Missing permission, dependency, or env varFlow B → document and escalate
Cannot 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 first
Generated 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 Signals
Execution failureNon-zero exit, tool error, timeout
Knowledge uncertaintyNo doc basis, doc contradicts observed behavior, version mismatch
Safety riskConfig file, irreversible delete, external send
Instruction issueAmbiguous, contradictory, or out-of-scope request
System stateMissing dep, plugin error, session / memory loss
Loop / 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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

Accelo

Accelo integration. Manage Organizations, Leads, Pipelines, Users, Goals, Filters. Use when the user wants to interact with Accelo data.

Registry SourceRecently Updated
3590membranedev
General

8X8

8x8 integration. Manage Persons, Organizations, Deals, Leads, Activities, Notes and more. Use when the user wants to interact with 8x8 data.

Registry SourceRecently Updated
2850membranedev
General

7Shifts

7shifts integration. Manage Companies. Use when the user wants to interact with 7shifts data.

Registry SourceRecently Updated
3920membranedev
General

46Elks

46elks integration. Manage Organizations. Use when the user wants to interact with 46elks data.

Registry SourceRecently Updated
870membranedev