返回文档中心

在 OpenClaw 中接入 VeriAgent

本文介绍如何在 OpenClaw 中安装并初始化 VeriAgent 插件。你可以选择通过 npx 命令快速接入，也可以通过 ClawHub 插件市场手动安装。

完成接入后，终端会返回 VeriAgent 平台授权地址。打开该地址后，你可以继续完成 Agent 认证和数字证书申请。

前置条件

开始前，请确认你已满足以下条件：

  • 已拥有 VeriAgent 平台账号。
  • 已安装 Node.js，建议使用 Node.js 18 或以上版本。
  • 已安装 npm / npx，且 npx --version 可正常返回。
  • 已安装并配置好 OpenClaw 运行环境，且 openclaw --version 可正常返回，版本需满足 pluginApi >= 2026.3.24-beta.2、Gateway >= 2026.3.24-beta.2。
  • 当前网络可访问 npm、ClawHub 和 VeriAgent 平台页面。

方式一：通过 npx 快速接入

如果你希望快速完成 VeriAgent 插件安装和初始化，建议使用 npx 方式。

  1. 打开终端。

  2. 执行以下命令：

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

  3. 等待安装和初始化流程完成。

    命令执行完成后，终端会返回 VeriAgent 平台授权地址。

  4. 复制终端返回的授权地址，并在浏览器中打开。

说明：npx 方式会安装并初始化 VeriAgent 插件。平台登录授权、Agent 信息填写和数字证书申请仍需在 VeriAgent 平台页面中完成。

方式二：通过 ClawHub 安装

如果你的团队已经通过 ClawHub 管理 OpenClaw 插件，可以使用 OpenClaw 插件命令安装 VeriAgent 插件。完成插件安装、Gateway 重启和初始化后，终端会返回 VeriAgent 平台授权地址。

步骤一：安装 VeriAgent 插件

在终端执行：

bash
openclaw plugins install clawhub:@esign-ai/openclaw-veriagent

该命令会从 ClawHub 插件市场拉取并安装 VeriAgent 插件。

步骤二：重启 OpenClaw Gateway

插件安装完成后，执行以下命令重启 Gateway：

bash
openclaw gateway restart

重启后，OpenClaw Gateway 才能加载新安装的 VeriAgent 插件。

步骤三：初始化 VeriAgent 插件

执行以下命令启动 VeriAgent 初始化流程：

bash
openclaw veriagent init

初始化完成后，终端会返回 VeriAgent 平台授权地址。

步骤四：打开授权地址

复制终端返回的授权地址，并在浏览器中打开。

完成 Agent 认证

打开终端返回的 VeriAgent 平台授权地址后，请按照 Agent 认证快速开始 中的步骤，完成登录授权、Agent 信息提交、CSR 生成和数字证书申请。

验证结果

完成插件接入并通过 Agent 认证后，你可以通过以下方式确认结果：

  1. 在 VeriAgent 平台中查看当前 Agent 的认证状态和证书信息。

    建议重点确认以下信息：

    信息成功结果
    Agent 状态显示为活跃
    证书状态显示为有效
    证书编号已生成证书编号
    证书有效期已显示证书起止时间
    运行框架显示为 OpenClaw

  2. 回到本地 OpenClaw Agent 目录，确认 VeriAgent 插件和证书文件已生成。

    你也可以执行以下命令查看插件是否已安装：

    bash
    openclaw plugins list

    建议确认以下内容：

    检查项成功结果
    OpenClaw 插件目录包含 VeriAgent 插件
    Agent 目录包含 VeriAgent 文件夹
    VeriAgent 文件夹包含当前 Agent 的证书信息

如果以上信息均正常，说明当前 OpenClaw Agent 已完成 VeriAgent 接入，并具备可信数字身份。