FAQ

Questions about how Clawvisor works.

The technical details behind purpose-based authorization, credential vaulting, task lifecycles, self-hosting, and where the project stands today.

Authorization

Purpose-based authorization

What does purpose-based authorization actually mean?

Most systems authorize an agent by identity and a static set of scopes: this token may read email, that key may call this API. Clawvisor authorizes by purpose instead. A task declares what it is trying to accomplish, and the gateway grants only the tool calls that purpose needs, for as long as it needs them. The unit of trust is the task, not the agent.

How is that different from OAuth scopes or API keys?

Scopes and keys are long-lived and coarse. Once an agent holds a Gmail token with send permission, it can send anything, any time, for any reason, including when a prompt injection redirects it. Clawvisor evaluates each call against the approved purpose, so a task approved to draft one reply cannot quietly send fifty.

How does the gateway decide whether a call fits the purpose?

Each incoming tool call is checked against the task's declared intent, your blocked list of services and actions, and a risk score for the action. Low-risk calls that match the purpose flow straight through. Calls that fall outside the purpose, or that score high for blast radius, are blocked or held for human review.

Can a high-risk action be held for a human to approve?

Yes. Actions that need a person are held before the call leaves the gateway, and the agent waits for your decision. Sending an iMessage always requires approval, out-of-scope requests raise a hold rather than failing silently, and you can block any service or action outright.

Do you measure how reliable the intent verification is?

Yes. The intent-verification model runs against an evaluation suite of 179 cases covering benign tasks, scope creep, and adversarial prompts — 249 across all three checks, counting chain-context extraction and task risk scoring. The suites and the latest results ship in the public repo, so you can run them yourself rather than take our word for the numbers.

Credentials

Credential vaulting and injection

Does the agent ever receive the real credential?

No. Real secrets stay in the vault, and the agent is not given a stand-in for them either. It sends the service and action it wants, and Clawvisor attaches the real credential inside the gateway. The credential is never placed in the agent's context, the model prompt, or the response.

Is this vaulting, or just forwarding the request?

Both, deliberately. The vault is where the secret lives at rest, encrypted and out of reach of the agent. The gateway is the enforcement point: every call routes through it, which injects the credential only after the call passes purpose and policy checks. Vaulting without an enforcement point still lets a compromised agent ask for the secret. Forwarding without a vault still leaves the secret reachable. You need both.

Why not just forward the call and skip the vault?

A pure pass-through gateway has to get its upstream credential from somewhere, and if that lives next to the agent it is one prompt injection away from exposure. Holding the secret in the vault means the credential exists in exactly one controlled place, and the agent works entirely through handles it cannot exchange for the underlying secret.

What happens to a credential when a task ends?

The handle the agent was using is revoked with the task. There is nothing for the agent to keep, cache, or replay later, because it never held the credential and the handle no longer resolves.

Who can see the secrets on managed cloud?

On the managed cloud they are stored encrypted and injected at call time; they are never exposed to agents or model context. On self-hosted, the vault runs inside your own network and we never see your traffic at all.

Lifecycle

How tasks work and expire

What is a task?

A task is the authorized unit of work. It carries the declared purpose, the policy decision that approved it, the set of tool calls it is allowed to make, and the human it is tied back to. Every protected tool call belongs to exactly one task.

When does a task expire?

A task ends when its work is done, when it hits its time or call budget, or when someone revokes it. Agents start with zero standing access, so expiry is the normal state. Access exists only while a task is open, and the moment it closes the granted tools are withdrawn.

What happens to access the instant a task expires?

It fails closed. The handles issued for that task stop resolving, so any further call the agent attempts is denied. A task that is over cannot reach what it could reach a moment earlier, even if the agent still tries.

Can a long-running agent keep access alive indefinitely?

No. Standing access is the thing Clawvisor exists to remove. A long-running agent opens a fresh task each time it needs to act, and each task is scoped and bounded on its own, so there is no permanent grant for a compromised loop to ride on.

If a task is compromised mid-flight, what is the blast radius?

At most what that one task was approved to do. Because tools are granted per task and revoked when it ends, a hijacked prompt cannot reach anything the task never needed, and it cannot extend its own lifetime to keep going.

Deployment

Self-hosting and requirements

Can I run Clawvisor entirely myself?

Yes. The gateway source is public and self-hostable. You run it inside your own network, you operate it, and we never see your traffic. It is the same gateway that powers the managed cloud.

What do I need to self-host it?

Somewhere to run the gateway service inside your network, a datastore for the vault and audit log, outbound reach to the tools and APIs your agents call, and an API key for an LLM provider — that key is what powers purpose verification and risk scoring, and setup turns both on once you supply it. The install script drops the daemon in for you, or you build from source, which needs Go 1.25+ and Node.js 18+; the GitHub repo is the canonical setup guide and walks through configuration and connecting your accounts. Point your agent at it with the skill and calls start flowing through it.

Which LLM provider does self-hosting use for those checks?

Yours. You point it at Anthropic, OpenAI, Google Vertex AI, Groq, or a local Ollama model, and a small fast model is plenty — the verifier only sees request metadata, not your data. Chain-context extraction is the one check that is off unless you opt in, because it sends API responses to the model to follow references between calls.

How do agents get pointed at the gateway?

You add a skill that teaches your agent to fetch data through Clawvisor instead of calling services directly, pointed at the gateway on port 25297. There is no SDK and no change to your agent's code. From then on the agent declares a purpose with each request, and the gateway verifies it, injects the real credential from the vault, and logs the call. Your API keys never reach the agent.

What do I give up by self-hosting instead of using cloud?

Less than you might expect. The gateway is the same, and so are purpose verification, risk scoring, the credential vault, and the audit trail — self-hosting gets all of them. What the managed cloud adds is longer log retention, org and team accounts, and removing the operational burden of running, updating, and backing up the service. Self-hosting trades that convenience for full control and isolation.

Do you see my credentials or traffic when I self-host?

No. On self-hosted everything stays in your vault, in your network. We have no visibility into your secrets or your tool calls.

Status

Project status and security roadmap

Is Clawvisor ready to put in front of real agents?

Yes. The core gateway, credential vaulting, per-task containment, and full audit trail are working and in use in front of real agents today. The source is public, so you deploy it today and control your own upgrade cadence.

What does the audit trail cover today?

Every protected tool call records the action, its arguments, the policy decision, and the task that authorized it, replayable and tied back to the human who approved the work. It is a full audit trail of what your agents did and why each call was allowed.

What is the security roadmap from here?

SAML and OIDC single sign-on already ship for Enterprise orgs. The near-term focus is hardening the enforcement path, expanding the evaluation suites, and adding the custom retention and data-residency options that Enterprise teams need. Self-hosting already gives security-sensitive teams full isolation today.

How can I follow along or report an issue?

The source is public, so the fastest way to see what is shipping, raise an issue, or read the code is the repository. The community channel is where issues get answered and releases get discussed.

Go deeper.

Read the code, or ask us anything. The source is public and the docs go deep.