Remnawave Robot

自动化管理Remnawave账号全生命周期，支持配置向导、账号创建、分组同步、账号查询、删除及批量操作，并发送邮件通知。

技能 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 [e-mail] \
  --squad "Operations Team" \
  --cc [e-mail]

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": "[e-mail]",
    "pass": "your_email_password"
  },
  "from": {
    "email": "[e-mail]",
    "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 [e-mail] \
  --device-limit 1 \
  --traffic-gb 100 \
  --traffic-reset WEEKLY \
  --expire-days 365 \
  --squad "Operations Team" \
  --cc [e-mail]

示例 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,[e-mail],Operations Team
# user2,[e-mail],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
邮箱: [e-mail]

---

最后更新: 2026-03-18
许可: MIT License
作者: AI Assistant (小 a)