veriagent-openclaw

OpenClaw-side local plugin wrapper for VeriAgent onboarding and certificate tools.

What it does

• Starts VeriAgent browser-led onboarding
• Reuses the terminal polling flow implemented in veriagent-nuxt/serve
• Generates local CSR materials
• Downloads and imports certificates
• Exposes local sign and verify commands for agent certificates

Requirements

• Node.js 18 or later
• A reachable VeriAgent backend that exposes the plugin onboarding APIs
• Browser access to the matching VeriAgent portal

Install

Production:

npx -y veriagent-openclaw install

Direct local package path during development:

npx --yes --package file:/absolute/path/to/veriagent-openclaw veriagent-openclaw install

Internal beta registry:

npx -y --registry https://registry-npm.tsign.cn/ veriagent-openclaw install

Entrypoint

node ./scripts/cli.js install

After linking the package bin:

veriagent-openclaw install

Packaging

Plugin CLI 独立打包，不再和 serve 后端一起生成联动发布物。

在插件目录执行：

npm run package:plugin

该命令会在当前目录生成 npm tarball，例如：

veriagent-openclaw-0.1.3.tgz

Publish

Private registry:

cp .npmrc.private.example .npmrc.private.local
npm adduser --userconfig .npmrc.private.local --registry https://registry-npm.tsign.cn/
npm whoami --userconfig .npmrc.private.local --registry https://registry-npm.tsign.cn/
npm version patch
NPM_CONFIG_USERCONFIG=.npmrc.private.local npm run release:plugin:private

Public npmjs:

cp .npmrc.public.example .npmrc.public.local
npm adduser --userconfig .npmrc.public.local --registry https://registry.npmjs.org/
npm whoami --userconfig .npmrc.public.local --registry https://registry.npmjs.org/
npm version patch
NPM_CONFIG_USERCONFIG=.npmrc.public.local npm run release:plugin:public

If you prefer a single active project config, copy one template to .npmrc instead and run the same commands without --userconfig.

Portal routing rules:

• Local file: install returns browser URLs under http://localhost:5174
• Beta install returns browser URLs under https://test-app.veriagent.ai
• Production install returns browser URLs under https://app.veriagent.ai
• Local file: install calls plugin API under http://localhost:6879
• Beta install calls plugin API under https://test-veriagent.tsign.cn
• Production install calls plugin API under https://api.veriagent.ai

Commands

veriagent-openclaw install
veriagent-openclaw status
veriagent-openclaw list-agents
veriagent-openclaw sign <agentId> --text 'hello'
veriagent-openclaw verify <agentId> --text 'hello' --signature '<base64>'
veriagent-openclaw reset

Runtime state

• Default runtime state is stored under ~/.veriagent-plugin/
• To keep runtime files inside a local workspace during development:

VERIAGENT_PLUGIN_HOME=/absolute/path/to/.runtime veriagent-openclaw install

Notes

• The actual onboarding, CSR submission, certificate download, and sign/verify implementation is delegated to:
  • veriagent-nuxt/serve/scripts/agent-plugin-onboarding-simulator.js
• Plugin API is still provided by veriagent-nuxt/serve; the CLI is independently published, but it does not ship a separate backend service
• license remains UNLICENSED in the package metadata; change it only after confirming the intended public license