AI Assistant Security For Openclaw Configuration Tool

@omni-shield/openclaw-cli is a command-line tool developed by omni-shield, specifically designed for quickly configuring the AI Assistant Security For Openclaw plugin.

This tool helps users automate the process of logging in, obtaining an API Key, installing the plugin, and updating the OpenClaw configuration file.

Features

• Automated Login Flow: Complete Volcengine account login via browser to automatically obtain an API Key.
• Intelligent Plugin Management: Automatically detect and install/update the @omni-shield/ai-assistant-security-openclaw plugin.
• Automatic Configuration Update: Automatically write the obtained API Key into the OpenClaw configuration file.
• Flexible Installation Detection: Automatically detect OpenClaw's installation method (global or local) and adapt the corresponding commands.

Installation

You can install this tool globally via npm or pnpm:

npm install -g @omni-shield/openclaw-cli
# or
pnpm add -g @omni-shield/openclaw-cli

Or run it directly using npx:

npx @omni-shield/openclaw-cli

Usage

Run the following command in your terminal:

omni-shield-openclaw

Interactive Process

1. Generate Login Link: The tool generates a login URL; copy it to your browser to complete the login.
2. Wait for Callback: After login, the tool automatically detects and retrieves your API Key.
3. Detect OpenClaw: The tool automatically detects OpenClaw's installation method (global or local).
4. Install/Update Plugin: Based on detection results, it automatically installs or updates the security plugin.
5. Configure Plugin: Automatically write the API Key into the OpenClaw configuration file.
6. Complete Configuration: Once configuration is complete, restart OpenClaw to apply changes.

Precautions

1. Login Validity: The login link is valid for 10 minutes; the tool will automatically refresh the link if it expires.
2. OpenClaw Dependency: Ensure OpenClaw is installed (globally or locally) before using this tool.
3. Network Connection: The tool requires a network connection to retrieve login tokens and install plugins.
4. Permission Requirements: Requires permission to execute system commands for installing plugins and modifying configurations.

Troubleshooting

Common Issues

1. Unable to detect OpenClaw:

   • Ensure OpenClaw is correctly installed (globally or locally).
   • For local installations, ensure the tool is run in the correct project directory.

2. Login Failed:

   • Ensure network connection is normal.
   • Ensure login with a valid Volcengine account.

3. Plugin Installation Failed:

   • Check network connection.
   • Ensure OpenClaw version compatibility (>=2026.1.26).

License

ISC