排错速查

错误码 + 工具选型，一页看完

遇到报错先翻这页：每个错误码给三步排查、每个工具给"适合 / 不适合"两侧。

错误码速查

401鉴权失败
  1. Key 是否粘错

    对照后台重新复制 Key，留意首尾空格

  2. BASE_URL 是否配套

    官方 Key 配 api.openai.com，中转 Key 配中转地址

  3. Key 是否被禁

    去后台看是否被作废 / 触发风控，必要时重新生成

看完整笔记 →
429频率 / 并发超限
  1. 降并发

    把并发降到 1，确认单请求能跑通

  2. 看 RPM / TPM

    对照平台限制，必要时升档

  3. 拆批 + 间隔

    批量任务加 sleep，分批跑

看完整笔记 →
503上游服务不可用
  1. 换模型

    切到备用模型确认是否只有某型号挂

  2. 等几分钟

    上游短暂故障常见，先观察

  3. 切通道

    中转站不稳定可暂时切到官方 / 备用中转

看完整笔记 →
524请求超时
  1. 拆任务

    把长输入拆段处理，避免单次请求过长

  2. 换更快模型

    若任务允许，换 mini / flash 系列模型

  3. 记录耗时

    保留失败时间和模型名，方便后续对账

看完整笔记 →
GatewayOpenClaw 网关启动失败
  1. 看日志最后 20 行

    定位 Error / EADDR / Cannot 关键字

  2. 查端口占用

    lsof -i :8080，必要时换端口或杀进程

  3. 补 .env

    对照 .env.example，确认 API_KEY、BASE_URL、TOKEN 全部填好

看完整笔记 →
chat not foundTelegram Bot 找不到聊天
  1. Bot 是否进群

    群聊场景下 Bot 必须被邀请进群且有发消息权限

  2. 用户是否 /start

    私聊场景下用户必须先发 /start 才能被 Bot 主动 push

  3. Chat ID 是否真实

    用 getUpdates 取一次真实 chat_id，注意群 ID 带负号

看完整笔记 →
ECONNREFUSED连接被拒绝
  1. 目标服务是否启动

    确认你要连的服务（OpenClaw、数据库、本地 API）正在运行

  2. 端口是否正确

    检查 URL 里的端口号和服务实际监听的端口是否一致

  3. 防火墙 / 代理

    本地防火墙、VPN 或代理可能拦截了连接，暂时关闭试一下

看完整笔记 →
model_not_found模型名不存在
  1. 模型名拼写

    对照平台模型列表，注意大小写和版本号，如 gpt-4o 不是 gpt4o

  2. Key 权限

    有些 Key 没有开通该模型的权限，去后台确认

  3. 中转站是否支持

    不是所有中转站都转发所有模型，确认你的中转站支持该模型名

看完整笔记 →
insufficient_quota额度不足
  1. 查余额

    去后台看账户余额或额度是否已用完

  2. 充值或换 Key

    充值后等几分钟生效，或换一个有余额的 Key

  3. 检查倍率

    高倍率模型消耗快，考虑换便宜模型跑测试

看完整笔记 →
context_length_exceeded输入超过模型上下文窗口
  1. 缩短输入

    删掉不必要的历史消息或资料，只保留当前任务需要的内容

  2. 切片检索

    长文档不要全塞进去，用 RAG 只检索相关段落

  3. 换大窗口模型

    如果确实需要长上下文，换 128K 或 200K 窗口的模型

看完整笔记 →

工具速查

  • OpenClawAgent 工作台

    适合：做客服 / 知识库 / Telegram Bot 这类有界面的 Agent

    不适合：纯写代码、跑 IDE 内任务

    看详细 →
  • Claude CodeAI 代码助手

    适合：对话式改代码、单文件调试、验收目标收尾、claude agents 管后台会话

    不适合：没有验收条件就直接放它改生产项目

    看详细 →
  • CodexAI 代码助手

    适合：跨多文件长任务、AGENTS 约束、自动跑批；Codex App 可用 Computer Use 操作 GUI

    不适合：把 CLI 当成桌面控制工具，或在敏感窗口里无监督乱点

    看详细 →
  • Codex++Codex Desktop 扩展

    适合：给 Codex Desktop 加 /goal、快捷键、Better Terminal、Better Browser 等 tweak

    不适合：只想稳定使用官方 Codex、不想承担 App patch 和 repair 风险

    看详细 →
  • Windows AI 编程环境本机环境

    适合：稳定运行 Codex App / CLI / Computer Use、Claude Code CLI、WSL2 和 Git Bash

    不适合：不愿区分 Windows 原生与 WSL2 路径的混用场景

    看详细 →
  • CursorAI 代码助手

    适合：编辑器内补全 / 多文件改动 / 团队协作

    不适合：无 IDE 的纯命令行任务

    看详细 →
  • Telegram Bot对外入口

    适合：把 Agent 接到群、私聊、定时通知

    不适合：需要复杂网页交互的场景

    看详细 →
  • 1A1API 中转站API 通道

    适合：开通快、统一接口、多家模型切换

    不适合：对供应商稳定性要求极高的核心生产

    看详细 →
  • 1A1 Listing Studio电商 AI 工具

    适合：用户填自己的 1A1API Key，生成电商文案、图片 Prompt、AI 搜索文件和素材包

    不适合：无 Key 公共白嫖、精准修图或全自动一键上架

    看详细 →
  • 1A1API Image2.0 生图 Skill图像模型

    适合：用生图专用分组 Key 调 gpt-image-2，做电商图、海报、封面和 Agent 配图流程

    不适合：把真实 Key 写进前端、提示词或公开仓库

    看详细 →
  • Skills CLI技能包管理

    适合：搜索、安装、更新 Claude Code / Codex / Cursor 等 Agent 技能

    不适合：不想审查来源、只想一次性跑任务

    看详细 →
  • Open Design设计 Agent 工作台

    适合：用 Claude Code / Codex / OpenCode 生成网页、移动端、海报和 PPT 原型

    不适合：直接当生产级设计系统或无需审查就上线

    看详细 →
  • Agent Reach搜索与读取

    适合：让 Agent 搜网页、GitHub、Reddit、YouTube、小红书、B站和 RSS

    不适合：需要绕过平台规则或用主账号批量自动化

    看详细 →
  • MediaCrawler内容研究采集

    适合：小规模研究小红书、抖音、B站、微博、贴吧、知乎的公开内容和评论

    不适合：商业化大规模爬虫、采集隐私数据或违反平台规则

    看详细 →
  • OpenCLI / 平台 CLI平台自动化

    适合：复用登录态，把平台搜索、阅读、导出转成 Agent 可调用命令

    不适合：自动评论、自动发帖、主账号高频操作

    看详细 →