OneQuery

OneQuery OpenClaw plugin

Audits

Pass

Install

openclaw plugins install clawhub:@onequery/openclaw-plugin

OneQuery OpenClaw Plugin

OpenClaw plugin that bundles a onequery-openclaw skill. The skill teaches the agent to use the onequery CLI directly through OpenClaw's core exec tool instead of registering a separate wrapper tool surface.

Install

This plugin bundles the onequery-openclaw skill. It does not add custom runtime tools or plugin-specific config.

From ClawHub explicitly:

openclaw plugins install clawhub:@onequery/openclaw-plugin
openclaw plugins enable onequery

From npm (OpenClaw also checks ClawHub first for bare package specs):

openclaw plugins install @onequery/openclaw-plugin
openclaw plugins enable onequery

From a checkout of this repository:

bun run --cwd packages/openclaw-plugin build
openclaw plugins install -l ./packages/openclaw-plugin
openclaw plugins enable onequery

If you want to inspect or validate the published package through the separate ClawHub CLI first:

clawhub package inspect @onequery/openclaw-plugin

If your setup persists plugin entries in openclaw.json, make sure the plugin is enabled there too:

{
  plugins: {
    entries: {
      onequery: { enabled: true },
    },
  }
}

Start a new session after enabling the plugin so OpenClaw reloads the bundled skill.

Quick check

onequery auth whoami
onequery org current

Then ask an agent something like:

  • "Use OneQuery to list my org sources."
  • "Use the gg source and get yesterday's DAU."

Publish

GitHub Actions runs a ClawHub dry-run for pull requests that touch this package. Pushing an openclaw-plugin-v*.*.* tag runs the OpenClaw plugin release workflow, which publishes the npm package first and then publishes to the @onequery ClawHub owner. ClawHub publishes need the CLAWHUB_TOKEN repository secret.

Requirements

  • onequery must be installed and available on PATH.
  • The agent needs access to OpenClaw's core exec tool.
  • If your OpenClaw exec policy uses approvals or allowlists, allow the resolved onequery binary or enable skill-bin auto-allow for required skill binaries.

Behavior

  • The plugin adds no custom agent tools and has no plugin-specific runtime config.
  • The bundled onequery-openclaw skill teaches the agent to run onequery ... directly via exec.
  • The skill keeps the same workflow as before: resolve auth and org context, inspect sources, validate unfamiliar SQL first, then execute bounded read-only queries.
  • For quote-heavy or multiline SQL, the skill prefers onequery query ... --file <path> over brittle shell escaping.