https://errorvault.dev/tags/networking/Recent content in Networking on ErrorVault — Developer Error Code DictionaryHugoen-usWed, 15 Apr 2026 10:24:49 +0800https://errorvault.dev/openclaw/openclaw-clw-agent-disconnected-agent-disconnect/Wed, 15 Apr 2026 10:24:49 +0800https://errorvault.dev/openclaw/openclaw-clw-agent-disconnected-agent-disconnect/<h2 id="1-symptoms">1. Symptoms</h2> <p>The <code>clw-agent-disconnected</code> error in OpenClaw manifests during agent operations, typically in distributed environments where the Claw Language Worker (CLW) agent handles task execution, data syncing, or remote command dispatching. Users encounter this when the agent loses connectivity to the OpenClaw controller or backend services.</p> <p>Common symptoms include:</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span> </span></span><span style="display:flex;"><span>Error: clw-agent-disconnected (code: AGT-001) </span></span><span style="display:flex;"><span>Agent ID: clw-uuid-1234-5678 lost connection at 2024-10-12T14:30:00Z </span></span><span style="display:flex;"><span>Last heartbeat: 2024-10-12T14:29:45Z </span></span><span style="display:flex;"><span>Reconnect attempts: 5/10 failed </span></span><span style="display:flex;"><span>Task queue stalled: 127 pending jobs </span></span></code></pre></div><ul> <li><strong>Sudden task failures</strong>: Running <code>clw exec --remote</code> or <code>clw sync</code> commands halt with disconnection logs.</li> <li><strong>Agent logs flood</strong>: Check <code>/var/log/clw-agent.log</code> or <code>~/.clw/logs/agent.log</code> for repeated disconnect entries.</li> </ul> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>[ERROR] [2024-10-12 14:30:05] websocket: close 1006 (abnormal closure) </span></span><span style="display:flex;"><span>[ERROR] [2024-10-12 14:30:06] Agent heartbeat timeout. Reconnecting... </span></span><span style="display:flex;"><span>[ERROR] [2024-10-12 14:30:11] clw-agent-disconnected: Max retries exceeded. </span></span></code></pre></div><ul> <li><strong>Dashboard indicators</strong>: OpenClaw UI shows agent status as &ldquo;Disconnected&rdquo; with red icons.</li> <li><strong>Performance degradation</strong>: High latency in <code>clw status</code> outputs, showing offline nodes.</li> </ul> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-fallback" data-lang="fallback"><span style="display:flex;"><span>$ clw status </span></span><span style="display:flex;"><span>Controller: Online </span></span><span style="display:flex;"><span>Agents: </span></span><span style="display:flex;"><span> - clw-agent-01: Disconnected (clw-agent-disconnected) </span></span><span style="display:flex;"><span> - clw-agent-02: Online </span></span></code></pre></div><p>This error disrupts CI/CD pipelines, remote debugging, and multi-node deployments, often occurring under load or after network flaps.</p>