OpenClaw Auth UI

轻量级 OpenClaw OAuth 模型授权 Web 界面，支持 Qwen、OpenAI、MiniMax、Google 等多种提供商。

功能亮点

• 多提供商 OAuth：Qwen Portal、OpenAI Codex、MiniMax、Google Antigravity、Google Gemini CLI
• 自动打开授权页：生成授权链接后自动在新标签页打开
• 可点击授权链接：UI 提供手动备用入口
• Token 透传：授权完成后自动携带 token 跳转至 OpenClaw Gateway 根路径
• 深色渐变 UI：现代化响应式界面，带渐变光效
• 国际化：自动检测浏览器语言（中文/英文）

环境要求

• Node.js 18+（推荐 24.x）
• pnpm（优先）或 npm

快速开始

npm install

npm install -g openclaw-auth-ui@latest

1. 克隆与安装

git clone https://github.com/qqliaoxin/openclaw-auth-ui.git
cd openclaw-auth-ui
pnpm install

2. 构建

pnpm build

3. 启动

# 方案 A：生产构建
HOST=localhost PORT=3300 BASE_PATH=/auth pnpm start:dist

# 方案 B：开发模式
pnpm start

# 方案 C：CLI
node bin/cli.js --port=3300 --host=localhost --base-path=/auth

4. 访问

浏览器打开：

http://localhost:3300/auth/

选择提供商 → 点击 开始授权 → 完成 OAuth → 自动跳转至 Gateway 并携带 token。

5. 发布

发布前请确认：

• package.json 中 "private": false
• Git 工作区干净（或使用 pnpm publish --no-git-checks）
• 当前为 ESM 项目，发布脚本已适配 ESM

pnpm publish

打包与本地部署

生成安装包

rm -rf dist openclaw-auth-ui-*.tgz
pnpm build
pnpm pack

本地安装运行

# 安装压缩包
npm i ./openclaw-auth-ui-0.1.0.tgz

# 运行
npx openclaw-auth-ui --port=3300

一行 npx

npx -p file:$(pwd) openclaw-auth-ui --port=3300 --host=localhost --base-path=/auth

Linux 部署示例

# 1. 安装 Node.js 24.x（通过 brew）
brew install node@24
brew unlink node
brew link --overwrite --force node@24

# 2. 系统依赖
apt update
apt install -y build-essential python3 make g++
pnpm approve-builds -g

# 3. 安装 Auth UI
pnpm remove -g openclaw-auth-ui
export GIT_SSH_COMMAND="ssh -o StrictHostKeyChecking=no"
pnpm add -g /root/openclaw-auth-ui-0.1.0.tgz --force

# 4. 启动服务
openclaw-auth-ui --port=3300 --host=localhost --base-path=/auth

# 5. 设备授权（可选）
openclaw devices list
openclaw devices approve <device-id>

配置项

| 变量名 | 默认值 | 说明 | |--------------|-------------|--------------------------| | PORT | 3000 | 服务端口 | | HOST | localhost | 服务地址 | | BASE_PATH | /auth | 静态资源基础路径 |

开发指南

pnpm install
pnpm start          # 开发服务器
pnpm build          # 生产构建

开源协议

MIT