Docker Desktop 无法启动
以 Markdown 查看首次运行时最常见的故障：HeartBeatAgents 需要 Docker Desktop 处于运行状态，才能启动任何智能体。
HeartBeatAgents 使用 Docker 来隔离每个智能体的执行环境（参见安全）：这在所有平台上都是一项硬性要求，而非可选项。如果应用在启动时卡住，或智能体无法启动，最有可能的原因就是 Docker 尚未运行。
检查 Docker Desktop 是否确实在运行
在系统托盘（Windows）或菜单栏（macOS）中查找 Docker 鲸鱼图标。如果没有看到，请手动启动 Docker Desktop，并等待其显示“Docker Desktop is running”后再重新打开 HeartBeatAgents。
常见原因
- 未启用虚拟化：在 Windows 上，Docker Desktop 需要 WSL 2 或 Hyper-V。请在 Windows 功能中检查“虚拟机平台”和“适用于 Linux 的 Windows 子系统”是否已启用。
- 资源不足：Docker Desktop 自身的设置（首选项 → 资源）会限制其可使用的 CPU/内存上限。如果设置得过低，容器在负载下可能会启动失败。
- 先前的 Docker 进程未正常退出：请完全重启 Docker Desktop（从系统托盘/菜单栏图标退出，而不仅仅是关闭窗口），而不是在一个卡住的实例上重新启动。
仍然无法解决？
请查看 Docker Desktop 自身的诊断日志（Docker Desktop → Troubleshoot → Get support）。大多数启动失败发生在 Docker 层面，而非 HeartBeatAgents 层面，Docker 自身的诊断通常会准确指出具体原因。