Skip to content

Repository files navigation

1claw OpenClaw Plugin

Star 1clawAI/agent-templates — ready-to-run agent templates wired to 1Claw. It is our single starred repo.

OpenClaw gateway plugin for 1claw.

Repository: github.com/1clawAI/1claw-openclaw-plugin
npm: @1claw/openclaw-plugin
Docs: OpenClaw Plugins · 1claw

OpenClaw agents need vault access, transaction signing, and sometimes an inspected LLM path. Running a separate MCP process works, but this plugin registers 29 native tools inside the gateway itself. Secrets are fetched at runtime. Outbound messages get scanned for leaked values. Optional Shroud routing sends LLM traffic through the TEE proxy when the agent has it enabled.

Install one npm package, set ONECLAW_AGENT_API_KEY, restart the gateway. Your agent gets secrets, signing, env vars, execution bindings, automations, memory, and approvals without extra wiring. Toggle features (redaction, injection, Shroud, slash commands) in plugins.entries.1claw.config.features.


Features

  • Native agent tools — 29 tools for secrets, vaults, policies, sharing, signing keys, multi-chain transactions, execution intents, env vars, automations, memory, and approvals (EVM + Bitcoin, Solana, XRP, Cardano, Tron; optional, configurable)
  • Secrets & vaultsoneclaw_list_secrets, oneclaw_get_secret, oneclaw_put_secret, oneclaw_delete_secret, oneclaw_describe_secret, oneclaw_rotate_and_store, oneclaw_get_env_bundle, oneclaw_create_vault, oneclaw_list_vaults, oneclaw_grant_access, oneclaw_share_secret
  • Env varsoneclaw_resolve_env, oneclaw_list_env_vars, oneclaw_create_env_var
  • Signingoneclaw_provision_signing_key, oneclaw_list_signing_keys, oneclaw_sign_message, oneclaw_sign_typed_data, oneclaw_simulate_transaction, oneclaw_sign_transaction, oneclaw_submit_transaction
  • Execution intentsoneclaw_execute_http, oneclaw_list_bindings
  • Automations & memoryoneclaw_list_automations, oneclaw_trigger_automation, oneclaw_put_memory, oneclaw_get_memory, oneclaw_list_memory
  • Approvalsoneclaw_request_approval for human-in-the-loop policy changes
  • Guardrail governance — Execution intents honor shadow/enforce; guardrail widening requires human policy_change approval (v0.56+)
  • Secret redaction — Scan outbound messages and redact leaked secret values (default on)
  • Secret injection — Replace {{1claw:path/to/secret}} placeholders at prompt time (opt-in)
  • Shroud routing — Route LLM traffic through Shroud TEE when the agent has shroud_enabled (opt-in)
  • Key rotation monitor — Background warnings for secrets expiring within 7 days (opt-in)
  • Slash commands/oneclaw, /oneclaw-list, /oneclaw-rotate, /oneclaw-memory (optional)
  • Gateway RPC1claw.status for programmatic health/status
  • Bundled skill — 1claw skill (skills/1claw/SKILL.md) auto-discovered by OpenClaw

All features are toggled via plugins.entries.1claw.config.features. Auth uses config or env vars.

Platform v0.56+ (HITL, HFA, guardrails)

Capability Plugin behavior
Graduated HITL oneclaw_submit_transaction / sign tools may return awaiting_approval — poll approvals or use dashboard/mobile inbox.
Human Factor Auth N/A for agent keys; treasury HFA is human-only (@1claw/wallet-react).
Guardrail governance Execution intents honor shadow/enforce; widening guardrails requires human policy_change approval.

Pin @1claw/openclaw-plugin@0.57.0 with Vault API / MCP 0.58.0 for full platform parity. For Safe account tools, use @1claw/sdk, @1claw/cli, or @1claw/mcp.


Install

openclaw plugins install @1claw/openclaw-plugin

Or from the repo (e.g. when developing or using as a submodule):

openclaw plugins install -l ./path/to/1claw-openclaw-plugin

Config

Minimal config (config file or env):

{
  plugins: {
    entries: {
      "1claw": {
        enabled: true,
        config: {
          apiKey: "ocv_..."
          // agentId, vaultId, baseUrl, shroudUrl optional
          // features: { tools: true, secretRedaction: true, ... }
        }
      }
    }
  }
}

Env fallback: ONECLAW_AGENT_API_KEY, ONECLAW_AGENT_ID, ONECLAW_VAULT_ID, ONECLAW_BASE_URL, ONECLAW_SHROUD_URL.

Restart the OpenClaw Gateway after changing config.


Tool names

When enabled, tools are registered with a oneclaw_ prefix (e.g. oneclaw_list_secrets, oneclaw_get_secret). Add them to your agent’s tools.allow (e.g. "1claw" or specific names).


Slash commands

Command Description
/oneclaw Connection status, vault info, token TTL, features
/oneclaw-list List secret paths (optional prefix arg)
/oneclaw-rotate Rotate a secret: /oneclaw-rotate <path> <new-value>

Development

npm install
npm run typecheck
  • TypeScript only (no build step required for OpenClaw; jiti loads .ts at runtime).
  • Optional: npm run build to emit dist/ (not required for openclaw plugins install when using source).

As a submodule in 1claw

From the 1claw repo root:

git submodule add https://github.com/1clawAI/1claw-openclaw-plugin.git packages/openclaw-plugin
git submodule update --init --recursive

Clone 1claw with the submodule:

git clone --recurse-submodules https://github.com/1clawAI/1claw.git

License

MIT © 1claw

About

OpenClaw plugin for 1claw — HSM-backed secrets, transaction signing, Shroud TEE

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages