Docs / Getting Started

Quickstart: OpenAI Tools

Route tool calls through Gvner so every execution is approved and logged.

Getting Started Integration Hub Unified HTTP Adapter Agent Governance Evidence Model

One‑command script

curl -sL https://gvner.com/docs/getting-started/openai-tools.sh |   BASE_URL="http://209.46.122.136/api"   TENANT_ID="acme"   TOKEN="<YOUR_TENANT_TOKEN>"   bash

1) Register OpenClaw runtime

curl -s -X POST "$BASE_URL/openclaw/register" \
  -H "X-Tenant-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"tenant_id\":\"$TENANT_ID\",\"runtime_id\":\"openai-tools-01\",\"description\":\"OpenAI tools via OpenClaw\"}" | jq

2) Gate a tool call

curl -s -X POST "$BASE_URL/openclaw/intent" \
  -H "X-Tenant-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"tenant_id\":\"$TENANT_ID\",\"agent_id\":\"openai-tools-01\",\"intent\":\"tool.call\",\"requested_scopes\":[\"tool.call\"],\"tool\":\"openai_tools\",\"context\":{\"source\":\"openai_tools_quickstart\"},\"requested_budget\":5,\"work_type\":\"execution\"}" | jq

3) Export evidence

curl -s "$BASE_URL/evidence/packet?tenant_id=$TENANT_ID&format=pdf" \
  -H "X-Tenant-Token: $TOKEN" -o gvner-evidence.pdf

How to use

1. Register runtime

Bind OpenAI tools to Gvner via OpenClaw.

2. Gate tools

Submit tool intents before execution.

3. Fail closed

On missing/invalid/denied decisions, do not execute tool calls.

4. Export evidence

Generate a regulator‑ready packet.

Key API endpoints

POST /openclaw/register — register runtime

POST /openclaw/intent — gate tool calls

GET /evidence/packet — export evidence packet

Evidence outputs

Tool intent decisions

Evidence packet export