oneclaw

oneclaw

oneclaw creates and applies identity packs for AI systems.

Current provider workflows:

• AgentMail (API-first inbox creation)
• Telegram (BotFather token + getMe verification)
• Bitwarden (signup checkpoint + CLI login verification + vault item seeding)

Current targets:

• owpenbot
• openclaw
• nanoclaw

Install

npm install
npm run build

Default mode: bootstrap TUI

Running oneclaw with no command opens the OpenTUI bootstrap screen by default.

You can also invoke it explicitly:

oneclaw bootstrap --profile default --pack founder

Use --no-tui for plain prompt mode. If OpenTUI runtime bindings are unavailable, oneclaw falls back to plain prompt mode automatically. If you see .scm runtime extension errors, run oneclaw with Bun (bunx oneclaw) or use --no-tui.

Demo autopilot mode

Set ONECLAW_DEMO=1 to run the full bootstrap flow in auto-fill mode.

ONECLAW_DEMO=1 oneclaw

In demo mode, oneclaw animates all fields as if typed, toggles bootstrap flags, and auto-saves into profile demo by default.

First-class config API

printf '%s' "$AGENTMAIL_API_KEY" | oneclaw config set agentmail.api_key --profile default --secret --stdin
printf '%s' "$TELEGRAM_BOT_TOKEN" | oneclaw config set telegram.bot_token --profile default --secret --stdin
oneclaw config set bitwarden.email "[e-mail]" --profile default
printf '%s' "$BITWARDEN_PASSWORD" | oneclaw config set bitwarden.password --profile default --secret --stdin
oneclaw config set bitwarden.signup_done true --profile default

oneclaw config check --providers agentmail,telegram,bitwarden --profile default --verify --json

Other config commands:

oneclaw config get agentmail.api_key --profile default
oneclaw config list --profile default
oneclaw config unset telegram.bot_token --profile default

Provision from config state

oneclaw provision \
  --pack founder \
  --providers agentmail,telegram,bitwarden \
  --targets owpenbot,openclaw,nanoclaw \
  --profile default \
  --non-interactive \
  --json

Flags override stored config values. If a provider still needs human action, oneclaw returns a blocked step with a resume command.

Export / apply

oneclaw export --pack founder --target owpenbot --out ./owpenbot.identity.json
oneclaw export --pack founder --target openclaw --out ./openclaw.identity.json
oneclaw export --pack founder --target nanoclaw --out ./nanoclaw.identity.env

oneclaw apply --pack founder --target owpenbot --path ~/.openwork/owpenbot/owpenbot.json

Helper prompt for another setup AI

oneclaw bootstrap-prompt

This prints the setup-helper prompt you can hand to another AI to collect credentials and persist config state correctly.

Validate and doctor

oneclaw validate --pack founder
oneclaw doctor