Skip to content

vox-openclaw-runtime API Reference (generated)

Crate: vox-openclaw-runtime · Version: 0.6.0 · Target: Library (lib.rs)

OpenClaw client + ARS runtime adapter, executor, context bundles, hooks. Extracted from vox-skills::ars_shim.

vox-openclaw-runtime — Agent Runtime System (ARS)

Section titled “vox-openclaw-runtime — Agent Runtime System (ARS)”

Sandbox isolation, trust classification, OpenClaw skill marketplace integration, runtime context bundles, hook registry, and the lightweight task executor used by vox skill eval.

Extracted from vox-skills::ars_shim (now retired). Consumers that previously imported vox_skills::ars_shim::* or vox_ars::* should import from vox_openclaw_runtime::*.

DependencyKind
vox-configNormal
vox-dbNormal
vox-http-clientNormal
vox-plugin-hostNormal
vox-secretsNormal
ModuleDescription
context—
domain—
executor—
hermes_adapter—
hooks—
manifest—
openclaw—
openclaw_adapter—
openclaw_discovery—
openclaw_gateway_ws—
openclaw_protocol—
runtime—
parserRe-export parse_skill_md under a parser namespace for legacy callers that imported it as vox_ars::parser::parse_skill_md.
Dependency Topology, diagram 111 nodes, 10 edges: vox-openclaw-runtime → vox-config; vox-openclaw-runtime → vox-db; vox-openclaw-runtime → vox-http-client; vox-openclaw-runtime → vox-plugin-host; vox-openclaw-runtime → vox-secrets; vox-actor-runtime → vox-openclaw-runtime; vox-cli → vox-openclaw-runtime; vox-cli-research → vox-…vox-openclaw-runtimevox-configvox-dbvox-http-clientvox-plugin-hostvox-secretsvox-actor-runtimevox-clivox-cli-researchvox-orchestrator-mcpvox-skills
Diagram source
graph {
direction: right
node vox_openclaw_runtime: "vox-openclaw-runtime"
node vox_config: "vox-config"
vox_openclaw_runtime -> vox_config
node vox_db: "vox-db"
vox_openclaw_runtime -> vox_db
node vox_http_client: "vox-http-client"
vox_openclaw_runtime -> vox_http_client
node vox_plugin_host: "vox-plugin-host"
vox_openclaw_runtime -> vox_plugin_host
node vox_secrets: "vox-secrets"
vox_openclaw_runtime -> vox_secrets
node vox_actor_runtime: "vox-actor-runtime"
vox_actor_runtime -> vox_openclaw_runtime
node vox_cli: "vox-cli"
vox_cli -> vox_openclaw_runtime
node vox_cli_research: "vox-cli-research"
vox_cli_research -> vox_openclaw_runtime
node vox_orchestrator_mcp: "vox-orchestrator-mcp"
vox_orchestrator_mcp -> vox_openclaw_runtime
node vox_skills: "vox-skills"
vox_skills -> vox_openclaw_runtime
}
Consumer CrateRole
vox-actor-runtimeDirect workspace dependent
vox-cliDirect workspace dependent
vox-cli-researchDirect workspace dependent
vox-orchestrator-mcpDirect workspace dependent
vox-skillsDirect workspace dependent
KindSymbolSignatureSourceDescription
enumcontext::RetrievalTierpub enum RetrievalTiercrates/vox-openclaw-runtime/src/context.rs#L9-L17Named retrieval depth presets.
fncontext::parsepub fn parse(s: &str) -> Option<Self>crates/vox-openclaw-runtime/src/context.rs#L21-L28Parse CLI tier string (shallow, standard, deep).
structcontext::ContextPolicypub struct ContextPolicycrates/vox-openclaw-runtime/src/context.rs#L33-L38Policy controlling how many items are pulled into a bundle.
structcontext::ArsContextBundlepub struct ArsContextBundlecrates/vox-openclaw-runtime/src/context.rs#L51-L58Assembled context for prompting or inspection.
fncontext::assemble_bundlepub fn assemble_bundle(crates/vox-openclaw-runtime/src/context.rs#L61Merge sources into a bundle honoring policy.max_items.
structdomain::ArsSkillpub struct ArsSkillcrates/vox-openclaw-runtime/src/domain.rs#L10-L39Skill payload used by [crate::runtime::ArsRuntime] (distinct from OpenClaw list/import DTOs).
fndomain::requires_approvalpub fn requires_approval(&self) -> boolcrates/vox-openclaw-runtime/src/domain.rs#L44-L46Returns true if this skill requires an explicit operator approval before execution is permitted.
fndomain::requires_containerpub fn requires_container(&self) -> boolcrates/vox-openclaw-runtime/src/domain.rs#L49-L52Returns true if this skill must execute inside the container sandbox.
enumexecutor::ExecutorErrorpub enum ExecutorErrorcrates/vox-openclaw-runtime/src/executor.rs#L9-L13Errors from the lightweight task executor.
fnexecutor::execute_vox_taskpub async fn execute_vox_task(crates/vox-openclaw-runtime/src/executor.rs#L19Run a user-supplied task body with JSON input under advisory limits. Current behavior: returns a structured envelope with input echo and body statistics. A full workflow VM may replace this without changing the CLI signature.
structhermes_adapter::DefaultHermesRuntimeAdapterpub struct DefaultHermesRuntimeAdaptercrates/vox-openclaw-runtime/src/hermes_adapter.rs#L23-L26—
fnhermes_adapter::newpub fn new(cfg: AgentRuntimeConfig) -> Selfcrates/vox-openclaw-runtime/src/hermes_adapter.rs#L29-L34—
structhooks::HookRegistrypub struct HookRegistrycrates/vox-openclaw-runtime/src/hooks.rs#L7-L9Lightweight hook registry (extensible without breaking callers).
fnhooks::newpub fn new() -> Selfcrates/vox-openclaw-runtime/src/hooks.rs#L13-L17Create an empty registry.
structmanifest::ResourceLimitspub struct ResourceLimitscrates/vox-openclaw-runtime/src/manifest.rs#L7-L21Advisory resource envelope for sandboxed task execution.
enummanifest::NetworkPolicypub enum NetworkPolicycrates/vox-openclaw-runtime/src/manifest.rs#L46-L54Network access policy for sandboxed skill execution.
fnmanifest::docker_flagpub fn docker_flag(&self) -> &'static strcrates/vox-openclaw-runtime/src/manifest.rs#L58-L64Return the --network flag value for Docker/Podman.
enummanifest::SkillKindpub enum SkillKindcrates/vox-openclaw-runtime/src/manifest.rs#L70-L78High-level skill classification for the runtime harness.
enummanifest::TrustLevelpub enum TrustLevelcrates/vox-openclaw-runtime/src/manifest.rs#L86-L96Trust classification for a skill. Determines the minimum required isolation tier and whether an explicit operator approval is needed before the skill may execute.
fnmanifest::requires_approvalpub fn requires_approval(&self) -> boolcrates/vox-openclaw-runtime/src/manifest.rs#L100-L102Returns true if this trust level requires a pre-execution approval check.
fnmanifest::minimum_isolationpub fn minimum_isolation(&self) -> &'static strcrates/vox-openclaw-runtime/src/manifest.rs#L105-L110Returns the minimum required isolation tier for this trust level.
structopenclaw::OpenClawRemoteConfigpub struct OpenClawRemoteConfigcrates/vox-openclaw-runtime/src/openclaw.rs#L13-L20Remote gateway configuration.
structopenclaw::OpenClawSkillSpecpub struct OpenClawSkillSpeccrates/vox-openclaw-runtime/src/openclaw.rs#L24-L31Skill summary returned by [OpenClawClient::list_skills].
enumopenclaw::OpenClawErrorpub enum OpenClawErrorcrates/vox-openclaw-runtime/src/openclaw.rs#L35-L48Wire-level errors.
structopenclaw::PublishResultpub struct PublishResultcrates/vox-openclaw-runtime/src/openclaw.rs#L52-L60Result returned by [OpenClawClient::publish_skill].
structopenclaw::OpenClawClientpub struct OpenClawClientcrates/vox-openclaw-runtime/src/openclaw.rs#L63-L67Client for OpenClaw-compatible HTTP APIs.
fnopenclaw::newpub fn new(cfg: OpenClawRemoteConfig) -> Result<Self, OpenClawError>crates/vox-openclaw-runtime/src/openclaw.rs#L71-L83Build a client from configuration.
fnopenclaw::list_skillspub async fn list_skills(&self) -> Result<Vec<OpenClawSkillSpec>, OpenClawError>crates/vox-openclaw-runtime/src/openclaw.rs#L103-L120List published skills (GET /v1/skills).
fnopenclaw::import_skillpub async fn import_skill(&self, slug: &str) -> Result<ArsSkill, OpenClawError>crates/vox-openclaw-runtime/src/openclaw.rs#L123-L141Fetch a skill as [ArsSkill] metadata (GET /v1/skills/{slug}).
fnopenclaw::import_and_installpub async fn import_and_install(crates/vox-openclaw-runtime/src/openclaw.rs#L144Download SKILL.md text and install into registry.
fnopenclaw::publish_skillpub async fn publish_skill(crates/vox-openclaw-runtime/src/openclaw.rs#L163Publish a Vox skill to an OpenClaw gateway. skill_md should be the AgentSkills-compliant SKILL.md content (top-level name + description, Vox extensions under metadata.vox-*). Returns the gateway-assigned slug and canonical URL on success.
enumopenclaw_adapter::AgentProviderpub enum AgentProvidercrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L14-L17—
structopenclaw_adapter::AgentRuntimeConfigpub struct AgentRuntimeConfigcrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L20-L26—
structopenclaw_adapter::OpenClawAdapterConfigpub struct OpenClawAdapterConfigcrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L30-L35Adapter-level configuration.
structopenclaw_adapter::OpenClawConnectionOverridespub struct OpenClawConnectionOverridescrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L51-L56Optional overrides when resolving OpenClaw adapter connection settings.
fnopenclaw_adapter::from_env_defaultspub fn from_env_defaults() -> Selfcrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L59-L81—
fnopenclaw_adapter::adapter_config_with_token_overridepub fn adapter_config_with_token_override(explicit_token: Option<String>) -> OpenClawAdapterConfigcrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L91-L104Build adapter config using environment defaults with optional explicit token override. Token precedence: 1) explicit_token when provided and non-empty 2) VOX_OPENCLAW_TOKEN from environment 3) no token
fnopenclaw_adapter::resolve_adapter_configpub async fn resolve_adapter_config(crates/vox-openclaw-runtime/src/openclaw_adapter.rs#L107Resolve OpenClaw adapter config using well-known discovery + precedence rules.
enumopenclaw_adapter::OpenClawAdapterErrorpub enum OpenClawAdapterErrorcrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L140-L147—
traitopenclaw_adapter::AgentRuntimeAdapterpub trait AgentRuntimeAdapter: Sendcrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L163-L179Common OpenClaw/Hermes operation surface used by CLI, runtime, and MCP integrations.
structopenclaw_adapter::DefaultOpenClawRuntimeAdapterpub struct DefaultOpenClawRuntimeAdaptercrates/vox-openclaw-runtime/src/openclaw_adapter.rs#L184-L187Default adapter implementation that composes existing HTTP skill APIs and WS control plane calls.
fnopenclaw_adapter::connectpub async fn connect(cfg: OpenClawAdapterConfig) -> Result<Self, OpenClawAdapterError>crates/vox-openclaw-runtime/src/openclaw_adapter.rs#L190-L203—
fnopenclaw_adapter::connect_default_runtime_adapterpub async fn connect_default_runtime_adapter(crates/vox-openclaw-runtime/src/openclaw_adapter.rs#L207Canonical runtime/MCP connection entrypoint for OpenClaw adapter setup.
fnopenclaw_adapter::connect_runtime_adapter_with_overridespub async fn connect_runtime_adapter_with_overrides(crates/vox-openclaw-runtime/src/openclaw_adapter.rs#L219Runtime adapter connect entrypoint that supports explicit URL/well-known overrides.
structopenclaw_discovery::OpenClawDiscoveryOverridespub struct OpenClawDiscoveryOverridescrates/vox-openclaw-runtime/src/openclaw_discovery.rs#L15-L19Optional override knobs for discovery resolution.