5.3 排查常见问题

先记下出错时间、页面动作和脱敏错误，再查相应层。不要首先清空数据库或重新安装全部环境。

安装与启动

现象	检查和处理
docker 命令不存在	安装 Docker CLI 与可运行的本机引擎，执行 docker info 验证
Docker 无法连接	启动引擎，检查当前 context 或环境变量；不要默认切向远程环境
同名容器不属于当前项目	源码开发模式下返回原源码目录操作；该错误终止初始化，不会主动停止原容器
端口被占用	查明占用进程的用途；不要使用模糊进程名批量结束服务
扩展构建错误	Compose 安装查看镜像构建输出；源码模式检查 Node、pnpm 版本和依赖，再运行 pnpm check:dsh
页面 401 或认证失效	使用本次启动输出的完整认证链接，避免复制旧令牌；npm 安装运行 teloa open，或用 teloa open --print-url 获取本机登录链接
teloa up 提示此安装与当前命令包版本不同	原安装不会被自动替换。要保留原数据切换版本，先运行 teloa stop，再运行 teloa upgrade --to <版本>

模型与员工

通过 npm 安装后，先运行 teloa doctor（尚未首次启动也可运行）。npm 检查失败时核对 PATH 中的版本，需 11.12.1 或更新的 11.x。Linux「终端沙箱」失败时检查 bubblewrap、用户命名空间或 Landlock 内核能力；模型能回应、页面能打开也不能证明受限命令能执行。不要通过关闭沙箱消除错误。doctor --json 中每项检查有 ok 与 message，失败项另带处理建议 remedy；退出码 1 表示仍有检查未通过。

先在普通对话验证模型。对话也失败时查模型连接；只有某位员工失败时查其在岗状态、运行配置、业务范围和资料授权。

群里没有回应时先看是否选中或提及正确员工，以及收到、配置错误等可见反馈。没有反馈也不要推断任务已开始，检查具体任务与执行记录。

自动化与 Auto Dream

确认本机服务在线、计划启用、员工状态和时间时区。再看该日期是否已有运行记录。重新上线不会保证补齐每个离线时段；补跑前核对重复风险。

报告安全问题

跨项目报告渠道见 Teloa AI Security 安全报告指引。安全站还收录源于 Teloa 开发实践的智能体身份与授权安全基线，可用在线自评工具核对具体部署的证据与差距；基线是评估目标，不代表产品已满足全部要求。

按问题所在位置选择报告入口：

• Teloa 社区版应用（含后台服务）：在 teloa-ai/teloa Issues 提交问题，也可使用无需登录的反馈表单。
• 市场资源（AI 员工、AI 团队、应用、技能等）：一般问题和安全疑虑优先在 teloa-ai/marketplace Issues 公开报告。请附资源详情页链接、资源 ID 和版本，便于定位。

如果问题可能造成重大影响，例如远程执行代码、大范围密钥泄露或访问用户隐私，建议先私下发至 security@teloa.ai。邮件报告不需要 GitHub 账号。

请提供影响范围、版本和脱敏后的复现条件。公开内容中不要包含真实的密钥、口令或登录令牌，以及个人数据或尚未公开的漏洞利用步骤；敏感细节建议通过私密渠道补充。

联系产品支持

可以通过提交反馈报告产品问题、文档错误或改进建议，无需登录。填写联系邮箱后便于团队回复；反馈私有保存，成功提交后会显示反馈编号。入口位于本站顶栏和每篇文档底部，产品内也可在关于页提交。

support@teloa.ai 是产品支持、问题与反馈的主收件箱。商务与合作请发至 hi@teloa.ai。

提交问题时提供什么

提供版本、操作步骤、预期结果、实际结果和已脱敏的错误信息。不要提交模型密钥、Cookie、认证 URL、数据库连接串或整份运行目录。模型没有产生结果与界面显示结果失败应分别描述。