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