Agent 认证快速开始

本文介绍如何通过一行 npx 命令，为 OpenClaw 或 Hermes Agent 启动 VeriAgent 认证流程，并在 VeriAgent 平台中完成 Agent 信息提交、数字证书申请和认证结果查看。

完成认证后，你可以在 VeriAgent 平台中查看 Agent 的认证状态、证书状态、证书编号和有效期，并基于该可信数字身份继续使用 Skill 签名、验签或信任管理能力。

前置条件

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

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

通过 npx 启动 Agent 认证

若要为 OpenClaw 或 Hermes Agent 启动认证流程，请按照以下步骤操作：

1. 打开终端。

2. 执行以下命令：

   bashCopy

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

3. 根据终端提示选择或确认需要认证的 Agent 类型，例如 OpenClaw 或 Hermes Agent。

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

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

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

在平台中完成认证

打开终端返回的 VeriAgent 平台链接后，请按照以下步骤完成 Agent 认证。

步骤一：登录并授权

1. 在浏览器中打开终端返回的授权链接。

2. 如果当前账号未登录，请根据页面提示登录 VeriAgent 平台。

3. 登录后，进入 应用授权 页面。

4. 确认授权主体和授权范围。

5. 勾选相关协议，单击 登录并授权。

注意：授权不等同于完成 Agent 认证。后续还需要填写 Agent 身份信息、确认责任声明，并完成数字证书申请。

步骤二：开始认证

1. 授权完成后，进入 认证智能体 页面。

2. 确认页面已识别当前 Agent 环境。

3. 单击 开始认证。

如果页面没有识别到当前环境，请回到终端检查命令是否执行完成，并确认终端中没有报错。

步骤三：填写 Agent 身份信息

根据页面提示填写或确认以下信息：

填写完成后：

1. 勾选责任声明。
2. 单击 提交信息。

步骤四：等待生成 CSR

提交 Agent 身份信息后，页面会进入等待生成 CSR 的状态。

CSR 是申请数字证书时使用的证书签名请求。在该过程中，本地 VeriAgent 插件会配合平台生成并提交 CSR。

等待过程中，请保持：

• 终端继续运行。
• 浏览器页面不要关闭。
• 网络连接正常。

注意：如果页面长时间停留在等待生成 CSR 的状态，请优先查看终端是否有报错信息。

步骤五：申请数字证书

CSR 生成完成后，页面会进入 申请数字证书 步骤。

1. 单击 去认证。
2. 根据页面提示选择认证方式，例如短信、密码或人脸认证。
3. 按提示完成认证。
4. 勾选相关协议。
5. 单击 确认。

认证通过后，平台会为当前 Agent 签发 X.509 数字证书。页面提示证书申请成功，即表示签发完成。

验证结果

完成认证后，你可以通过以下方式确认 Agent 是否认证成功：

1. 返回 VeriAgent 平台。

2. 进入 Agent 管理或认证结果页面。

3. 查看当前 Agent 的认证状态和证书信息。

建议重点确认以下信息：

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

   建议确认以下内容：

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

如果认证成功，当前 Agent 即具备 VeriAgent 可信数字身份，可继续用于后续 Skill 签名、验签或信任管理场景。