Dev 环境部署全景
从 Clawline Client Web 拆分。
WebBot 梳理了 *.dev.dora.restry.cn 开发环境的完整部署架构。所有服务运行在 matrix 机器上,通过 Caddy 反向代理 统一路由。
| 域名 | 端口 | pm2 服务 | 内容 | 负责 Agent |
|---|---|---|---|---|
web.dev.dora.restry.cn | 3026 | dev-web | client-web(React) | clawline-client-web |
gw.dev.dora.restry.cn | 3020 | dev-gw | gateway admin 静态页 | clawline-client-web |
docs.dev.dora.restry.cn | 3029 | dev-docs | VitePress 文档 | clawline-client-web |
portal.dev.dora.restry.cn | 3002 | portal-api + portal-static | Portal 后端 API + 静态前端 | research-portal |
bi.dev.dora.restry.cn | 8899 | bi-backend + dev-bi | BI 服务 | research-bi |
craft.dev.dora.restry.cn | — | dev-craft | Clawcraft(部分请求转发 OWL) | research-craft |
channel.dev.dora.restry.cn | 3023 | dev-channel-h5 | Channel H5 示例页 | clawline-channel |
Gateway Admin 重新部署
gw.dev.dora.restry.cn 的管理端经历了一次重大部署迁移:
- 原状:pm2
dev-gw从旧的workspace-clawline-gateway/repo/admin/distserve 静态文件,JS 资源过旧缺少 AI Settings 按钮 - 根因:research agent 之前 build 了新的前端但部署到了错误目录
- 迁移:pm2
dev-gw从旧workspace-clawline-gateway切换到workspace-clawline-client-web/gateway-repo/public,完成从独立 gateway 仓库到 WebBot 管辖的转移 - 遗留问题:旧版 Logto token 残留导致白屏,需手动清除浏览器 logto 缓存后重新登录
Gateway 全流程测试(Claude Code CLI)
researcher agent 通过 tmux 管理的 Claude Code CLI(session 401d2e5f)对 Gateway 进行了全流程本地测试:
| 功能 | 测试结果 |
|---|---|
| Admin UI | ✅ 正常 |
| AI Settings GET/PUT | ✅ 返回默认值 / DB 覆盖生效 |
| Suggestions API | ✅ 返回 7 条建议 |
| Voice Refine API | ✅ 语音转写清理正常 |
| 消息持久化 | ✅ Supabase 有真实消息 |
Bug 修复:测试中发现 max_tokens → max_completion_tokens 兼容性问题(GPT-5.4-mini 不支持旧参数),commit 12bb93d 修复。