SimpleClaw

Руководства

Подключить Codex

Проверка совместимости SimpleClaw с агентом Codex и безопасная конфигурация после появления Responses API.

Статус совместимости

SimpleClaw поддерживает OpenAI Responses-совместимый endpoint POST /v1/responses для Codex. Он принимает текстовые сообщения, function tools и результаты локальных инструментов, а при stream: true отдаёт завершающий набор response.* SSE-событий после учёта usage.

Это stateless transport: передавайте актуальную историю в input. previous_response_id, hosted tools, изображения и файлы пока не поддерживаются — сервис не сохраняет prompt или output в БД.

Изолированная конфигурация

Создайте отдельный API-ключ в кабинете и возьмите точный публичный ID включённой модели из каталога. Замените первые две строки ниже своими значениями, целиком скопируйте блок в терминал и выполните его. Скрипт сам создаст конфигурацию и launcher; ключ остаётся только в текущей оболочке и не записывается на диск.

# Замените значения в этих двух строках перед запуском.
SIMPLECLAW_API_KEY='sc_your_key'
SIMPLECLAW_MODEL='your-model-id'

mkdir -p "$HOME/.codex-simpleclaw" "$HOME/.local/bin"

cat > "$HOME/.codex-simpleclaw/config.toml" <<EOF
model_provider = "simpleclaw"
model = "$SIMPLECLAW_MODEL"

[model_providers.simpleclaw]
name = "SimpleClaw"
base_url = "https://simple-claw.ru/v1"
env_key = "SIMPLECLAW_API_KEY"
wire_api = "responses"
EOF

cat > "$HOME/.local/bin/codex-simpleclaw" <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

: "${SIMPLECLAW_API_KEY:?Задайте SIMPLECLAW_API_KEY перед запуском Codex}"
export CODEX_HOME="$HOME/.codex-simpleclaw"
exec codex "$@"
EOF

chmod +x "$HOME/.local/bin/codex-simpleclaw"
export SIMPLECLAW_API_KEY
printf '\nГотово. Запустите: $HOME/.local/bin/codex-simpleclaw\n'

Обычный codex продолжит использовать обычный ~/.codex; запуск через $HOME/.local/bin/codex-simpleclaw — только изолированный профиль SimpleClaw.

Проверка подключения

  1. В том же терминале запустите $HOME/.local/bin/codex-simpleclaw -p "Кратко опиши текущую папку".
  2. Для нового окна терминала сначала задайте export SIMPLECLAW_API_KEY="sc_…", затем повторите команду запуска.
  3. Проверьте время последнего использования ключа в кабинете. При 429 увеличьте budget ключа либо освободите общий лимит.

Не передавайте ключ SimpleClaw в публичный репозиторий, browser storage или сторонний proxy.