sagit-chu/flvx/doc

npm install -g @flvx/skill-api

# 从 FLVX 源码
cd /path/to/flvx
mkdir -p ~/.agents/skills
ln -sf $(pwd)/skills/flvx-api ~/.agents/skills/
 
# 或从 GitHub
git clone https://github.com/Sagit-chu/flvx.git
cd flvx
ln -sf $(pwd)/skills/flvx-api ~/.agents/skills/

export FLVX_BASE_URL="https://your-panel.example.com"
export FLVX_USERNAME="admin"
export FLVX_PASSWORD="your-password"

mkdir -p ~/.flvx
cat > ~/.flvx/.env << 'EOF'
export FLVX_BASE_URL="https://panel.example.com"
export FLVX_USERNAME="admin"
export FLVX_PASSWORD="your-password"
EOF
chmod 600 ~/.flvx/.env
source ~/.flvx/.env

npm install -g @flvx/skill-api

export FLVX_BASE_URL="https://panel.example.com"
export FLVX_USERNAME="admin"
export FLVX_PASSWORD="your-password"
 
opencode

你: 查看我的转发列表
你: 创建一个转发到 192.168.1.100:80 使用隧道 1
你: 检查节点状态
你: 查看流量使用情况

npm install -g @flvx/skill-api
 
# 或手动链接
mkdir -p ~/.openclaw/skills
ln -sf /path/to/flvx/skills/flvx-api ~/.openclaw/skills/flvx-api

openclaw
 
>>> 查看所有节点状态
>>> 给用户 alice 分配 50GB 流量
>>> 导出系统备份

# FLVX API Skill
 
你可以通过 REST API 操作 FLVX 面板。
 
## 环境变量
-FLVX_BASE_URL: 面板地址
-FLVX_USERNAME: 用户名
-FLVX_PASSWORD: 密码
 
## 认证规则
-Authorization 头使用原始 JWT token，不加 "Bearer " 前缀
-所有 API 使用 POST 方法
 
## 常用 API
 
### 登录获取 token
POST /api/v1/user/login
{"username": "...", "password": "..."}
 
### 查看转发列表
POST /api/v1/forward/list
Authorization: <token>
{}
 
### 创建转发
POST /api/v1/forward/create
{"name": "xxx", "tunnelId": 1, "remoteAddr": "1.2.3.4:80"}
 
### 查看节点
POST /api/v1/node/list
{}

cd /path/to/your/project
claude

mkdir -p ~/.claude
cat > ~/.claude/CLAUDE.md << 'EOF'
# FLVX Panel Operations
 
使用 FLVX REST API 操作流量转发面板。
 
环境变量: FLVX_BASE_URL, FLVX_USERNAME, FLVX_PASSWORD
调用方式: curl -X POST "$FLVX_BASE_URL/api/v1/..." -H "Authorization: $TOKEN"
注意: Authorization 不要加 Bearer 前缀
EOF

cat ~/.agents/skills/flvx-api/SKILL.md >> ~/.claude/CLAUDE.md

>>> 帮我查看 FLVX 面板上有哪些节点
>>> 创建一个名为 test 的转发，目标地址 10.0.0.1:80
>>> 查看我的流量使用情况

# 方式 1: 推送 tag
git tag skill-v2.1.6
git push --tags
 
# 方式 2: GitHub Actions 手动触发
# 在 Actions 页面运行 publish-skill workflow