manusai部署后服务不可用，主因是底层依赖未就绪：docker守护进程未运行、/var/run/docker.sock权限不足、claw助手未启动或端口不匹配、windows下wmi/rpc服务异常、或代理/防火墙拦截localhost通信。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
ManusAI部署后出现服务不可用、任务卡死或API返回500/404错误，往往不是模型加载失败，而是底层依赖服务未就绪——比如沙盒容器启动失败、Claw助手通信中断、WMI监控模块未注册、或Docker socket权限缺失。这类问题不会在Web界面报错，但会直接阻断PlanAct Agent的调度链路。
确认沙盒执行环境是否就绪
ManusAI的沙盒是任务实际运行的唯一载体，所有工具调用（浏览器、Shell、文件读写）都经由Docker容器完成。若沙盒未启动，整个Agent即失去执行能力。
第一步：检查Docker守护进程是否运行
在服务器终端执行 systemctl is-active docker，返回 active 才算正常；若为 inactive 或报错，需先 sudo systemctl start docker 并设为开机自启。
第二步：验证Docker socket权限
ManusAI后端通过Unix socket /var/run/docker.sock 与Docker daemon通信。默认只有root和docker组用户可访问。执行 ls -l /var/run/docker.sock，确认输出中包含 docker 组名；若显示 root:root 且无docker组，则必须执行：sudo usermod -aG docker $(whoami) → 退出当前SSH会话 → 重新登录。
第三步：手动触发一次沙盒创建测试
进入ManusAI项目根目录，运行：curl -X POST http://localhost:8000/api/v1/sandbox/create -H "Content-Type: application/json" -d '{"image":"ubuntu:22.04"}'
若返回 {"status":"success","container_id":...}，说明沙盒通路正常；若报错 Permission denied 或 connection refused，说明前两步未生效。
验证Claw助手通信链路
Claw是ManusAI的指令解析与用量监控核心，它不运行在沙盒内，而是作为独立服务监听本地端口。如果Claw未启动或端口被占，PlanAct Agent将无法拆解用户请求，表现为“输入无响应”或日志中反复出现 clawusage timeout。
方法一：检查Claw进程是否存活
执行 ps aux | grep clawusage，应看到类似 /usr/bin/python3 /opt/claw/clawusage.py --port 8081 的进程行。若无结果，说明Claw服务未启动。
方法二：测试Claw端口连通性
执行 curl -v http://localhost:8081/health，成功返回 {"status":"ok"} 即表示服务就绪。若提示 Connection refused，请确认Claw配置文件中 PORT 值是否为8081，且未被其他进程占用——【Claw端口必须与ManusAI配置中的claw_url端口严格一致】。
方法三：查看Claw日志定位启动失败原因
Claw启动时若缺少依赖（如requests或telebot），会静默退出。执行 journalctl -u clawusage.service -n 50 --no-pager（若以systemd托管）或直接查看其stdout日志文件，重点搜索 ImportError 或 Address already in use。
这款全能AI助手融合了深度推理、多模态对话与图像生成等前沿技术，全面赋能职场、学习与生活。它支持多模态搜索，精准响应各类信息需求；内置AI文档助手，快速提炼要点并生成思维导图；更有智能创作功能，一键生成报告与文案。强大的AI能力助你高效处理复杂任务，让工作与生活更轻松便捷。
检查Windows系统级依赖（仅限Windows部署）
当ManusAI部署在Windows Server上时，其沙盒虽仍基于Docker Desktop，但底层依赖WMI、RPC、DCOM等系统服务来协调容器生命周期与资源监控。这些服务一旦被禁用或损坏，会导致Docker Desktop无法拉起容器，表现为沙盒创建超时。
打开 services.msc → 找到以下三项服务并确认状态：
• Remote Procedure Call (RPC) → 启动类型必须为“自动”，状态为“正在运行”
• Windows Management Instrumentation → 同样设为自动并启动
• DCOM Server Process Launcher → 必须运行，否则WMI查询将失败
若其中任一服务状态异常，右键→属性→启动类型改为“自动”→点击“启动”。【切勿跳过RPC服务检查——它是ManusAI与Docker Desktop IPC通信的底层通道】。
启动完成后，在PowerShell中执行：Get-WmiObject -Class Win32_Service -Filter "Name='winmgmt'" | Select-Object State,StartMode
返回 State=Running 且 StartMode=Auto 才算真正就绪。
排查网络代理与防火墙干扰
ManusAI内部组件间通信（前端↔后端↔Claw↔沙盒）全部走本地HTTP或Unix socket，但若服务器全局启用了透明代理或iptables规则，可能意外拦截 localhost 流量，导致组件失联。
执行 curl -v http://127.0.0.1:8000/api/v1/health 与 curl -v http://localhost:8000/api/v1/health 对比响应。
若前者成功而后者失败，说明 localhost 解析被代理劫持——检查 /etc/hosts 是否存在异常映射，或环境变量 http_proxy 是否指向了非本地代理地址。
临时关闭防火墙验证：
Linux： sudo ufw disable 或 sudo systemctl stop firewalld
Windows：在“高级安全Windows防火墙”中启用“域配置文件”和“专用配置文件”的“入站规则”→找到“Core Networking”相关规则并启用
若关闭后服务恢复正常，需针对性放行以下端口：
• ManusAI后端端口（默认8000）
• Claw端口（默认8081）
• Docker API端口（默认2375，若启用TCP监听）
