xai-user-manage

一个面向 OpenClaw 的 XAI 用户管理 skill，支持查询、开户、充值，以及 AllowIPs / Role / ModelLimits 的专用更新命令。

项目简介

xai-user-manage 是一个可直接部署到 OpenClaw 的用户管理 skill，目标是把日常用户运营动作标准化、脚本化、可审计化。

它适合这些场景：

• 批量给用户充值
• 批量修改 AllowIPs
• 批量修改 Role
• 精准更新某个用户的 ModelLimits
• 在远程 OpenClaw 服务器上快速安装和初始化

相比只保留一个通用 update 入口，这个项目额外提供了更贴近日常运维习惯的专用子命令，降低误操作成本。

功能亮点

• 支持 OpenClaw skill 形态
• 支持远程服务器一键安装
• 支持安装时直接写入远程 EXTEND.md
• 支持 paths 排查配置命中路径
• 支持中文姓名自动转拼音
• 支持批量操作结果输出为 JSON
• 支持专用命令：allowips / role / model-limits
• 支持通用 JSON 更新：update

命令总览

命令	说明
list	查询全部用户
get	查询单个用户
create	创建用户
recharge	单用户充值
batch-recharge	批量充值
allowips	专用命令，更新 AllowIPs
role	专用命令，更新 Role
model-limits	专用命令，更新 ModelLimits
update	通用 JSON 更新
paths	查看配置发现路径

目录结构

xai-user-manage/
├── SKILL.md
├── README.md
├── LICENSE
├── .gitignore
├── EXTEND.example.md
├── install.sh
├── requirements.txt
├── scripts/
│   └── xai_user_manage.py
└── references/
    ├── config/
    │   └── first-time-setup.md
    ├── deploy-openclaw-server.md
    └── server-env-setup.md

快速开始

1. 本地直接运行

python3 scripts/xai_user_manage.py paths
python3 scripts/xai_user_manage.py list --token 'sk-xxxx'

2. 安装到远程 OpenClaw

如果你已经配置好了 SSH 别名，例如 vps-us：

./install.sh --host vps-us

如果安装时顺手写入 token：

./install.sh --host vps-us --set-token 'sk-xxxx'

如果安装时一起初始化接口地址和邮箱域名：

./install.sh --host vps-us \
  --set-token 'sk-xxxx' \
  --set-base-url 'https://api.xairouter.com' \
  --set-email-domain 'xairouter.com'

配置示例

复制 EXTEND.example.md 为 EXTEND.md，例如：

auth_token_env: XAI_API_KEY
api_base_url: https://api.xairouter.com
email_domain: xairouter.com
default_credit: 1000
default_days: 365
default_output_dir: ./xai-user-manage-output
timeout: 30

如果暂时无法确认 OpenClaw 服务使用哪个用户启动，也可以先直接写：

auth_token: sk-xxxx

使用示例

查询全部用户

python3 scripts/xai_user_manage.py list

查询单个用户

python3 scripts/xai_user_manage.py get --username zhangsan

创建用户

python3 scripts/xai_user_manage.py create --name 张三

单用户充值

python3 scripts/xai_user_manage.py recharge --username zhangsan --credit 1000 --days 365

批量充值

python3 scripts/xai_user_manage.py batch-recharge --file users.txt --credit 1000 --days 365 --output ./xai-user-manage-output

更新 AllowIPs

python3 scripts/xai_user_manage.py allowips --username zhangsan --allowips "8.8.8.8,114.114.114.114"

更新 Role

python3 scripts/xai_user_manage.py role --username zhangsan --role 1

更新 ModelLimits

python3 scripts/xai_user_manage.py model-limits --username zhangsan --payload-file payload.json

适合放在 GitHub 首页的说明

这个项目适合作为：

• OpenClaw 用户管理 skill 示例
• AI 网关平台用户运营脚本模板
• 远程 skill 部署与配置初始化参考实现

如果你要公开发布，建议在仓库描述中使用类似文案：

OpenClaw skill for managing XAI platform users, including query, credit recharge, AllowIPs, Role, and ModelLimits updates.

发布前检查

发布到 GitHub 前建议确认：

• 没有把真实 token 提交进仓库
• EXTEND.md 未提交，只保留 EXTEND.example.md
• README.md 示例命令可直接运行
• install.sh 语法通过
• scripts/xai_user_manage.py 可以正常编译
• LICENSE 已存在

开源信息

• License: MIT
• 推荐仓库名：xai-user-manage
• 推荐 Topics：openclaw, skill, python, cli, user-management, ai-gateway

相关文档

• SKILL.md
• references/config/first-time-setup.md
• references/deploy-openclaw-server.md
• references/server-env-setup.md