openclaw/docs/providers/morpheus.md

summary	read_when
Use Morpheus decentralized inference in Clawdbot	You want decentralized AI inference in Clawdbot You want Morpheus API setup guidance

Morpheus Inference API

Morpheus provides decentralized AI inference via the Morpheus Network, offering FREE access to open-source models during Open Beta.

The Morpheus Inference API is a simple, OpenAI-compatible gateway providing users access to the Morpheus Inference Marketplace. Providers host hardware and offer inference, while the API abstracts these efforts for a seamless experience.

Why Morpheus in Clawdbot

• Decentralized inference from the Morpheus Inference Marketplace
• FREE during Open Beta (until 1/31/26)
• 20+ models including Llama, Qwen, DeepSeek, GLM, Kimi, and more
• OpenAI-compatible /v1 endpoints

Features

• OpenAI-compatible API: Standard /v1 endpoints for easy integration
• Streaming: Supported on all models
• Function calling: Supported on most models
• Vision: Supported on select models (e.g., mistral-31-24b)
• Web search: Add :web suffix to any model for web search capabilities

Setup

1. Get API Key

1. Create an account at app.mor.org
2. Click Create API Key and copy it immediately
3. Your API key format: sk-xxxxxxxxxxxxx

2. Configure Clawdbot

Option A: Environment Variable

export MORPHEUS_API_KEY="sk-xxxxxxxxxxxxx"

Option B: Interactive Setup (Recommended)

clawdbot onboard --auth-choice morpheus-api-key

This will:

1. Prompt for your API key (or use existing MORPHEUS_API_KEY)
2. Show all available Morpheus models
3. Let you pick your default model
4. Configure the provider automatically

Option C: Non-interactive

clawdbot onboard --non-interactive \
  --auth-choice morpheus-api-key \
  --morpheus-api-key "sk-xxxxxxxxxxxxx"

3. Verify Setup

clawdbot chat --model morpheus/llama-3.3-70b "Hello, are you working?"

Model Selection

After setup, Clawdbot shows all available Morpheus models. Pick based on your needs:

• Default (our pick): morpheus/llama-3.3-70b for reliable, balanced performance
• Best for coding: morpheus/qwen3-coder-480b-a35b-instruct with 256K context
• Best for reasoning: morpheus/kimi-k2-thinking for deep analysis
• Fastest: morpheus/llama-3.2-3b for low-latency responses

Change your default model anytime:

clawdbot models set morpheus/llama-3.3-70b
clawdbot models set morpheus/kimi-k2-thinking

List all available models:

clawdbot models list | grep morpheus

Available Models

Flagship Models

Model ID	Name	Context	Best For
qwen3-coder-480b-a35b-instruct	Qwen3 Coder 480B	256K	Code generation
hermes-3-llama-3.1-405b	Hermes 3 Llama 405B	128K	General purpose
gpt-oss-120b	GPT OSS 120B	128K	GPT-style responses

Reasoning Models

Model ID	Name	Context	Best For
kimi-k2-thinking	Kimi K2 Thinking	256K	Deep reasoning, math, coding
glm-4.7-thinking	GLM 4.7 Thinking	198K	Extended thinking
glm-4.7	GLM 4.7	198K	Reasoning, multilingual
qwen3-235b	Qwen3 235B	128K	Complex reasoning

Mid-Size Models

Model ID	Name	Context	Best For
llama-3.3-70b	Llama 3.3 70B	128K	General purpose
qwen3-next-80b	Qwen3 Next 80B	256K	Long context
mistral-31-24b	Mistral 31 24B	128K	Fast, vision
venice-uncensored	Venice Uncensored	32K	Uncensored, creative
hermes-4-14b	Hermes 4 14B	128K	Efficient

Fast Models

Model ID	Name	Context	Best For
llama-3.2-3b	Llama 3.2 3B	128K	Fastest responses
qwen3-4b	Qwen3 4B	32K	Lightweight, reasoning

Web-Enabled Models

Add :web suffix to any model for web search:

• llama-3.3-70b:web
• kimi-k2-thinking:web
• qwen3-coder-480b-a35b-instruct:web

Model Discovery

Clawdbot automatically discovers models from the Morpheus API when MORPHEUS_API_KEY is set. If the API is unreachable, it falls back to a static catalog.

Streaming & Tool Support

Feature	Support
Streaming	All models
Function calling	Most models
Vision/Images	mistral-31-24b
JSON mode	Supported via response_format

Pricing

Morpheus is FREE during Open Beta (until 1/31/26). Billing infrastructure will be implemented soon.

Config File Example

{
  env: { MORPHEUS_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "morpheus/llama-3.3-70b" } } },
  models: {
    mode: "merge",
    providers: {
      morpheus: {
        baseUrl: "https://api.mor.org/api/v1",
        apiKey: "${MORPHEUS_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "llama-3.3-70b",
            name: "Llama 3.3 70B",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

Usage Examples

# Use default model
clawdbot chat --model morpheus/llama-3.3-70b

# Use coding model
clawdbot chat --model morpheus/qwen3-coder-480b-a35b-instruct

# Use reasoning model
clawdbot chat --model morpheus/kimi-k2-thinking

# Use with web search
clawdbot chat --model morpheus/llama-3.3-70b:web

Troubleshooting

API key not recognized

echo $MORPHEUS_API_KEY
clawdbot models list | grep morpheus

Ensure the key starts with sk-.

Model not available

Model availability depends on active providers in the Morpheus marketplace. Run clawdbot models list to see currently available models.

Connection issues

Morpheus API is at https://api.mor.org/api/v1. Ensure your network allows HTTPS connections.

Links

• Morpheus API Docs
• Morpheus App
• Morpheus Discord
• Morpheus Twitter