https://errorvault.dev/tags/installation/ Recent content in Installation on ErrorVault — Developer Error Code Dictionary Hugo en-us Tue, 12 May 2026 03:08:04 +0800 https://errorvault.dev/openclaw/openclaw-clw-agent-not-found-agent-binary/ Tue, 12 May 2026 03:08:04 +0800 https://errorvault.dev/openclaw/openclaw-clw-agent-not-found-agent-binary/ <h2 id="1-symptoms">1. Symptoms</h2> <p>When the <code>clw-agent-not-found</code> error occurs, you&rsquo;ll observe one or more of the following symptoms in your OpenClaw deployment:</p> <p><strong>Primary Error Message:</strong></p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#ff79c6">[</span>ERROR<span style="color:#ff79c6">]</span> clw-agent-not-found: Could not locate clw-agent binary in system PATH or configured directory </span></span><span style="display:flex;"><span>--- </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>**Additional Console Output:** </span></span><span style="display:flex;"><span><span style="color:#f1fa8c">```</span>bash </span></span><span style="display:flex;"><span>$ openclaw agent start </span></span><span style="display:flex;"><span>OpenClaw v2.4.1 - Initializing agent subsystem... </span></span><span style="display:flex;"><span><span style="color:#ff79c6">[</span>ERROR<span style="color:#ff79c6">]</span> Agent binary not found at expected location: /usr/local/bin/clw-agent </span></span><span style="display:flex;"><span><span style="color:#ff79c6">[</span>ERROR<span style="color:#ff79c6">]</span> Searched paths: </span></span><span style="display:flex;"><span> - /usr/local/bin </span></span><span style="display:flex;"><span> - /usr/bin </span></span><span style="display:flex;"><span> - /opt/openclaw/bin </span></span><span style="display:flex;"><span> - ~/.openclaw/agents/current </span></span><span style="display:flex;"><span><span style="color:#ff79c6">[</span>ERROR<span style="color:#ff79c6">]</span> Exit code: <span style="color:#bd93f9">127</span> </span></span></code></pre></div><p><strong>Application-Level Symptoms:</strong></p>