CLI Commands
The vole CLI is the primary interface for managing your OpenVole agent.
TIP
Install globally with npm install -g openvole to use vole directly instead of npx vole.
Agent Commands
vole init
Initialize a new OpenVole project. Creates vole.config.json and the .openvole/ directory structure.
npx vole initvole start
Start the agent in interactive mode with a chat-style CLI. Loads all configured paws, channels, and the dashboard.
npx vole startvole run
Run a single task in headless mode — no dashboard, no channels. Useful for scripting and automation.
npx vole run "summarize my emails"Paw Management
vole paw add
Install a Paw from npm and add it to your config.
npx vole paw add @openvole/paw-telegram
npx vole paw add @openvole/paw-browservole paw remove
Remove an installed Paw.
npx vole paw remove @openvole/paw-telegramvole paw list
List all loaded Paws.
npx vole paw listvole paw create
Scaffold a new Paw project.
npx vole paw create my-custom-pawSkill Management
vole skill add
Add a local skill.
npx vole skill add my-skillvole skill remove
Remove a skill.
npx vole skill remove my-skillvole skill list
List all loaded skills.
npx vole skill listvole skill create
Create a new local skill with a template SKILL.md.
npx vole skill create email-triageClawHub
vole clawhub install
Install a skill from ClawHub.
npx vole clawhub install summarizevole clawhub remove
Remove an installed ClawHub skill.
npx vole clawhub remove summarizevole clawhub search
Search for skills on ClawHub.
npx vole clawhub search emailTool Commands
vole tool list
List all registered tools (from manifests, no paw spawning).
npx vole tool listUse --live to boot the full engine and discover MCP tools:
npx vole tool list --livevole tool call
Call a tool directly without going through the Brain. Useful for debugging.
npx vole tool call list_schedulesUtility Commands
vole upgrade
Upgrade OpenVole and all installed paws to their latest versions.
npx vole upgradevole --version
Show the installed OpenVole version.
npx vole --version