Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Securely interact with Bitwarden password manager via the bw CLI. Covers authentication (login/unlock/logout), vault operations (list/get/create/edit/delete...
Securely interact with Bitwarden password manager via the bw CLI. Covers authentication (login/unlock/logout), vault operations (list/get/create/edit/delete...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Complete reference for interacting with Bitwarden via the command-line interface. Official documentation: https://bitwarden.com/help/cli/ Markdown version (for agents): https://bitwarden.com/help/cli.md
# Native executable (recommended) # https://bitwarden.com/download/?app=cli # npm npm install -g @bitwarden/cli # Linux package managers choco install bitwarden-cli # Windows via Chocolatey snap install bw # Linux via Snap
Standard-Workflow (unlock-first): # 1. Try unlock first (fast, most common case) export BW_SESSION=$(bw unlock --passwordenv BW_PASSWORD --raw 2>/dev/null) # 2. Only if unlock fails, fall back to login if [ -z "$BW_SESSION" ]; then bw login "$BW_EMAIL" "$BW_PASSWORD" export BW_SESSION=$(bw unlock --passwordenv BW_PASSWORD --raw) fi # 3. Sync before any vault operation bw sync # 4. End session bw lock # Lock (keep login) bw logout # Complete logout Alternative: Direct login methods bw login # Interactive login (email + password) bw login --apikey # API key login (uses BW_CLIENTID/BW_CLIENTSECRET from .secrets) bw login --sso # SSO login bw unlock # Interactive unlock bw unlock --passwordenv BW_PASSWORD # Auto-available from sourced .secrets
Check authentication and vault status: bw status Returns: unauthenticated, locked, or unlocked.
Configure CLI settings: # Set server (self-hosted or regional) bw config server https://vault.example.com bw config server https://vault.bitwarden.eu # EU cloud bw config server # Check current # Individual service URLs bw config server --web-vault <url> --api <url> --identity <url>
Sync local vault with server (always run before vault operations): bw sync # Full sync bw sync --last # Show last sync timestamp
Check for updates (does not auto-install): bw update
Start REST API server: bw serve --port 8087 --hostname localhost
List vault objects: # Items bw list items bw list items --search github bw list items --folderid <id> --collectionid <id> bw list items --url https://example.com bw list items --trash # Items in trash # Folders bw list folders # Collections bw list collections # All collections bw list org-collections --organizationid <id> # Org collections # Organizations bw list organizations bw list org-members --organizationid <id>
Retrieve single values or items: # Get specific fields (by name or ID) bw get password "GitHub" bw get username "GitHub" bw get totp "GitHub" # 2FA code bw get notes "GitHub" bw get uri "GitHub" # Get full item JSON bw get item "GitHub" bw get item <uuid> --pretty # Other objects bw get folder <id> bw get collection <id> bw get organization <id> bw get org-collection <id> --organizationid <id> # Templates for create operations bw get template item bw get template item.login bw get template item.card bw get template item.identity bw get template item.securenote bw get template folder bw get template collection bw get template item-collections # Security bw get fingerprint <user-id> bw get fingerprint me bw get exposed <password> # Check if password is breached # Attachments bw get attachment <filename> --itemid <id> --output /path/
Create new objects: # Create folder bw get template folder | jq '.name="Work"' | bw encode | bw create folder # Create login item bw get template item | jq \ '.name="Service" | .login=$(bw get template item.login | jq '.username="user@example.com" | .password="secret"')' \ | bw encode | bw create item # Create secure note (type=2) bw get template item | jq \ '.type=2 | .secureNote.type=0 | .name="Note" | .notes="Content"' \ | bw encode | bw create item # Create card (type=3) bw get template item | jq \ '.type=3 | .name="My Card" | .card=$(bw get template item.card | jq '.number="4111..."')' \ | bw encode | bw create item # Create identity (type=4) bw get template item | jq \ '.type=4 | .name="My Identity" | .identity=$(bw get template item.identity)' \ | bw encode | bw create item # Create SSH key (type=5) bw get template item | jq \ '.type=5 | .name="My SSH Key"' \ | bw encode | bw create item # Attach file to existing item bw create attachment --file ./doc.pdf --itemid <uuid> Item types: 1=Login, 2=Secure Note, 3=Card, 4=Identity, 5=SSH Key.
Modify existing objects: # Edit item bw get item <id> | jq '.login.password="newpass"' | bw encode | bw edit item <id> # Edit folder bw get folder <id> | jq '.name="New Name"' | bw encode | bw edit folder <id> # Edit item collections echo '["collection-uuid"]' | bw encode | bw edit item-collections <item-id> --organizationid <id> # Edit org collection bw get org-collection <id> --organizationid <id> | jq '.name="New Name"' | bw encode | bw edit org-collection <id> --organizationid <id>
Remove objects: # Send to trash (recoverable 30 days) bw delete item <id> bw delete folder <id> bw delete attachment <id> --itemid <id> bw delete org-collection <id> --organizationid <id> # Permanent delete (irreversible!) bw delete item <id> --permanent
Recover from trash: bw restore item <id>
Generate passwords or passphrases: # Password (default: 14 chars) bw generate bw generate --uppercase --lowercase --number --special --length 20 bw generate -ulns --length 32 # Passphrase bw generate --passphrase --words 4 --separator "-" --capitalize --includeNumber
Create ephemeral shares: # Text Send bw send -n "Secret" -d 7 --hidden "This text vanishes in 7 days" # File Send bw send -n "Doc" -d 14 -f /path/to/file.pdf # Advanced options bw send --password accesspass -f file.txt
Access received Sends: bw receive <url> --password <pass>
Share items to organization: echo '["collection-uuid"]' | bw encode | bw move <item-id> <organization-id>
Confirm invited members: bw get fingerprint <user-id> bw confirm org-member <user-id> --organizationid <id>
Manage device approvals: bw device-approval list --organizationid <id> bw device-approval approve <request-id> --organizationid <id> bw device-approval approve-all --organizationid <id> bw device-approval deny <request-id> --organizationid <id> bw device-approval deny-all --organizationid <id>
Import from other password managers: bw import --formats # List supported formats bw import lastpasscsv ./export.csv bw import bitwardencsv ./import.csv --organizationid <id>
Export vault data: bw export # CSV format bw export --format json bw export --format encrypted_json bw export --format encrypted_json --password <custom-pass> bw export --format zip # Includes attachments bw export --output /path/ --raw # Output to file or stdout bw export --organizationid <id> --format json
Base64 encode JSON for create/edit operations: bw get template folder | jq '.name="Test"' | bw encode | bw create folder
See Password Generation.
Available on all commands: --pretty # Format JSON output with tabs --raw # Return raw output --response # JSON formatted response --quiet # No stdout (use for piping secrets) --nointeraction # Don't prompt for input --session <key> # Pass session key directly --version # CLI version --help # Command help
Store the master password in a .secrets file in the workspace root and auto-load it: # Create .secrets file mkdir -p ~/.openclaw/workspace echo "BW_PASSWORD=your_master_password" > ~/.openclaw/workspace/.secrets chmod 600 ~/.openclaw/workspace/.secrets # Add to .gitignore echo ".secrets" >> ~/.openclaw/workspace/.gitignore # Auto-source in shell config (run once) echo 'source ~/.openclaw/workspace/.secrets 2>/dev/null' >> ~/.bashrc # OR for zsh: echo 'source ~/.openclaw/workspace/.secrets 2>/dev/null' >> ~/.zshrc Now BW_PASSWORD is always available: bw unlock --passwordenv BW_PASSWORD Security requirements: File must be mode 600 (user read/write only) Must add .secrets to .gitignore Never commit the .secrets file Auto-sourcing happens on new shell sessions; run source ~/.openclaw/workspace/.secrets for current session
For automated/API key login, store credentials in the same .secrets file: # Add API credentials to .secrets echo "BW_CLIENTID=user.xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" >> ~/.openclaw/workspace/.secrets echo "BW_CLIENTSECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" >> ~/.openclaw/workspace/.secrets chmod 600 ~/.openclaw/workspace/.secrets Login with API key: bw login --apikey โ ๏ธ Known Issue / Workaround On some self-hosted Vaultwarden instances, bw login --apikey may fail with: User Decryption Options are required for client initialization Workaround - Use Email/Password Login: # Add EMAIL to .secrets echo "BW_EMAIL=your@email.com" >> ~/.openclaw/workspace/.secrets # Login with email + password (instead of --apikey) bw login "$BW_EMAIL" "$BW_PASSWORD" # Or as one-liner set -a && source ~/.openclaw/workspace/.secrets && set +a && bw login "$BW_EMAIL" "$BW_PASSWORD" # Then unlock as usual bw unlock --passwordenv BW_PASSWORD Full workflow (recommended for self-hosted): # Source the .secrets file set -a && source ~/.openclaw/workspace/.secrets && set +a # Try unlock first (faster, works if already logged in) export BW_SESSION=$(bw unlock --passwordenv BW_PASSWORD --raw 2>/dev/null) # Only login if unlock failed (vault not initialized) if [ -z "$BW_SESSION" ]; then bw login "$BW_EMAIL" "$BW_PASSWORD" export BW_SESSION=$(bw unlock --passwordenv BW_PASSWORD --raw) fi # Ready to use bw sync bw list items Get your API key: https://bitwarden.com/help/personal-api-key/
BW_CLIENTID # API key client_id BW_CLIENTSECRET # API key client_secret BW_PASSWORD # Master password for unlock BW_SESSION # Session key (auto-used by CLI) BITWARDENCLI_DEBUG=true # Enable debug output NODE_EXTRA_CA_CERTS # Self-signed certs path BITWARDENCLI_APPDATA_DIR # Custom config directory
Method values: 0=Authenticator, 1=Email, 3=YubiKey. bw login user@example.com password --method 0 --code 123456
Values: 0=Domain, 1=Host, 2=Starts With, 3=Exact, 4=Regex, 5=Never.
Values: 0=Text, 1=Hidden, 2=Boolean.
0=Owner, 1=Admin, 2=User, 3=Manager, 4=Custom.
0=Invited, 1=Accepted, 2=Confirmed, -1=Revoked.
Unlock first, login only if needed: Try bw unlock first as it's faster; only run bw login if unlock fails (vault not initialized) Always sync: Run bw sync before any vault operation Secure session: Use bw lock when done Protect secrets: Never log BW_SESSION or BW_PASSWORD Secure storage: Keep .secrets file at mode 600, never commit it Auto-source: Add to ~/.bashrc or ~/.zshrc for persistent env vars Verify fingerprints: Before confirming org members
IssueSolution"Bot detected"Use --apikey or provide client_secret"Vault is locked"Run bw unlock and export BW_SESSIONSelf-signed cert errorSet NODE_EXTRA_CA_CERTSNeed debug infoexport BITWARDENCLI_DEBUG=true References: HTML documentation: https://bitwarden.com/help/cli/ Markdown (fetchable): https://bitwarden.com/help/cli.md Personal API Key: https://bitwarden.com/help/personal-api-key/
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.