AionClaw 启动失败、技能不响应、模型调用空白等问题90%源于配置文件错误：config.yaml中enable_token:true未配token或格式错误；config.json中model节点api_key/base_url/model_name错位或残留旧provider；gateway.host未设为0.0.0.0导致白屏；modules开关或CSP策略引发静默失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
报错不是服务挂了，而是配置没对齐——AionClaw 启动失败、技能不响应、模型调用空白，90% 都卡在 config.yaml 或 config.json 里那几行参数上。
报错「unauthorized: gateway token missing」怎么修
这是启动阶段最典型的鉴权失败，不是 Key 错了，是根本没传进去。
-
检查
config.yaml中的enable_token：如果值为true，就必须配套写上token:，且冒号后必须有一个空格，不能是token:abc123（少空格）或token: abc123\n（带换行） - 环境变量优先级高于配置文件：如果你用了
OPENCLAW_TOKEN环境变量，它会覆盖config.yaml里的token，但若环境变量为空或未设置，enable_token: true就会直接触发这个报错 - Docker 场景下特别注意：用
docker run -e OPENCLAW_TOKEN=xxx传入，别只改配置文件却忘了挂载或传参
模型调用失败、返回空内容、超时三连报错怎么统一排查
这三类现象看着不同，根源往往都是同一个：model 节点配置错位。AionClaw 默认读 ~/.openclaw/config.json，不是 config.yaml。
- 先确认你改的是哪个文件：
cat ~/.openclaw/config.json | jq '.model'（Linux/macOS）或直接打开 Windows 下的C:\Users\你的用户名\.openclaw\config.json - 重点核对三项：
api_key（必须是 TaoToken 的 Key）、base_url（必须是https://taotoken.net/api，**不能带/v1，不能带 utm 参数**）、model_name（如deepseek-v4-pro或kimi-k3，大小写和连字符必须完全一致） - 旧配置残留是高频坑：如果之前填过阿里云百炼或 Ollama，
config.json里可能还留着provider: "aliyun-bailian"这类字段，AionClaw 会尝试按该 provider 解析字段，导致忽略base_url直接报 401
面板白屏或无限转圈，浏览器打不开 http://localhost:8080
这不是 AionClaw 没起来，是你根本没让它被访问到。
- 检查监听地址：
config.yaml里gateway.host必须是0.0.0.0，不是127.0.0.1——后者只允许容器/进程自己访问，宿主机浏览器连不上 - 端口映射要匹配：Docker 启动时用
-p 8090:8080，浏览器就得访问http://localhost:8090；如果没做映射，容器内 8080 对外不可见 - 防火墙/安全组拦路：阿里云 ECS 需手动放行对应端口（如 8090），不只是开 Docker，还要在控制台配安全组规则
技能（Skill）运行失败但日志没报错，怎么办
这种“静默失败”最容易被忽略，问题常出在模块启用开关或 CSP 策略上。
- 检查
config.yaml中modules下对应项是否启用：比如用了图表技能，但modules.charting.enabled是false，就会无反应 - TTS 模块误激活会导致文本输出被截断成音频流：确认
modules.tts.enabled为false，除非你真需要语音 - 浏览器控制台报
Refused to load ... violates Content-Security-Policy：说明图片、JS 或 iframe 加载被拦截，需在config.yaml中调整security.csp配置，或临时设为""测试是否是 CSP 导致
真正麻烦的从来不是报错信息本身，而是同一处配置在不同场景下触发不同错误表现——比如 base_url 多了个 /v1，可能在 AionClaw 报 404，在策研Claw 报 timeout，在影创Claw 却只显示“正在处理中”。改完记得重启网关，别信“热重载”。
