Skip to content

README.md

Latest commit

 

History

History
374 lines (266 loc) · 11.3 KB

README.md

File metadata and controls

374 lines (266 loc) · 11.3 KB
    ███████╗██╗      ██████╗  ██████╗██╗  ██╗    ██╗  ██╗     ██████╗ ██████╗ ███████╗███╗   ██╗ ██████╗██╗      █████╗ ██╗    ██╗
    ██╔════╝██║     ██╔═══██╗██╔════╝██║ ██╔╝    ╚██╗██╔╝    ██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔════╝██║     ██╔══██╗██║    ██║
    █████╗  ██║     ██║   ██║██║     █████╔╝      ╚███╔╝     ██║   ██║██████╔╝█████╗  ██╔██╗ ██║██║     ██║     ███████║██║ █╗ ██║
    ██╔══╝  ██║     ██║   ██║██║     ██╔═██╗      ██╔██╗     ██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██║     ██║     ██╔══██║██║███╗██║
    ██║     ███████╗╚██████╔╝╚██████╗██║  ██╗    ██╔╝ ██╗    ╚██████╔╝██║     ███████╗██║ ╚████║╚██████╗███████╗██║  ██║╚███╔███╔╝
    ╚═╝     ╚══════╝ ╚═════╝  ╚═════╝╚═╝  ╚═╝    ╚═╝  ╚═╝     ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝

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

npm version License GitHub FLock Platform

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:

npm install -g openclaw@latest

Verify installation:

openclaw --version
# Should show: 2026.x.x
Troubleshooting: "command not found"

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 @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.

Links

Support

License

Apache-2.0 - See LICENSE for details.

Made with ❤️ by FLock.io