remnawave-robot（雷纳波机器人）

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️⃣ 首次使用 - 配置向导

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.tech

3️⃣ 管理分组

# 同步最新分组列表
node sync-squads.js

# 添加用户到分组
node add-to-squad.js --username jim_pc --squad "Access Gateway"

# 查询用户分组
node get-squads.js --username jim_pc

4️⃣ 搜索账号

node search-account.js jim

📖 完整命令列表

🔧 配置说明

方式 1: 交互式配置（推荐）

node setup.js

按提示输入：

1. Remnawave API 地址
2. Remnawave API Token
3. 发件邮箱地址
4. SMTP 服务器地址
5. SMTP 端口
6. 邮箱密码/授权码

方式 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_here

SMTP 配置 (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

解决:

1. 检查 SMTP 配置
2. 验证邮箱密码/授权码
3. 确认端口和加密方式正确

问题 4: 找不到分组

症状: 找不到分组 "XXX"

解决:

node sync-squads.js

🔐 安全注意事项

1. 凭证安全

- API Token 存储在 .env，权限 600 - SMTP 密码加密存储 - 不要将凭证提交到版本控制

1. 操作审计

- 所有操作记录到 logs/ 目录 - 定期审查操作日志 - 敏感操作需二次确认

1. 权限控制

- 仅授权人员可执行创建/删除 - 批量操作需审批 - 生产环境谨慎测试

📝 更新日志

v1.0.0 (2026-03-18)

• ✅ 初始版本发布
• ✅ 配置向导
• ✅ 账号创建 + 邮件发送
• ✅ 分组管理（同步/添加/设置/移除）
• ✅ 账号搜索
• ✅ 账号删除
• ✅ 完整日志记录
• ✅ 批量操作支持

📞 支持

文档: 查看 README.md 获取详细文档 问题: 联系运维组 Crads 邮箱: crads@codeforce.tech

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