---
title: 排查常见问题
description: 按启动、模型、任务和调度逐层缩小范围。
lastVerified: 2026-10-18
---

# 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

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

## 报告安全问题 {#security-reports}

跨项目报告渠道见 [Teloa AI Security 安全报告指引](https://security.teloa.ai/report/?lang=zh-CN)。安全站还收录源于 Teloa 开发实践的[智能体身份与授权安全基线](https://github.com/teloa-ai/agent-baseline-assessor)，可用[在线自评工具](https://security.teloa.ai/agent-baseline-assessor/?lang=zh-CN)核对具体部署的证据与差距；基线是评估目标，不代表产品已满足全部要求。

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

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

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

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

## 联系产品支持

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

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

## 提交问题时提供什么

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