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 jim@codeforce.tech \
  --squad "Operations Team" \
  --cc crads@codeforce.tech

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": "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: 创建完整账号#

bash

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: 调整用户分组#

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,user1@example.com,Operations Team
# user2,user2@example.com,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

邮箱: crads@codeforce.tech

---

最后更新: 2026-03-18

许可: MIT License

作者: AI Assistant (小 a)