Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw — open-source платформа для создания персонального AI-ассистента, работающего через Telegram, WhatsApp, Discord, Slack и другие мессенджеры. OpenClaw запускает локальный Gateway-сервер, который маршрутизирует сообщения из разных каналов к AI-модели.

​
Требования

​
Настройка подключения к SpeShu.AI

SpeShu.AI подключается к OpenClaw как custom provider через OpenAI-совместимый API.
1

Откройте конфигурацию OpenClaw

Откройте файл конфигурации в текстовом редакторе:
nano ~/.openclaw/openclaw.json
Или используйте встроенные инструменты:
openclaw configure
2

Добавьте провайдер SpeShu.AI

В секции models.providers добавьте провайдер speshu с вашим API-ключом:
{
    models: {
        mode: "merge",
        providers: {
            speshu: {
                baseUrl: "https://speshu.ai/api/v1",
                apiKey: "<ваш API-ключ SpeShu.AI>",
                api: "openai-completions",
                models: [
                    {
                        id: "anthropic/claude-sonnet-4.6",
                        name: "Claude Sonnet 4.6"
                    },
                    {
                        id: "google/gemini-3.1-flash-lite-preview",
                        name: "Gemini 3.1 Flash Lite"
                    },
                    {
                        id: "moonshotai/kimi-k2.5",
                        name: "Kimi K2.5"
                    }
                ]
            }
        }
    }
}
Поле api: "openai-completions" обязательно — без него OpenClaw не сможет определить тип API.
3

Назначьте модель по умолчанию

Укажите модель SpeShu.AI как основную в секции agents.defaults:
{
    agents: {
        defaults: {
            model: {
                primary: "speshu/anthropic/claude-sonnet-4.6"
            },
            models: {
                "speshu/anthropic/claude-sonnet-4.6": {
                    alias: "Claude"
                },
                "speshu/google/gemini-3.1-flash-lite-preview": {
                    alias: "Gemini"
                },
                "speshu/moonshotai/kimi-k2.5": {
                    alias: "Kimi"
                }
            }
        }
    }
}
Формат ссылки на модель: speshu/<model-id>, где speshu — имя провайдера из конфига, а <model-id> — ID модели из списка models.
4

Перезапустите Gateway

Если у вас включён hot reload (по умолчанию), изменения применятся автоматически. Если нет:
openclaw gateway restart

​
Полный пример конфигурации

Готовый ~/.openclaw/openclaw.json с SpeShu.AI и Telegram-каналом: 
{
gateway: {
    port: 18789,
        mode: "local",
        bind: "loopback"
},
models: {
    mode: "merge",
        providers: {
        speshu: {
            baseUrl: "https://speshu.ai/api/v1",
                apiKey: "<ваш API-ключ SpeShu.AI>",
                api: "openai-completions",
                models: [
                {
                    id: "anthropic/claude-sonnet-4.6",
                    name: "Claude Sonnet 4.6"
                },
                {
                    id: "google/gemini-3.1-flash-lite-preview",
                    name: "Gemini 3.1 Flash Lite"
                },
                {
                    id: "moonshotai/kimi-k2.5",
                    name: "Kimi K2.5"
                },
                {
                    id: "z-ai/glm-5-turbo",
                    name: "GLM-5 Turbo"
                },
                {
                    id: "qwen/qwen3-coder-480b-a35b",
                    name: "Qwen3 Coder 480B"
                }
            ]
        }
    }
},
agents: {
    defaults: {
        model: {
            primary: "speshu/anthropic/claude-sonnet-4.6",
                fallbacks: ["speshu/moonshotai/kimi-k2.5"]
        },
        models: {
            "speshu/anthropic/claude-sonnet-4.6": {
                alias: "Claude"
            },
            "speshu/google/gemini-3.1-flash-lite-preview": {
                alias: "Gemini"
            },
            "speshu/moonshotai/kimi-k2.5": {
                alias: "Kimi"
            },
            "speshu/z-ai/glm-5-turbo": {
                alias: "GLM"
            },
            "speshu/qwen/qwen3-coder-480b-a35b": {
                alias: "QwenCoder"
            }
        }
    }
},
channels: {
    telegram: {
        dmPolicy: "allowlist",
            botToken: "<токен бота Telegram>",
            allowFrom: ["<ID аккаунта Telegram>"],
            groupPolicy: "allowlist"
    }
},
plugins: {
    entries: {
        telegram: {
            enabled: true
        }
    }
}
}

​
Переключение моделей

После настройки нескольких моделей вы можете переключаться между ними прямо в чате: 
/model speshu/moonshotai/kimi-k2.5
Или через CLI: 
openclaw models set speshu/qwen/qwen3-coder-480b-a35b
Список доступных моделей: 
openclaw models list

​
Настройка фоллбеков

OpenClaw поддерживает автоматическое переключение на запасную модель при недоступности основной: 
{
agents: {
    defaults: {
        model: {
            primary: "speshu/anthropic/claude-sonnet-4.6",
                fallbacks: [
                "speshu/moonshotai/kimi-k2.5",
                "speshu/google/gemini-3.1-flash-lite-preview"
            ]
        }
    }
}
}

​
Рекомендуемые модели

МодельID в SpeShu.AIДля чего подходит
Claude Sonnet 4.6anthropic/claude-sonnet-4.6Основная рабочая модель: длинные рассуждения, генерация кода, анализ документов, мультиязычные диалоги
Gemini 3.1 Flash Litegoogle/gemini-3.1-flash-lite-previewЭкономичная модель для коротких ответов, суммаризации и простых вопросов
Kimi K2.5moonshotai/kimi-k2.5Кодинг и reasoning-задачи. MoE-архитектура, высокая скорость при низкой стоимости
GLM-5 Turboz-ai/glm-5-turboМультиязычные задачи (CN/EN), обработка длинного контекста, аналитика
Qwen3 Coder 480Bqwen/qwen3-coder-480b-a35bСпециализированная модель для кодинга: 480B параметров, агентские сценарии, контекст до 256K токенов
Актуальный список моделей: /v1/models

​
Использование переменных окружения

Вместо хранения API-ключа в конфиге можно использовать переменную окружения: 
{
env: {
    vars: {
        SPESHU_API_KEY: "<ваш API-ключ>"
    }
},
models: {
    mode: "merge",
        providers: {
        speshu: {
            baseUrl: "https://speshu.ai/api/v1",
                apiKey: "${SPESHU_API_KEY}",
                api: "openai-completions",
                models: [
                { id: "anthropic/claude-sonnet-4.6", name: "Claude Sonnet 4.6" },
                { id: "moonshotai/kimi-k2.5", name: "Kimi K2.5" }
            ]
        }
    }
}
}
Или задайте ключ через .env файл в ~/.openclaw/.env: 
SPESHU_API_KEY=sk-...

​
Решение проблем

  • Проверьте правильность API-ключа SpeShu.AI
  • Убедитесь в наличии средств на балансе
  • Проверьте Base URL: https://speshu.ai/api/v1
Убедитесь, что в конфиге провайдера указано поле api:
speshu: {
baseUrl: "https://speshu.ai/api/v1",
apiKey: "...",
api: "openai-completions",  // ← обязательно
models: [...]
}
  • Проверьте что модель добавлена в models.providers.speshu.models
  • Проверьте что модель есть в agents.defaults.models (это allowlist)
  • Формат ссылки: speshu/<model-id> — например, speshu/anthropic/claude-sonnet-4.6
  • Актуальный список моделей: /v1/models
OpenClaw строго валидирует конфигурацию. Запустите диагностику:
openclaw doctor
openclaw doctor --fix
  • Переключитесь на более быстрые модели: Gemini 3.1 Flash Lite или GLM-5 Turbo
  • Проверьте интернет-соединение
  • Установите streamMode: "partial" в настройках канала для стриминга ответов

​
Поддержка