10 SOUL.md Mistakes That Make Your AI Agent Useless

You set up OpenClaw, created a SOUL.md file, and your agent still acts like it has no idea what it's doing. Sound familiar? After reviewing hundreds of SOUL.md configurations and helping dozens of users debug their agent setups, I've identified the same mistakes showing up over and over. These aren't edge cases — they're the most common reasons your agent underperforms. Here are the 10 worst offenders, and exactly how to fix each one. Mistake #1: Being Too Vague About Identity The problem: You are a helpful AI assistant that helps with coding. This tells your agent almost nothing. "Helpful" is meaningless — every AI is trying to be helpful. "Coding" covers everything from HTML to kernel development. The fix: You are Kai, a backend engineer specializing in Python microservices. You have deep experience with FastAPI, SQLAlchemy, and event-driven architectures. You approach problems methodically: understand first, then design, then implement. Specificity creates consistency. When your age