@esign-ai/veriagent-cli

VeriAgent CLI 是统一安装入口，用于在当前终端为 OpenClaw 或 Hermes 安装并初始化 VeriAgent 插件。

功能概览

| 能力 | 说明 | |---|---| | 交互安装 | 让用户选择安装到 OpenClaw 或 Hermes | | 指定目标安装 | 通过命令参数直接指定 OpenClaw 或 Hermes | | 依赖检查 | 检查目标 CLI 是否可用，Hermes 会校验最低版本 | | 插件安装 | 调用目标宿主的插件安装命令 | | 初始化 | 安装后自动进入 VeriAgent 初始化流程 |

环境要求

| 项 | 要求 | |---|---| | Node.js | 18 或以上 | | OpenClaw | 安装 OpenClaw 时需要当前终端可执行 openclaw | | Hermes | 安装 Hermes 时需要当前终端可执行 hermes | | 浏览器 | VeriAgent 初始化流程需要打开授权页面 | | 网络 | 可访问目标插件源和 VeriAgent 服务 |

使用方式

交互选择：

npx -y @esign-ai/veriagent-cli install

指定安装到 OpenClaw：

npx -y @esign-ai/veriagent-cli install openclaw

指定安装到 Hermes：

npx -y @esign-ai/veriagent-cli install hermes

OpenClaw 安装流程

veriagent-cli install openclaw
  -> 检查 openclaw 命令
  -> 安装 @esign-ai/openclaw-veriagent
  -> 重启 OpenClaw Gateway
  -> 执行 openclaw veriagent init
  -> 打开授权页面并完成 VeriAgent 初始化

等价执行：

openclaw plugins install clawhub:@esign-ai/openclaw-veriagent
openclaw gateway restart
openclaw veriagent init

如果插件已存在，CLI 会继续执行 Gateway 重启和 VeriAgent 初始化。

Hermes 安装流程

veriagent-cli install hermes
  -> 检查 hermes 命令
  -> 校验 Hermes 版本
  -> 安装 hermes-veriagent 插件
  -> 启用 hermes-veriagent 插件
  -> 执行 hermes veriagent init
  -> 打开授权页面并完成 VeriAgent 初始化

等价执行：

hermes --version
hermes plugins install https://github.com/esign-ai/hermes-veriagent.git
hermes plugins enable hermes-veriagent
hermes veriagent init

Hermes 版本需要满足 CLI 内置的最低版本要求。

初始化结果

安装完成后，可在目标宿主中查看 VeriAgent 状态。

OpenClaw：

openclaw veriagent status

Hermes：

hermes veriagent status

状态中应包含本地 agentId 和 certificateFile。

注意事项

| 事项 | 说明 | |---|---| | 当前终端执行 | CLI 会在当前终端顺序执行目标宿主命令 | | 重复安装 | 已安装插件时会继续执行后续初始化步骤 | | 浏览器授权 | 初始化过程中需要用户在浏览器完成授权 | | Hermes 版本 | 版本不足时需要先升级 Hermes | | OpenClaw Gateway | OpenClaw 插件安装后会重启 Gateway |