常见报错 · 小白

排错协助怎么提交

先按工具查看 Help 并在控制台定位日志；仍未解决时，把现象、步骤和严格脱敏后的必要日志片段发到 zhemuy@gmail.com。

  • 排错
  • 服务
更新于 2026-07-26

一句话结论

只提交定位问题所需的最小材料；Authorization、Cookie、API Key、Token、密码和环境变量值必须全部删除。

适用场景

  • OpenClaw 怎么也跑不起来
  • Codex 或 Claude Code 报错看不懂
  • Telegram Bot 或 API 调用一直失败

常见现象

  • 终端一片红
  • 面板打不开
  • Bot 没反应、API 一直报错

原因解释

  • 环境差异（系统、Node、Docker、网络）
  • 环境变量配置缺漏或工具读取位置不对
  • 网关、账号分组或上游模型暂时不可用

解决步骤

  1. 先打开 https://help.1a1api.top/troubleshooting，按 Codex、Claude Code 或其他客户端进入对应分流。
  2. 记录工具、系统、失败时间、请求 ID、模型和操作步骤。
  3. 只截取报错前后必要的日志片段；分享前删除 Authorization、Cookie、API Key、Token、密码、SSH 信息、客户数据和环境变量值。
  4. 不要发送整个 `.env` 文件；只列出相关变量名，并把值统一写成 `<REDACTED>`。
  5. 说明你已经试过哪些办法以及每一步结果。
  6. 把以上内容发到 zhemuy@gmail.com

仍然不行怎么办

  • 实在写不清楚，可以录一段短视频；录制前关闭密码管理器、聊天窗口和生产后台，并检查画面没有密钥或客户资料，再发到 zhemuy@gmail.com

小白先准备什么

  1. 先在控制台或工具日志里找到失败时间和请求 ID，再截取报错前后必要片段。
  2. 记录你执行了什么命令、在什么系统上、什么时间开始出错。
  3. 只记录相关环境变量名；所有值统一替换成 `<REDACTED>`，不要发送整个 `.env`。
  4. 列出你已经试过的办法（重启、重装、换 Key 等），避免重复排查。

验收标准

  • 提交的信息能判断问题层级（工具/配置/账号分组/网关/上游模型）
  • 日志和截图里没有 Authorization、Cookie、API Key、Token、密码、SSH 信息或客户数据
  • 操作步骤按时间顺序写清楚，能复现问题

最有用的 6 类材料

  • 必要报错片段：包含状态码、message、请求 ID 和相邻上下文，不发送与问题无关的整份日志。
  • 运行环境：系统、Node / Docker / Python 版本、是否用了代理或 VPN。
  • 配置摘要：BASE_URL、模型名、端口、Bot username 和相关变量名；所有密钥、Token、Cookie、密码及变量值写成 `<REDACTED>`。
  • 最近改动：今天改过哪些文件、升级过哪些工具、换过哪些 Key。
  • 复现步骤：先点哪里、再输什么、什么时候报错。
  • 期望结果：你本来希望它打开页面、回复消息、跑通构建，还是完成部署。

哪些情况要先别继续折腾

  • 已经连续重装三次还失败：先保留当前日志，别再覆盖现场。
  • 涉及生产账号、客户数据、余额、付款、数据库：先备份并说明影响范围。
  • 网络运维场景中会影响门店或公司上网：先约维护窗口。
  • Agent 要求你粘贴完整 API Key、Cookie、SSH 密码：立即停止，绝不发送任何真实凭据；若已发送，立即撤销并轮换。
  • 同一个错误反复出现但每次改不同配置：先回到最近一次能运行的状态。

可复制提交模板

【排错协助提交】

分享前确认：已删除 Authorization、Cookie、API Key、Token、密码、SSH 信息、客户数据和环境变量值。

1. 工具：OpenClaw / Codex / Claude Code / Telegram Bot / 其他
2. 系统：macOS / Windows / Linux / Docker
3. 现象：{一句话描述，例如「启动后面板白屏」}
4. 操作步骤：
   - 第 1 步：{你做了什么}
   - 第 2 步：{你做了什么}
5. 失败时间和时区：{例如 2026-07-26 14:30 GMT+8}
6. 请求 ID：{如有}
7. 必要日志片段：
   {只粘贴报错前后相关行，敏感值统一写 <REDACTED>}
8. 配置摘要：
   BASE_URL=https://xxx
   MODEL=YOUR_MODEL_ID
   API_KEY=<REDACTED>
9. 已尝试：
   - {试过什么，结果如何}
10. 联系方式：{微信/Telegram/邮箱}

常见误区和不适合场景

  • 误区：只说「跑不起来」不提供失败时间和必要日志片段 → 无法对应控制台请求。
  • 误区：把完整日志或整个 `.env` 直接发出 → 可能同时泄露多个凭证，应先最小化并严格脱敏。
  • 误区：同时改了三个配置再来问 → 一次只改一个变量才能定位
  • 不适合：需要全新项目搭建的需求（应走定制入口）
  • 不适合：模型回答质量不满意（应走 Prompt 调优，不是排错）

相关问题

还卡着？

仅把删除凭证、客户数据和环境变量值后的必要截图、日志片段、需求说明或当前页面链接发到 zhemuy@gmail.com。