Skill: uepuer/remnawave-robot (version 1.0.6)

# Remnawave Robot 🤖 **技能 ID:** remnawave-robot **版本:** 1.0.1 **作者:** AI Assistant (小 a) **创建时间:** 2026-03-18 **用途:** Remnawave 账号全生命周期自动化管理 --- ## 📋 技能描述 Remnawave Robot 是一个完整的 Remnawave 账号自动化管理工具集，覆盖从配置到运维的全流程： ### 🎯 核心功能 1. **配置向导** - 交互式配置邮箱、API Token 等 2. **账号创建** - 自动创建账号并发送开通邮件 3. **分组管理** - 同步分组、添加/移除用户分组 4. **账号查询** - 搜索账号、查看详情 5. **账号删除** - 安全删除账号 6. **批量操作** - 批量创建、批量修改 ### ✨ 特色优势 - ✅ **一站式配置** - 首次使用引导式配置 - ✅ **订阅地址不变** - 分组更新不影响订阅 - ✅ **邮件通知** - 自动发送开通/变更邮件 - ✅ **完整日志** - 所有操作自动记录 - ✅ **安全可靠** - 凭证加密存储，权限严格控制 --- ## 🚀 快速开始 ### 1️⃣ 首次使用 - 配置向导 ```bash cd ~/.openclaw/workspace/skills/remnawave-robot node setup.js ``` **配置内容:** - Remnawave API 地址 - Remnawave API Token - SMTP 发件邮箱配置 - 默认邮件模板 ### 2️⃣ 创建账号 ```bash node create-account.js \ --username jim_pc \ --email [REDACTED_SECRET] \ --squad "Operations Team" \ --cc [REDACTED_SECRET] ``` ### 3️⃣ 管理分组 ```bash # 同步最新分组列表 node sync-squads.js # 添加用户到分组 node add-to-squad.js --username jim_pc --squad "Access Gateway" # 查询用户分组 node get-squads.js --username jim_pc ``` ### 4️⃣ 搜索账号 ```bash node search-account.js jim ``` --- ## 📖 完整命令列表 | 功能 | 命令 | 说明 | |------|------|------| | **配置向导** | `node setup.js` | 首次使用配置 API 和邮箱 | | **创建账号** | `node create-account.js` | 创建账号并发送邮件 | | **搜索账号** | `node search-account.js <关键词>` | 搜索用户账号 | | **查询分组** | `node get-squads.js` | 查看用户分组 | | **添加分组** | `node add-to-squad.js` | 添加用户到分组 | | **设置分组** | `node set-squads.js` | 覆盖用户分组列表 | | **移除分组** | `node remove-from-squad.js` | 从分组移除用户 | | **同步分组** | `node sync-squads.js` | 同步 API 分组到本地 | | **列出分组** | `node list-squads.js` | 显示所有分组 | | **删除账号** | `node delete-account.js` | 删除指定账号 | | **查看配置** | `node config.js` | 查看当前配置 | --- ## 🔧 配置说明 ### 方式 1: 交互式配置（推荐） ```bash node setup.js ``` 按提示输入： 1. Remnawave API 地址 2. Remnawave API Token 3. 发件邮箱地址 4. SMTP 服务器地址 5. SMTP 端口 6. 邮箱密码/授权码 ### 方式 2: 手动配置 **Remnawave 配置** (`config/remnawave.json`): ```json { "apiBaseUrl": "https://8.212.8.43", "apiVersion": "v1", "sslRejectUnauthorized": false, "_note": "自签名证书，需要忽略 SSL 验证" } ``` **API Token** (`.env`): ```bash REMNAWAVE_API_TOKEN=your_api_token_here ``` **SMTP 配置** (`config/smtp.json`): ```json { "host": "smtp.zoho.com", "port": 587, "secure": false, "auth": { "user": "[REDACTED_SECRET]", "pass": "your_email_password" }, "from": { "email": "[REDACTED_SECRET]", "name": "AI Assistant" } } ``` --- ## 📧 邮件模板 默认模板位置：`templates/account-created.md` **可用变量:** - `{{recipient_name}}` - 收件人姓名 - `{{account_name}}` - 账号名称 - `{{subscription_url}}` - 订阅地址 - `{{tutorial_url}}` - 使用教程链接 - `{{send_date}}` - 发送日期 --- ## 📋 使用示例 ### 示例 1: 创建完整账号 ```bash node create-account.js \ --username west_pc \ --email [REDACTED_SECRET] \ --device-limit 1 \ --traffic-gb 100 \ --traffic-reset WEEKLY \ --expire-days 365 \ --squad "Operations Team" \ --cc [REDACTED_SECRET] ``` ### 示例 2: 调整用户分组 ```bash # 先查询当前分组 node get-squads.js --username west_pc # 添加新分组（保留现有） node add-to-squad.js --username west_pc --squad "Access Gateway" # 验证结果 node get-squads.js --username west_pc ``` ### 示例 3: 批量创建账号 ```bash # 准备用户列表 (users.csv) # username,email,squad # user1,[REDACTED_SECRET],Operations Team # user2,[REDACTED_SECRET],QA Engineer node batch-create.js --file users.csv ``` --- ## 🔍 故障排查 ### 问题 1: 配置不完整 **症状:** `❌ 配置不完整，请先运行 setup.js` **解决:** ```bash node setup.js ``` ### 问题 2: API 连接失败 **症状:** `network error` 或 `SSL certificate problem` **解决:** ```json // config/remnawave.json { "sslRejectUnauthorized": false } ``` ### 问题 3: 邮件发送失败 **症状:** `SMTP connection failed` **解决:** 1. 检查 SMTP 配置 2. 验证邮箱密码/授权码 3. 确认端口和加密方式正确 ### 问题 4: 找不到分组 **症状:** `找不到分组 "XXX"` **解决:** ```bash node sync-squads.js ``` --- ## 🔐 安全注意事项 1. **凭证安全** - API Token 存储在 `.env`，权限 600 - SMTP 密码加密存储 - 不要将凭证提交到版本控制 2. **操作审计** - 所有操作记录到 `logs/` 目录 - 定期审查操作日志 - 敏感操作需二次确认 3. **权限控制** - 仅授权人员可执行创建/删除 - 批量操作需审批 - 生产环境谨慎测试 --- ## 📝 更新日志 ### v1.0.0 (2026-03-18) - ✅ 初始版本发布 - ✅ 配置向导 - ✅ 账号创建 + 邮件发送 - ✅ 分组管理（同步/添加/设置/移除） - ✅ 账号搜索 - ✅ 账号删除 - ✅ 完整日志记录 - ✅ 批量操作支持 --- ## 📞 支持 **文档:** 查看 `README.md` 获取详细文档 **问题:** 联系运维组 Crads **邮箱:** [REDACTED_SECRET] --- **最后更新:** 2026-03-18 **许可:** MIT License **作者:** AI Assistant (小 a)


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)