GatewayBot

Clawline Gateway 项目的专属开发运维 Bot，负责管理端 UI 开发、认证集成、数据库迁移和 CI/CD 维护。

概述

GatewayBot（🚪 守门机器人）是 Clawline Gateway 项目的专属 Bot，运行在 Mattermost 上，称用户为”爸爸/Dad”。它是 Gateway 管理端的核心开发者，独立完成了从 mock UI 到全栈生产系统的完整开发周期，包括科幻风格管理界面、Logto SSO 认证、Supabase 数据库迁移、UI 审计修复和组件库重构。

核心职责

管理端 UI 开发 (admin-new)

• 技术栈：React 19 + Vite 6 + Tailwind v4 + shadcn/ui + framer-motion + lucide-react
• 科幻风格三层架构：
  • TIER_1: Gateway 状态概览（channels、backend links、live clients）
  • TIER_2: Channel 管理（水果命名 + emoji 图标，如 🥭 mango、🍒 cherry）
  • TIER_3: User 配置（动物命名，如 falcon、octopus）
• 功能：Channel/User CRUD、自动刷新(5s)、连接 URL 生成（openclaw://connect?serverUrl=...）

认证系统演进

完成了三代认证方案：

1. V1: Admin Token 手动输入 → X-Relay-Admin-Token header
2. V2: Logto SSO 登录 + Admin Token 二次认证
3. V3 (最终): Logto SSO → JWT Access Token（Authorization: Bearer）+ 后端 JWKS 验证

Logto 配置：

• SPA App ID: anbr9zjc6bgd8099ecnx3
• API Resource Indicator: https://gateway.clawlines.net/api
• JWKS Endpoint: https://logto.dr.restry.cn/oidc/jwks

数据库迁移 (Supabase)

将存储从本地 data/relay-config.json 迁移到 Supabase PostgreSQL：

• 表：cl_channels、cl_channel_users
• API 方式：/pg/query 端点（因 PostgREST schema cache 未刷新，REST API 返回 404）
• 后续切换到 /pg/rest/v1 端点

UI 审计与重构

执行了完整的三轮 UI 审计修复：

• Round 1 (/harden)：Focus indicators、颜色对比度 WCAG AA、Modal Escape 键、Toast ARIA、触摸目标 44px+、表格语义、reduced-motion
• Round 2 (/typeset + /distill)：字体大小(10px→12px)、Header 简化、移除装饰性动画
• Round 3 (/normalize)：设计令牌系统(CSS 变量)、sans/mono 字体区分(47→13处)
• shadcn/ui 重构：引入 Button/Dialog/Input/Table 组件，App.tsx 从 2000+ 行拆分到 <200 行

CI/CD 维护

• GitHub Actions 修复：移除 tarball 打包（tar “file changed” 竞态问题），只保留 Docker 镜像构建
• 关键提交：7b27b65(UI 集成)、3696159(JWT 认证)、87da32b(Supabase 存储)、2e5fb54(UI 审计修复)

运行环境

• 项目：clawline/gateway（workspace-clawline-gateway）
• OpenClaw 版本：2026.3.8 (3caab92)
• 模型配置：
  • github-copilot/claude-opus-4.6（默认）
  • prism-foundry/gpt-5.4
  • prism-foundry/FW-GLM-5
  • liwei-eastus2/FW-MiniMax-M2.5
  • github-copilot/gemini-3.1-pro-preview
• 技能：codex-delegate（核心）、github、coding-agent 等 13 项
• Codex CLI：v0.115.0，Azure OpenAI gpt-5.4，支持 session resume

部署信息

环境	地址	端口
生产	https://gateway.clawlines.net	—
开发	https://gw.dev.dora.restry.cn	前端 3020 + 后端 3021

配对记录

配对码	日期
ZBZFX5D9	2026-03-17

时间线

• 2026-03-17 19:00: 上线配对，首次响应
• 2026-03-17 19:34: 通过 Codex 完成 admin-new UI 集成（mock→真实 API，耗费 259k tokens）
• 2026-03-17 20:44: 首次 push 代码到 clawline/gateway
• 2026-03-18 07:46: 完成 Logto SSO 集成，移除 admin token 输入界面
• 2026-03-18 10:15: 完成 OAuth2 JWT 全流程（前端 Bearer token + 后端 JWKS 验证）
• 2026-03-18 18:29: 接收 Supabase 数据库连接信息
• 2026-03-18 21:17: 通过 /pg/query 完成数据库迁移
• 2026-03-18 23:48: 修复 GitHub Actions CI（tar 竞态问题）
• 2026-03-20 19:46: 完成三轮 UI 审计修复（/harden + /typeset + /distill + /normalize）
• 2026-03-20 20:37: 响应式布局修复（Desktop/iPad/Mobile）
• 2026-03-20 21:17: 开始 shadcn/ui 组件库引入
• 2026-03-21 16:27: 完成 App.tsx 拆分重构（2000+行→<200行）

相关页面

• clawline
• mm-bots
• openclaw-config
• supabase-platform
• caddy-reverse-proxy