1. openclaw 小龙虾 dashboard 崩溃到底卡在哪openclaw 小龙虾的 dashboard 页面崩溃是很多人第一次跑起来就会撞上的问题。它的表现通常是浏览器里页面白屏、转圈不出内容或者命令行里openclaw dashboard执行后直接报错退出甚至提示 gateway 连接失败。这个工具本身是一个本地运行的 AI 编码助手面板dashboard 负责把会话、模型通道、任务状态可视化出来而 gateway 是它背后真正干活的网关进程。两者关系可以理解成gateway 是后厨dashboard 是前台菜单屏后厨没起来前台自然一片空白。适合遇到这个场景的人有三类刚装完 openclaw 想跑通第一条对话的新手改了 config.toml 或 settings.json 之后页面突然打不开的进阶用户以及把模型通道切到统一 API 网关后dashboard 加载模型列表就崩的老用户。核心检索词就是 openclaw、gateway、dashboard、cmd、页面崩溃这几个词基本覆盖了排查路径。我踩过的坑是一开始以为页面崩溃是浏览器缓存问题清了半天缓存没用后来才发现根因在 gateway 没执行完就被我 CtrlC 掐掉了。所以这篇不聊虚的直接从 gateway 与 cmd 两侧把配置和恢复动作拆开讲给你能直接复制的 config.toml 与 settings.json 骨架再走一遍 TaoToken 统一 Key 接入最后做页面恢复验证。2. 先搞懂 gateway 与 dashboard 的启动顺序2.1 为什么必须等 gateway 执行完openclaw 的 gateway 启动时会做几件事读取 config.toml 里的模型通道配置、初始化本地服务端口、注册可用的模型列表。这个过程在第一次运行或配置变更后会比较久因为它要建立连接并做一次能力探测。如果你在它还没结束时就在同一个 cmd 窗口敲openclaw dashboarddashboard 拿不到 gateway 注册好的端口和模型信息页面就会崩溃或空白。正确做法是分两个窗口一个窗口专门跑openclaw gateway并保持不动另一个新开 cmd 跑openclaw dashboard。这就是原方案里最关键的一步很多人失败不是命令错而是窗口和时序错了。2.2 cmd 窗口的角色cmd 在这里不是随便开的终端它是 gateway 和 dashboard 的宿主。gateway 窗口要一直挂着dashboard 窗口负责拉起前端页面。两个窗口互不干扰关掉 gateway 窗口等于把后厨关了dashboard 页面刷新就会崩。所以排查时先确认gateway 窗口是不是还活着有没有报错日志。3. TaoToken 前置统一 Key 与 API 通道准备在动 config.toml 之前先把模型通道准备好。openclaw 支持把模型请求指向统一的 API 网关这样 dashboard 里加载模型列表、发起对话都走同一条通道配置也更干净。TaoToken 就是做这件事的官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基地址是 https://taotoken.net/api 。你需要先拿到一个 Key。登录后进入控制台在 API Keys 页面创建一个新 Key复制保存好后面填进 config.toml。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 页面是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你只是想先验证模型通不通可以用模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 直接发一条消息测试。注意Key 只填在本地配置文件里不要提交到 git也不要在截图里露出完整 Key。4. 可复制配置config.toml 与 settings.json 骨架4.1 config.toml 骨架下面这份 config.toml 把模型通道指向统一 API 网关字段名按 openclaw 常见约定写你按自己版本微调。重点是 base_url 和 api_key 两处。# openclaw config.toml [gateway] host 127.0.0.1 port 8760 log_level info [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey default_model claude-sonnet-4-20250514 timeout_seconds 120 [dashboard] auto_open true refresh_interval 5base_url结尾不要多加/v1按上面这个写法即可openclaw 会自己拼接路径。default_model填你在模型对话页面能看到并确认可用的模型名。timeout_seconds给大一点首次探测模型列表会慢。4.2 settings.json 骨架settings.json 一般放在用户配置目录负责 dashboard 的界面与行为。下面这份是恢复页面后能正常加载的最小骨架。{ dashboard: { theme: dark, language: zh-CN, showModelList: true, gatewayHost: 127.0.0.1, gatewayPort: 8760 }, model: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, defaultModel: claude-sonnet-4-20250514 }, logging: { level: info, file: ./logs/openclaw.log } }两个文件的gatewayPort必须一致都是 8760。端口不一致是 dashboard 崩溃的常见隐藏原因页面连不上 gateway 就直接白屏。4.3 参数对照表参数作用建议值gateway.host网关监听地址127.0.0.1gateway.port网关端口8760model.base_url模型 API 基地址https://taotoken.net/apimodel.api_key统一 Key控制台创建dashboard.refresh_interval页面刷新秒数5timeout_seconds请求超时1205. 恢复步骤从 gateway 到 dashboard 的完整动作5.1 第一步启动 gateway 并等它跑完打开一个 cmd 窗口输入openclaw gateway回车后不要做任何其他操作也不要关窗口。第一次运行或改过配置后它会执行比较久可能一分钟以上。你会看到日志一行行刷出来直到出现类似gateway listening on 127.0.0.1:8760或model list loaded的提示才算真正就绪。这一步是整个恢复流程的核心没等完就切窗口后面必崩。5.2 第二步新开 cmd 跑 dashboard保持上面那个窗口不动按 WinR输入 cmd打开一个新的命令行窗口。在新窗口里执行openclaw dashboard这时 dashboard 会去连已经就绪的 gateway正常情况下浏览器会自动弹出 openclaw 页面模型列表和会话面板都能加载出来。5.3 第三步确认页面恢复页面出来后先看三处左上角模型下拉框有没有列出模型中间会话区能不能发一条测试消息右下角 gateway 状态是不是绿色或显示已连接。三处都正常说明崩溃已经恢复。6. 验证请求确认模型通道真的通了页面恢复不等于模型通道通了还要单独验证一次请求。在 dashboard 里新建一个会话发一句简单的话比如「你好回复一个字」。如果返回正常说明 config.toml 里的 base_url 和 api_key 生效了。也可以用命令行直接验证避免 dashboard 缓存干扰curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}] }返回里有choices字段和内容就说明 Key 和通道都没问题。如果这里报 401是 Key 错了报 404是模型名或路径不对超时则是网络或 base_url 写错。验证通过后再回 dashboard 刷新页面就稳定了。7. 本篇常见错排查7.1 gateway 没跑完就开 dashboard这是最高频的错。表现是 dashboard 白屏或报连接拒绝。解决就是回到 5.1重新开一个干净的 cmd 跑 gateway等日志出现监听提示再开新窗口。7.2 两个窗口端口不一致config.toml 写 8760settings.json 写 8080dashboard 连不上。检查两处gatewayPort是否一致改完重启 gateway。7.3 Key 或 base_url 写错base_url 多写了/v1或者 Key 复制时带了空格都会导致模型列表加载失败dashboard 跟着崩。用第 6 节的 curl 单独验证能快速定位。7.4 旧 cmd 窗口残留进程之前崩溃时没关干净的 gateway 进程还占着 8760 端口新 gateway 起不来。用netstat -ano | findstr 8760找到进程号任务管理器结束掉再重来。7.5 配置文件格式错误config.toml 少个引号、settings.json 多个逗号都会让 openclaw 启动时解析失败。用编辑器自带的 JSON 校验先过一遍再启动 gateway。8. 页面恢复后的收尾与长期使用建议页面恢复后建议把 gateway 窗口固定住别随手关。如果你要长期跑编码任务或接 Agent 工作流可以考虑用 Coding Plan 把额度集中管理入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置字段有更新时以文档为准。Claude Code 相关的接入说明在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。最后留一个实用习惯每次改完 config.toml 或 settings.json先跑openclaw gateway看日志有没有报错确认监听成功再开 dashboard。这样页面崩溃基本不会再找上门。