███████╗██╗      ██████╗  ██████╗██╗  ██╗    ██╗  ██╗     ██████╗ ██████╗ ███████╗███╗   ██╗ ██████╗██╗      █████╗ ██╗    ██╗
    ██╔════╝██║     ██╔═══██╗██╔════╝██║ ██╔╝    ╚██╗██╔╝    ██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝██║     ██╔══██╗██║    ██║
    █████╗  ██║     ██║   ██║██║     █████╔╝      ╚███╔╝     ██║   ██║██████╔╝█████╗  ██╔██╗ ██║██║     ██║     ███████║██║ █╗ ██║
    ██╔══╝  ██║     ██║   ██║██║     ██╔═██╗      ██╔██╗     ██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██║     ██║     ██╔══██║██║███╗██║
    ██║     ███████╗╚██████╔╝╚██████╗██║  ██╗    ██╔╝ ██╗    ╚██████╔╝██║     ███████╗██║ ╚████║╚██████╗███████╗██║  ██║╚███╔███╔╝
    ╚═╝     ╚══════╝ ╚═════╝  ╚═════╝╚═╝  ╚═╝    ╚═╝  ╚═╝     ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝

    ⚡ Decentralized AI Gateway Provider ⚡           🦞 Your AI, Your Way 🦞

What is This?

This plugin lets you use FLock API Platform as a model provider in OpenClaw (formerly known as Moltbot / Clawdbot).

FLock provides access to various AI models through an OpenAI-compatible API, making it easy to switch between different models without changing your code.

Why Use FLock with OpenClaw?

• Access to multiple AI models through one API
• OpenAI-compatible interface (works seamlessly with OpenClaw)
• Competitive pricing and performance
• Easy API key authentication

Compatibility

| Platform | Version | Status | |----------|---------|--------| | OpenClaw | >= 2026.1.29 | Fully supported (recommended) | | Moltbot | >= 2026.1.0 | Supported via compatibility shim | | Clawdbot | >= 2026.1.0 | Supported via compatibility shim |

As of v2026.1.29, Moltbot/Clawdbot was rebranded to OpenClaw. This plugin supports all three names. The examples below use openclaw commands, but moltbot and clawdbot commands work identically.

Prerequisites

Before you begin, make sure you have:

1. OpenClaw CLI Installed

If you haven't installed OpenClaw yet, follow the official installation guide:

# Recommended: macOS / Linux one-liner
curl -fsSL https://openclaw.ai/install.sh | bash

Or via npm (requires Node.js 22+):

npm install -g openclaw@latest

Note: If you have moltbot installed, you can also upgrade to openclaw:

npm install -g openclaw@latest

Verify installation:

openclaw --version
# Should show: 2026.x.x

If you see zsh: command not found: openclaw:

Option 1: Use the full path

# Find where npm installed it
npm list -g --depth=0

# The bin is usually at:
~/.nvm/versions/node/v22.x.x/bin/openclaw
# or
/usr/local/bin/openclaw

Option 2: Fix your PATH (for nvm users)

# Add to ~/.zshrc or ~/.bashrc:
export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

# Then reload:
source ~/.zshrc

Option 3: Use npx

npx openclaw --version

2. FLock API Key

You need an API key from FLock API Platform:

1. Go to FLock API Platform and create an account
2. Navigate to your API Keys section
3. Generate an API key
4. Keep this key safe - you'll need it during setup!

Installation

Step 1: Install the Plugin

openclaw plugins install flock

You should see output like:

✓ Installed flock

Step 2: Enable the Plugin

openclaw plugins enable flock

Step 3: Verify Installation

Check that the plugin is loaded:

openclaw plugins list

Look for flock in the list with status loaded.

Configuration

Authenticate with FLock

Run the authentication command:

openclaw models auth login --provider flock

You'll be prompted to enter your FLock API key:

◆ FLock API key
│ [paste your API key here]

After successful authentication, you'll see:

✓ FLock API configured at https://api.flock.io/v1.

Your API key is now securely stored in OpenClaw's auth profiles.

Usage

Option 1: Use FLock Model Directly

Specify a FLock model when running OpenClaw:

openclaw agent --model flock/qwen3-30b-a3b-instruct-2507

Option 2: Set as Default Model

Make a FLock model your default:

openclaw config set agents.defaults.model flock/qwen3-30b-a3b-instruct-2507

Then simply run:

openclaw agent

Option 3: Interactive Chat

Start a chat session with a FLock model:

openclaw agent --model flock/qwen3-30b-a3b-instruct-2507 --message "Hello! Tell me about yourself."

Available Models

FLock provides access to various models. Use the format flock/<model-id>:

Reasoning / Thinking Models

| Model ID | Input Price | Output Price | |----------|-------------|--------------| | qwen3-235b-a22b-thinking-2507 | $0.230 / 1M tokens | $2.300 / 1M tokens | | qwen3-235b-a22b-thinking-qwfin | $0.230 / 1M tokens | $2.300 / 1M tokens | | kimi-k2-thinking | $0.600 / 1M tokens | $2.500 / 1M tokens |

Instruct / Chat Models

| Model ID | Input Price | Output Price | |----------|-------------|--------------| | qwen3-30b-a3b-instruct-2507 | $0.200 / 1M tokens | $0.800 / 1M tokens | | qwen3-235b-a22b-instruct-2507 | $0.700 / 1M tokens | $2.800 / 1M tokens | | qwen3-30b-a3b-instruct-qmxai | $0.200 / 1M tokens | $0.800 / 1M tokens | | qwen3-30b-a3b-instruct-coding | $0.200 / 1M tokens | $0.800 / 1M tokens | | qwen3-30b-a3b-instruct-qmini | $0.200 / 1M tokens | $0.800 / 1M tokens |

Other Models

| Model ID | Input Price | Output Price | |----------|-------------|--------------| | deepseek-v3.2 | $0.280 / 1M tokens | $0.420 / 1M tokens | | deepseek-v3.2-dsikh | $0.280 / 1M tokens | $0.420 / 1M tokens | | minimax-m2.1 | $0.300 / 1M tokens | $1.200 / 1M tokens |

Tip: Model availability and pricing may change. Check FLock API Platform for the latest list.

Advanced Configuration

Adding Models to Config

For better autocompletion and model management, add models to your OpenClaw config file (~/.openclaw/config.yaml or ~/.openclaw/openclaw.json):

models:
  providers:
    flock:
      baseUrl: https://api.flock.io/v1
      api: openai-completions
      models:
        # Reasoning models
        - id: qwen3-235b-a22b-thinking-2507
          name: Qwen 3 235B Thinking
          reasoning: true
          input: [text]
          contextWindow: 131072
          maxTokens: 8192
        - id: kimi-k2-thinking
          name: Kimi K2 Thinking
          reasoning: true
          input: [text]
          contextWindow: 131072
          maxTokens: 8192
        # Instruct models
        - id: qwen3-30b-a3b-instruct-2507
          name: Qwen 3 30B Instruct
          input: [text]
          contextWindow: 131072
          maxTokens: 8192
        - id: qwen3-30b-a3b-instruct-coding
          name: Qwen 3 30B Coding
          input: [text]
          contextWindow: 131072
          maxTokens: 8192
        # DeepSeek
        - id: deepseek-v3.2
          name: DeepSeek V3.2
          input: [text]
          contextWindow: 131072
          maxTokens: 8192

Using with Different Channels

FLock works with all OpenClaw channels:

• WhatsApp: Your WhatsApp bot uses FLock models
• Telegram: Telegram bot responses powered by FLock
• Discord: Discord bot with FLock intelligence
• And more!

Troubleshooting

"Provider not found"

Make sure the plugin is enabled:

openclaw plugins enable flock
openclaw plugins list  # Should show flock as "loaded"

"Authentication failed" or 401 Error

Your API key might be invalid or expired:

# Re-run authentication
openclaw models auth login --provider flock

"Model not found" or 404 Error

The model ID might be incorrect:

1. Check the exact model ID in FLock documentation
2. Use the correct format: flock/<model-id>

Check Your Configuration

View current config:

openclaw config get models.providers.flock

View Logs

For detailed debugging:

openclaw doctor

Updating the Plugin

To update to the latest version:

openclaw plugins update flock

Uninstalling

If you need to remove the plugin:

openclaw plugins disable flock

Quick Reference

| Command | Description | |---------|-------------| | openclaw plugins install flock | Install the plugin | | openclaw plugins enable flock | Enable the plugin | | openclaw models auth login --provider flock | Authenticate with FLock | | openclaw agent --model flock/<model-id> | Use a FLock model | | openclaw plugins list | Check plugin status |

Legacy users: Replace openclaw with moltbot or clawdbot if you haven't upgraded yet.

Links

• FLock API Platform: https://platform.flock.io
• FLock API Documentation: https://docs.flock.io/flock-products/api-platform/api-endpoint
• OpenClaw Documentation: https://openclaw.ai
• OpenClaw GitHub: https://github.com/openclaw/openclaw
• This Plugin on npm: https://www.npmjs.com/package/flock

Support

• FLock Issues: Contact FLock support
• Plugin Issues: Open an issue on GitHub
• OpenClaw Issues: OpenClaw GitHub Issues

License

Apache-2.0 - See LICENSE for details.