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',...
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.
| Scenario | Action |
|---|---|
| User asks "how to X" or "is X supported" | Flow A: query docs → answer with citation |
| Command / tool call fails | Flow B: classify → query docs → self-assess → escalate |
| Same operation fails ≥ 2 times | Stop retrying → Flow B |
| Config file or irreversible operation at risk | Stop → B-3 safety check before any action |
| Root cause unknown, no trusted doc match | Flow B → escalate to community |
| User instruction ambiguous or conflicts with safety rules | Clarify before acting |
| Missing permission, dependency, or env var | Flow B → document and escalate |
| Cannot use web search / deep research tools | MiniMax Feishu Wiki (§ T-6) |
| Task stopped / input locked / "Task stopped, try a new task" | MiniMax Feishu Wiki (§ T-4) |
| Moderation blocked / content intercepted | MiniMax Feishu Wiki (§ T-3) |
| Credits incentive reward not received | MiniMax Feishu Wiki (§ B-6) |
| OpenClaw stuck restarting / HTTP 404 | MiniMax Feishu Wiki (§ T-5) |
| Credits depleting fast | MiniMax Feishu Wiki (§ B-1) |
| Credits exhausted / balance zero | MiniMax Feishu Wiki (§ B-3) |
| Cron stops after credits run out | MiniMax Feishu Wiki (§ B-2) |
| Agent vs Open Platform credits not interchangeable | MiniMax Feishu Wiki (§ B-5) |
| Refund request | MiniMax Feishu Wiki (§ B-4) |
| How to connect Feishu | MiniMax Feishu Wiki (§ F-1) |
| Feishu unavailable / connection failed | MiniMax Feishu Wiki (§ F-3) |
| Feishu pairing fails / stuck restarting | MiniMax Feishu Wiki (§ F-7) |
| Feishu duplicate replies | MiniMax Feishu Wiki (§ F-5) |
| Add bot to Feishu group | MiniMax Feishu Wiki (§ F-8) |
| HTTP 400 / 500 / Internal server error | MiniMax Feishu Wiki (§ T-1) |
| 413 request too large | MiniMax Feishu Wiki (§ T-2) |
| Always loading / no response / timeout | MiniMax Feishu Wiki (§ T-7) |
| Conversation frozen / sudden termination | MiniMax Feishu Wiki (§ T-8) |
| User hasn't provided chat_id | MiniMax Feishu Wiki (§ S-1) — collect it first |
| Generated files not found | MiniMax Feishu Wiki (§ G-8) |
feishu-wiki + feishu-doc (see references/trusted-sources.md § 2 for how to read).references/trusted-sources.md and query sources in priority order:
extract_content_from_websitesreferences/community-template.md)| Type | Key Signals |
|---|---|
| Execution failure | Non-zero exit, tool error, timeout |
| Knowledge uncertainty | No doc basis, doc contradicts observed behavior, version mismatch |
| Safety risk | Config file, irreversible delete, external send |
| Instruction issue | Ambiguous, contradictory, or out-of-scope request |
| System state | Missing dep, plugin error, session / memory loss |
| Loop / deadlock | Same failure ≥ 2×, condition can never be satisfied |
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.
Proceed independently only if all are true:
openclaw.json or critical config (unless user explicitly authorized)Any condition unmet → stop, go to B-4.
Stop attempting. Report to user:
references/community-template.md to redirect to official supportopenclaw.json without explicit user authorizationreferences/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 communityZIP package — ready to use