| name | blocker-min-input |
| description | When blocked, report exact blocker + attempts made + minimum user input needed. Enable fast unblock without back-and-forth. |
Blocker Minimum Input
When blocked, provide everything needed for fast unblock. No back-and-forth.
Problem
Agents often:
- Say "blocked" without specifics
- Don't report what was tried
- Ask vague questions
- Require multiple clarifications
Workflow
1. Blocker Report Format
**Blocker**: Exact error/blocker text
**Attempts Made**:
- Attempt 1: what + result
- Attempt 2: what + result
**Minimum Unblock Input**: Smallest user action needed
**Fallback Option**: Alternative if user cannot unblock
2. Attempt Requirements
Before reporting blocker:
- Retry same approach with corrected parameters (1x)
- Try one fallback path
- If both fail, report with evidence
3. Minimum Input Examples
| Blocker | Minimum Input |
|---|
| Missing API key | Run: openclaw configure --section web |
| Permission denied | Grant write access to: D:\folder OR Use fallback: C:\workspace\folder |
| Auth failure | Check token in: openclaw.json |
Executable Completion Criteria
| Criteria | Verification |
|---|
| Blocker text exact | Quote error message verbatim |
| Attempts listed | At least 2 attempts documented |
| Minimum input specific | Single command or action |
| Fallback provided | Alternative path exists |
Privacy/Safety
- No credentials in blocker reports
- Redact tokens/keys from error messages
- Use generic paths when sensitive
Self-Use Trigger
Use when:
- Any tool call fails twice
- User input required to proceed
- Permission/auth issues detected
One report. One input. Unblock fast.
