2026: OpenClaw на удалённом физическом Mac — подключение MCP: stdio и Streamable HTTP (runbook: spawn ENOENT, несовпадение версий протокола, тайм-ауты инструментов + CLI + FAQ)

2. stdio и Streamable HTTP: когда какой транспорт

Выбирайте транспорт с минимумом движущихся частей на одном хосте; переходите на HTTP, когда нужно шарить сервер или выносить авторизацию на прокси.

3. Семь шагов воспроизводимой выкатки

1. Зафиксировать личность процесса — пользователь OpenClaw, label LaunchAgent/ plist или unit, cwd из launchctl print.
2. Проиграть stdio без шлюза — от этого пользователя: /bin/bash -lc 'which node; node -v' и точная команда MCP с тем же env.
3. Укрепить конфиг stdio — абсолютные command, явный args, при необходимости cwd и блок env (см. JSON ниже).
4. Опционально HTTP — слушать 127.0.0.1, TLS на nginx/Caddy, curl -v для проверки согласования Accept.
5. Зафиксировать версии — закрепить MCP SDK / пакет сервера в той же major.minor, что клиент внутри OpenClaw; записать в changelog.
6. Бюджет тайм-аутов — измерить P95 tools/call на реалистичных входах; клиентский wait ≥ P95×1,5 с жёстким потолком.
7. Контракт логов — одна JSON-строка на initialize, tools/list и tools/call с общим correlation id.

Для сценариев агентов 7×24 зафиксируйте, кто владеет перезапуском plist, ротацией логов и политикой обновлений Node — иначе тайм-ауты MCP окажутся симптомом «плавающего» окружения, а не сети.

4. Фрагменты конфигурации CLI (пример JSON)

Подстройте ключи под схему OpenClaw или хоста; критичны абсолютные пути и явные блоки окружения.

{
  "mcpServers": {
    "repo-tools": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/usr/local/lib/mcp-servers/repo-tools/dist/main.js"],
      "cwd": "/Users/shared/mcp/repo-tools",
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/bin:/bin",
        "NODE_ENV": "production"
      }
    }
  }
}

{
  "mcpServers": {
    "legacy-npx": {
      "command": "/bin/bash",
      "args": ["-lc", "exec npx --yes @example/[email protected]"],
      "env": { "HOME": "/Users/shared" }
    }
  }
}

{
  "mcpServers": {
    "http-shared": {
      "url": "https://mcp.internal.example.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_EDGE_TOKEN}"
      }
    }
  }
}

5. Runbook по симптомам

5.1 spawn ENOENT (stdio)

5.2 Версия протокола / 406 (Streamable HTTP)

Сравните логи рукопожатия сервера и клиента. Если сервер ждёт text/event-stream, а прокси включает gzip без сброса буфера, клиент «зависает» с формулировкой про несовпадение версии при совпадающем semver.

5.3 Тайм-ауты инструментов

Зафиксируйте три таймера: (A) ожидание на стороне модели/маршрутизатора, (B) дедлайн шлюза к upstream, (C) внутренний тайм-аут задачи в MCP-сервере. Сначала ослабляйте самый «тесный» слой, соседние — только если трейсы показывают очередь.

6. Цифры для внутренних SLO

• ~4 Вт — типичное потребление Mac mini на Apple Silicon в простое при SSH и лёгких шлюзах; удобно для TCO против простаивающих x86-башен.
• 25 с — ориентир верхней границы «быстрого» P95 для tools/call на общих узлах; дальше — дробить инструмент или стримить частичные результаты вместо бесконечного роста тайм-аутов.
• 600 с — тяжёлые обслуживающие операции (полный скан репозитория) лучше вынести в асинхронные задания с опросом статуса, а не в один блокирующий вызов MCP — по аналогии с длинными git/npm в CI-зеркалах.

7. FAQ