适用范围与准备

本文从已安装且能够打开 OpenClash 的 OpenWrt/iStoreOS 开始。安装包、内核与依赖必须对应固件版本、CPU 架构和防火墙环境，按官方项目说明安装；不把任意路由器刷机包含在教程操作里。修改前导出固件配置并记下管理地址，保留一台可直接进入后台的电脑。

添加原生配置订阅

先在 Roxi 网站登录自己的账户，打开订阅区域，复制“第三方客户端”订阅地址。不要复制官网首页、邀请链接或浏览器地址栏里的登录地址。客户端不附送节点；套餐、流量、到期时间和设备限制以账户页为准。

使用账户页的“路由器订阅链接”，路径为 /sub/router/个人标识；它与 /sub/clash/ 的配置类型相同。

下面的 /sub/... 仅表示原链接中的路径。保留账户提供的域名、个人标识和查询参数；只替换一次路径，不把示例占位符当作真实地址，也不要重复加成 /sub/clash/clash/。已有专用链接时直接使用。不要将订阅 URL 发给公共转换站。

  1. 进入服务 → OpenClash → 配置订阅，新建订阅名称并粘贴路由器链接。
  2. 该链接已经返回完整 mihomo YAML，先使用直接下载方式，不额外启用不必要的在线转换；保存后手动更新并看日志。
  3. 在配置管理选择这份文件，使用兼容的 mihomo/Meta 内核，先做配置检查，再启动服务。
  4. 按自己的主路由/旁路由拓扑核对接管范围；首次只选择一台测试终端，避免同时开启 PassWall、ShellCrash 等透明代理。

从终端验收，而不是只看路由器面板

  1. 测试电脑先关闭自己的个人代理/VPN，确认网关与 DNS 确实指向本次设置的链路。
  2. 从电脑打开实际目标，再查看 OpenClash 连接记录中的源终端、域名、规则与节点。路由器自身 curl 成功不证明 LAN 设备已接管。
  3. 检查国内网站、路由器管理页及需要使用的 NAS/打印机；通过后再扩大设备范围。

失败时优先停止接管

配置解析错误先核对内核和字段；规则下载失败先查路由器的解析与下载路径；无终端连接记录先查网关、DNS 和访问控制。整网异常时在后台停止 OpenClash，恢复之前的 DNS/网关设置，确认直连和后台可达后再排查，不连续刷新固件。

失败后按层排查，保留可恢复的配置

现象先核对下一步
下载失败或 401 / 403订阅地址、账户状态、设备限制和当前网络回账户复制新地址；看响应说明，不连续重复导入
解析失败 / 节点为零下载到的是 YAML、JSON、节点列表还是登录网页换成本文指定格式，保留错误字段名与客户端版本
能启动但目标打不开当前节点、规则、DNS 和请求日志换一条兼容节点做对照，勿删除 TLS 校验
停止后不能直连系统代理、其他 VPN、断线阻止设置先在客户端正常停止接管，再退出；恢复改动前设置

求助只提供系统与客户端/核心版本、失败阶段、发生时间和脱敏日志。升级前备份本地规则；订阅更新会替换远程内容，个性化设置尽量放在客户端支持的覆写或本地规则里。