Clawdbot启动后长期显示“连接中”且Agent停滞在bootstrapping，主因是Node.js版本不足、API端点不可达、HTTP连接未优化、客户端性能瓶颈或IPv6异常；需依次验证Node.js 22+、测试API响应、启用TCP快速连接、替换为undici客户端、强制IPv4。
如果您启动Clawdbot后界面长期显示“连接中”，且无后续响应或Agent状态停滞在bootstrapping，可能是网络连通性、本地环境配置或服务端点解析异常所致。以下是针对性的网速优化与安装检测方案：
一、验证Node.js版本与运行时环境
Clawdbot强制依赖Node.js 22+，低版本会导致Gateway初始化失败，表现为持续“连接中”而无日志输出。需确认当前运行时符合最低要求。
1、在终端执行 node --version，检查输出是否为 v22.x.x 或更高版本。
2、若版本低于22，使用nvm切换：运行 nvm install 22 && nvm use 22 && nvm alias default 22。
3、重新执行 clawdbot start 并观察控制台是否出现 Gateway listening on http://localhost:3000 日志。
二、检测API端点可达性与DNS解析延迟
Clawdbot在启动时需向模型提供商（如Minimax）发起预检请求，若域名无法解析或TLS握手超时，将卡在连接阶段。应绕过本地DNS缓存直接测试目标端点响应。
1、执行 curl -I -m 5 https://api.minimax.chat/anthropic/v1/messages，观察是否返回HTTP 401（认证失败）而非超时或Connection refused。
2、若超时，改用IP直连测试：先运行 dig api.minimax.chat +short 获取IP，再执行 curl -I -m 5 --resolve "api.minimax.chat:443:IP地址" https://api.minimax.chat/anthropic/v1/messages。
3、若IP直连成功但域名失败，说明本地DNS污染或运营商劫持，需修改系统DNS为 8.8.8.8 或 1.1.1.1。
三、启用TCP快速连接与连接池调优
Clawdbot默认使用Node.js原生HTTPS客户端，未启用keep-alive复用及TCP Fast Open，在高延迟网络下易触发连接建立超时。可通过环境变量强制启用底层优化。
1、在启动前设置：export NODE_OPTIONS="--http-parser=legacy --enable-fips"。
2、追加连接参数：export CLAWDBOT_HTTP_TIMEOUT=15000 CLAWDBOT_HTTP_MAX_SOCKETS=20。
3、以调试模式重启：clawdbot start --debug，观察日志中是否出现 [http] socket reused 或 [tcp] fast open enabled 提示。
四、替换内置HTTP客户端为undici
Node.js默认客户端在并发请求场景下存在队列阻塞问题，undici作为轻量级现代HTTP/1.1客户端，支持pipeline与自动连接复用，可显著降低首次连接延迟。
1、进入Clawdbot安装目录：cd $(npm root -g)/clawdbot。
2、执行 npm install undici@5.28.3 --no-save。
3、编辑 src/gateway/client.js，将原 require('https') 替换为 require('undici')，并按其文档调整request调用方式为 pool.request()。
4、重新构建并链接：pnpm build && pnpm link。
五、禁用IPv6强制走IPv4路径
部分VPS或家庭网络环境下IPv6栈异常，Clawdbot尝试双栈连接时因IPv6不可达而等待超时，导致“连接中”假死。强制限定IPv4可规避该路径。
1、创建覆盖配置文件：touch ~/.clawdbot/config.local.json。
2、写入内容：{"network":{"preferIPv4":true,"dns":"8.8.8.8"}}。
3、重启服务：clawdbot restart，检查 clawdbot status 输出中是否显示 network: ipv4-only。
