flock

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

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

Use FLock API Platform as your AI model gateway in OpenClaw / Moltbot / Clawdbot

---

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: > ``bash > npm install -g openclaw@latest > ``

Verify installation:

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

<details> <summary>Troubleshooting: "command not found"</summary>

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

</details>

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 @openclawd/flock

You should see output like:

✓ Installed @openclawd/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.

---

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:

npm update @openclawd/flock

---

Uninstalling

If you need to remove the plugin:

openclaw plugins disable flock

---

Quick Reference

| Command | Description | |---------|-------------| | npm i @openclawd/flock | Install the plugin via npm | | openclaw plugins install @openclawd/flock | Install the plugin via CLI | | 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.

---

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.

---

Made with ❤️ by <a href="https://flock.io">FLock.io</a>

Summary

Install to Claude Code