clawhub-login
ClawHub OAuth 登录助手 - 无头服务器专用
version: 1.0.0
author: 大总管
description: 帮助在无头服务器上通过 OAuth 方式登录 ClawHub，解决浏览器认证问题
问题场景
在无头服务器（无浏览器）上使用 clawhub login 时：
- 默认会尝试打开浏览器 → 失败 (
spawn xdg-open ENOENT) - 需要手动获取授权 URL → 在本地浏览器打开 → 完成认证
本 skill 自动化这个流程。
使用方法
方式 1：交互式（推荐）
python3 ~/.openclaw/workspace/skills/clawhub-login/scripts/clawhub_login.py
按提示操作：
- 复制输出的授权 URL
- 在本地浏览器打开
- 授权后复制回调 URL
- 粘贴到服务器完成登录
方式 2：命令行
# 获取授权 URL
python3 ~/.openclaw/workspace/skills/clawhub-login/scripts/clawhub_login.py --get-url
# 验证登录状态
python3 ~/.openclaw/workspace/skills/clawhub-login/scripts/clawhub_login.py --check
# 退出登录
python3 ~/.openclaw/workspace/skills/clawhub-login/scripts/clawhub_login.py --logout
完整流程
步骤 1：运行脚本
$ python3 scripts/clawhub_login.py
🔐 ClawHub OAuth 登录助手
检测到无头环境，使用手动授权模式...
1. 打开以下 URL（复制到本地浏览器）：
https://clawhub.ai/cli/auth?redirect_uri=...&state=xxx
2. 授权后，复制浏览器显示的 URL
3. 粘贴回调 URL：
步骤 2：在本地浏览器打开 URL
- 点击授权
- 浏览器会跳转到回调页面
- 复制完整的回调 URL
步骤 3：粘贴到服务器
粘贴回调 URL：https://clawhub.ai/cli/auth/callback?code=xxx&state=xxx
✅ 登录成功！欢迎 @mengwuzhi
在 OpenClaw 中使用
# 让 agent 帮你登录
openclaw agent --message "帮我登录 ClawHub"
Agent 会：
- 运行
clawhub login获取授权 URL - 输出 URL 让你复制到本地浏览器
- 等待你提供回调 URL
- 完成登录
技术原理
ClawHub 使用 OAuth 2.0 流程：
1. CLI 生成授权 URL（含 state 参数）
↓
2. 用户在浏览器打开并授权
↓
3. ClawHub 重定向到回调 URL（含 code）
↓
4. CLI 用 code 交换 token
↓
5. Token 保存到 ~/.clawhub/token
故障排查
问题：xdg-open ENOENT
原因： 无头服务器没有图形界面
解决： 使用本 skill 的手动授权模式
问题：回调 URL 无效
原因： 授权已过期或 state 不匹配
解决： 重新运行脚本获取新的授权 URL
问题：登录状态丢失
原因： Token 文件被删除或过期
解决： 重新登录
相关文件
| 文件 | 路径 |
|---|---|
| Token 存储 | ~/.clawhub/token |
| Token 配置 | ~/.config/clawhub/config.json |
安全提示
- ⚠️ Token 相当于密码，不要分享
- ⚠️ 定期更新 Token（重新登录）
- ⚠️ 不要在公共电脑上保存 Token
基于实战经验
本 skill 基于 2026-02-28 在无头服务器上登录 ClawHub 发布 create-openclaw-agent skill 的实战经验总结。
许可证
MIT License
作者备注： 这是第一个专门解决 ClawHub 无头登录问题的 skill。