open-claw-team/.openclaw/workspace/.learnings/ERRORS.md

[ERR-20260330-001] pure_response_rule_violation

Logged: 2026-03-30T08:19:00Z Priority: high Status: resolved Area: orchestration

Summary

Mixed natural language with tool calls in a single response, violating the Pure Response Rule.

Error

Response contained introductory text followed by a JSON array of tool calls. The system expects either pure tool calls (JSON only) or pure text (no tool calls), never both.

Context

• Attempted to spawn a ClawTeam sub-agent for portfolio project
• Added explanatory text before the tool call JSON
• This causes response rejection

Suggested Fix

• Always separate tool calls and natural language into distinct turns
• Use sessions_yield after spawning to wait for results
• Send user updates via message tool as separate tool calls if needed

Metadata

• Reproducible: yes
• Related Files: RULES.md (Tool Call Rules section)
• See Also: LRN-20260330-001 (mandatory skill usage rules)