本文只处理一个问题：在 OpenWrt LuCI 的 OpenClash v0.47.156 中加入一条 vmess:// 分享链接。它适用于 Mihomo 内核，不是 Clash for Windows、Clash Verge Rev 或 FlClash 的导入教程。旧版 OpenClash 的标签与导入能力可能不同，操作前先确认插件版本。

vmess:// 表示单个 VMess 节点的分享信息，通常包含服务器地址、端口、UUID、传输方式和 TLS 等参数；https:// 订阅地址则是 OpenClash 可以请求并定期更新的远程配置入口。把前者直接当作普通订阅 URL 下载，OpenClash 不会因此自动得到一份远程配置。

手上的内容含义本文对应入口
vmess://…单条节点分享链接开启在线订阅转换，或从「节点 & 策略组管理」本地导入
https://…远程订阅或配置地址通常直接放入「配置订阅」的订阅地址
.yaml / .yml已经生成的配置文件使用配置文件上传或管理入口，不属于本文范围

两个可用方案：在线订阅转换操作较省事，但分享凭据会交给转换服务；本地节点导入由 v0.47.156 的 LuCI 页面脚本解析并填入表单，不需要第三方转换服务。敏感或自建节点优先选本地方案。

完整 VMess 分享链接应按密码处理。不要把它贴进公开搜索、论坛、在线 YAML 校验器或排障截图，也不要在文章、聊天和浏览器地址栏中保留真实链接。本文只用脱敏占位形式：

脱敏示例vmess://REDACTED
  1. 确认链接来自你有权使用且可信的服务端或服务商。
  2. 记录当前活动配置文件名、OpenClash 运行状态，以及修改前可用的节点。
  3. 若选择在线转换，先确认转换服务的运营者与隐私边界；不能确认时改用本地导入。
  4. 若链接曾经公开出现，先在服务端或服务商面板撤销并重新生成凭据，再继续操作。

“只有一条节点”也可能泄露账户：VMess 的 UUID 是认证信息，链接还可能暴露服务器域名、端口、SNI、WebSocket Host 与路径。遮住节点备注并不足以脱敏。

方法一：在配置订阅中开启在线订阅转换

OpenClash v0.47.156 的「编辑配置文件订阅信息」页面明确说明：只有启用「在线订阅转换」后，「订阅地址」才支持 SS、SSR、VMess 等节点链接。转换服务会接收你填入的链接，因此这一方法只适合你信任或自己维护的转换后端。

  1. 进入「服务 → OpenClash → 配置订阅」，新增一条配置订阅，或编辑专门用于本次测试的条目。
  2. 填写便于识别的别名，把一条完整 vmess:// 链接放入「订阅地址」。不要与现有订阅混在同一条目中做首次测试。
  3. 开启「在线订阅转换」，在「订阅转换服务地址」中选择你已经核验的服务；不要因为页面有预设地址就默认它适合提交私有凭据。
  4. 保存后回到配置订阅列表，点击该条目的更新按钮，或使用页面底部「更新配置」。后者会提交设置、启用并启动 OpenClash，期间可能短暂断流。
  5. 等待更新完成，检查是否生成配置、是否出现 VMess 节点，再按后文步骤验证。

官方界面本身提示隐私风险：“在线订阅转换”不是路由器本地格式转换。转换地址对应的服务能够看到提交内容；无法核验服务时，不要使用这一方案。

方法二：在节点管理页面本地导入分享链接

不想把分享链接交给转换服务时，可使用 OpenClash 的服务器节点编辑器。v0.47.156 的页面提供 SS/SSR/VMESS/TROJAN URL 区域和「导入配置信息」按钮；点击后会要求“在此处粘贴分享链接”。对应源码中的 parseVmess 在浏览器页面里解析链接并填写节点表单。这说明该导入动作本身不需要调用第三方转换接口，但保存后的节点凭据仍会写入路由器配置。

  1. 进入「服务 → OpenClash → 配置管理」，在目标 YAML 的操作项中选择「节点管理」并点击「应用」。
  2. 进入「节点 & 策略组管理」后先点击「读取配置」，再在「服务器节点配置」区域新增一项；这是页面源码明确要求的编辑顺序。
  3. 打开新节点编辑页，在 SS/SSR/VMESS/TROJAN URL 行点击「导入配置信息」，粘贴完整 vmess://。出现“导入配置信息成功”只表示页面解析成功。
  4. 确认「配置文件」仍是刚才选择的目标配置；只有确实需要时才改为“添加到所有配置文件”。
  5. 在“添加到策略组”中选择当前配置确实存在的组。不要随意输入一个尚未创建的组名。
  6. 逐项核对字段并点击「保存配置」。返回「节点 & 策略组管理」后点击「应用配置」，把节点写回目标 YAML；然后再让当前运行配置重新加载一次。

本地导入更适合单条私有节点：它避免把原始链接发送给订阅转换服务，单节点也不会被当作可远程更新的订阅。以后凭据变更时，需要手动编辑或重新导入。

保存前核对 VMess 字段，导入成功不等于参数正确

v0.47.156 的导入器兼容常见 V2RayN Base64 JSON 形式，也会尝试解析 URI 风格的 VMessAEAD 链接。它会填写常见字段，并把部分未知的简单参数放入“其他参数”；对象类型的未知字段不会被自动补全。因此必须以节点提供方的原始参数和 Mihomo VMess 文档为准。

必须核对常见来源字段错误时的表现
服务器、端口、UUIDadd、port、id解析失败、拒绝连接或认证失败
加密方式、Alter IDscy / encryption、aid握手无法建立；不要凭经验改值
TLS、SNI、指纹tls / security、sni、fpTLS 握手或证书校验失败
传输方式net / typeTCP、WebSocket、HTTP/2 或 gRPC 选错会无法连接
路径、Host、服务名path、host、serviceName能连服务器但协议请求不匹配
配置范围与策略组OpenClash 表单选择节点保存了，却未进入当前配置或目标组

特别检查证书校验默认值：v0.47.156 的新建节点表单把 skip-cert-verify 默认设为 true，而 VMess 导入器不会在链接缺少 insecure 参数时主动改成 false。若可信原配置没有要求跳过校验，导入后应手动设为 false 再保存；不要把表单默认值当作服务端要求。

应用配置后，用节点列表和连接日志完成验证

  1. 保存节点或订阅后，执行一次配置更新或应用，等待 OpenClash 恢复运行。
  2. 先查启动日志中的第一个配置解析、策略组或 VMess 错误，不要连续重复更新。
  3. 确认新节点出现在预期配置和策略组；没有出现时先检查“配置文件”和“添加到策略组”，不要改 TLS。
  4. 手动选择新节点，发起一个真实请求，在连接日志中确认最终使用的节点与错误类型。
  5. 再切回原节点测试一次，以区分新节点参数问题与路由器整体网络问题。

延迟测试成功只表示健康检查地址当时可达，不代表所有目标服务都能使用。真正的完成标准是：OpenClash 能启动、新节点位于正确配置与策略组、真实请求经它建立、原有节点仍可切回。

看见节点但无法连接：先对照服务端检查 UUID、端口、TLS、SNI 和传输层字段。不要同时切换 DNS、Fake-IP、TUN、内核和代理模式。

常见失败与回退：只撤销本次新增项

现象优先检查处理方式
订阅地址更新失败是否未开启在线订阅转换开启并使用可信转换服务，或改走本地导入
本地导入提示无效格式链接是否完整、是否真以 vmess:// 开头从可信来源重新复制；不要在线解码后公开排查
导入成功但节点未出现配置文件范围与策略组选中当前配置和已存在的组，再应用配置
节点出现但连接失败服务器、UUID、TLS、SNI、传输参数逐项与服务端核对，只修改一个字段后复测
更新后 OpenClash 无法启动启动日志中的首个解析错误先撤销本次节点或订阅条目，再恢复原配置

需要回退时，本地方案只删除本次新增的服务器节点，然后在「节点 & 策略组管理」再次点击「应用配置」，把删除结果写回目标 YAML，再重新加载当前运行配置。在线方案先切回之前记录的活动配置，再停用或删除本次配置订阅条目；这一步只停止订阅记录，不会自动删除已经生成的 YAML。若该文件确实由本次测试新建且不再需要，应先确认它不是活动配置、下载备份，再从「配置管理」单独移除。不要删除原订阅或批量清空节点。

如果链接已经提交给无法信任的转换服务，删除 OpenClash 里的条目并不能撤回已泄露内容；应在服务端或服务商面板轮换 UUID 或重新生成分享凭据。OpenClash、Mihomo 相关入口可从本站下载页面核对，但更换客户端不能修复错误的 VMess 参数。

官方来源与版本边界

版本号、文件名和界面文字可能随项目更新而变化，操作前请以链接中的项目文档为准。