openclaw opencode означает две разные интеграции: выбор моделей из каталогов OpenCode Zen или Go для OpenClaw и просмотр нативных сессий OpenCode через официальный plugin. Подключение модели открывает путь к её вызову. Появление сессии в боковой панели подтверждает обнаружение истории CLI. Для команды эту разницу удобно закрепить двумя строками в схеме доступа. Оба маршрута зависят от версии, настройки и разрешений окружения.
Два маршрута
OpenCode Zen и Go дают OpenClaw каталоги моделей; OpenCode Session Catalog показывает сохранённые сессии CLI и локальное действие Continue. Эти функции требуют разных проверок.
В документации model provider каталоги Zen и Go названы отдельно. Zen использует префикс opencode/..., Go — opencode-go/.... Доступ к списку моделей зависит от учётной записи и выбранного маршрута. Go требует собственного права доступа по подписке сверх учётных данных Zen. Каталог моделей нужен, когда OpenClaw должен отправить запрос выбранной модели. Список показывает доступные ссылки на модели, но рабочий вызов выбранной модели требует самостоятельной проверки.
Справка официального plugin описывает другую поверхность: OpenClaw обнаруживает CLI OpenCode на Gateway и связанных узлах, показывает сохранённые сессии в боковой панели и читает историю через официальный CLI. Для локальных строк предусмотрен Continue: он создаёт сессию OpenClaw и продолжает исходную сессию OpenCode через ACP. Строки связанных узлов остаются в режиме просмотра. Эта функция отвечает за историю и продолжение процесса; модельный маршрут настраивают отдельно.
| Задача | Механизм | Что подтвердить |
|---|---|---|
| Выбрать модель | Каталог Zen или Go | Доступность выбранной модели для учётной записи |
| Открыть историю | Каталог нативных сессий | Права на CLI и содержимое истории |
| Продолжить работу | Continue для локальной сессии | Контекст, разрешения и результат первого хода |
Сначала спросите, что команда хочет получить: ответ модели внутри OpenClaw или возврат к прежней работе в OpenCode. У этих задач разные владельцы данных и разные точки отказа. Обзор MCP-инструментов OpenCode помогает понять возможности самого кодового агента; здесь речь о связи его моделей и сессий с OpenClaw.
Выбор модели
Для маршрута моделей администратор указывает, нужен ли команде Zen или Go, и проверяет доступные ссылки на модели в собственной учётной записи. Официальная справка показывает команды openclaw models list --provider opencode и openclaw models list --provider opencode-go для просмотра соответствующих каталогов. Проверку проводят в разрешённом тестовом окружении, без копирования значений секретов в тикеты и журналы. Наличие модели в списке становится исходной гипотезой; контрольный запрос показывает фактическую доступность выбранной ссылки.
Zen и Go используют общую инфраструктуру ключей OpenCode, но Go требует отдельного права доступа. Поэтому заведите карточку маршрута: владелец учётной записи, каталог, выбранная ссылка на модель, место хранения секрета, допустимые группы пользователей и порядок отзыва. Ключ хранится в назначенном хранилище; сотрудникам показывают только статус доступа; значение секрета остаётся в хранилище. Сверьте настройки OpenClaw с политикой организации на хранение запросов и данных. Условия тарифа, хранения и обработки зависят от выбранного маршрута и модели, поэтому проверьте актуальные условия в официальном кабинете без переноса цифр в регламент.
- Зафиксируйте нужный каталог и ответственного за учётную запись OpenCode.
- Сверьте список моделей с разрешённым набором для вашей задачи.
- Выполните контрольный запрос без производственных данных и запишите результат.
- Отдельно проверьте отказ при отсутствии права доступа или отзыве ключа.
При ошибке сначала различайте отсутствие модели в каталоге, ограничение доступа к ней и сетевой сбой. Простая замена модели по имени может изменить обработку данных и рабочий результат. Инженер сверяет диагностический ответ с официальной документацией, владелец процесса утверждает допустимый маршрут. Итог этапа — запись о работоспособной модели. Доступность нативных сессий проверяют отдельно.
Каталог сессий
Для истории нужен установленный OpenCode CLI там, где OpenClaw ищет его: на Gateway либо связанном узле. По документации каталог нативных сессий включён по умолчанию и может быть выключен в настройках plugin. Перед включением для команды проверьте, кому видны строки каталога, кто вправе читать расшифровки и какие каталоги данных доступны процессу CLI. В самой истории могут находиться код, внутренние требования и личные сведения. Видимость названия сессии и разрешение читать её содержимое оформляйте как разные права.
Документация описывает отдельные способы просмотра для OpenCode v1 и v2, а также изолированное окружение каталога без посторонних учётных данных Gateway. Это ограничение полезно, но его наличие в конкретной установке проверяют по версии и настройке. Системный администратор должен подтвердить права процесса на запуск CLI и чтение хранилища сессий. Серверная политика определяет, какие пользователи увидят историю и смогут продолжить работу; разрешение задают в системе, вне текста промпта.
- В тестовом контуре проверьте версию OpenClaw и OpenCode CLI, затем статус каталога в настройках plugin.
- Под разрешённой ролью откройте список и выбранную обезличенную сессию.
- Под ролью без доступа проверьте запрет на чтение истории и отсутствие утечки содержимого в журнал.
- Для локальной строки запустите Continue в контролируемом сценарии и сверьте исходный контекст.
- Для строки связанного узла проверьте режим просмотра и зафиксируйте отсутствие действия Continue.
OpenCode сохраняет полный контекст на своей стороне, а при продолжении OpenClaw переносит только недавнюю часть истории в собственную расшифровку. Поэтому сравнение видимого текста в двух интерфейсах требует понимания границ импорта. Пустая или короткая расшифровка в OpenClaw оставляет открытым вопрос о полноте исходного контекста; инженер сверяет его в OpenCode.
Границы доступа
Для командной работы полезна матрица прав с отдельными колонками для модели, CLI и истории. Право посылать запрос модели связано с учётными данными provider. Право видеть нативную сессию связано с доступом к хранилищу и настройкой каталога. Право выполнить Continue связано с локальной строкой, действием пользователя и разрешениями нового процесса. К общему логину добавьте проверку каждого уровня. Сервер и окружающая система должны подтверждать роль, область доступа и действие, даже если ИИ предлагает безопасный на вид шаг.
В пилоте предложите учебную сессию без рабочих секретов и с разрешённым фрагментом кода. Один сотрудник проверяет просмотр, другой пробует действие за пределами своей роли. Проверяющий фиксирует, какие сведения попали в каталог, расшифровку и журналы. При продолжении отдельно проверьте, какую рабочую папку видит новый процесс и какие операции CLI разрешены. Наличие кнопки Continue в интерфейсе означает доступность действия в этой конфигурации; дальнейшие операции требуют собственных проверок прав.
Каталог моделей и каталог сессий имеют разные источники данных. Учётные данные provider открывают маршрут модели по правилам сервиса. Чтение истории зависит от размещения CLI, прав процесса и политики доступа к сессиям.
При отказе по правам сохраните код ошибки и обезличенный контекст вызова. Модель может объяснить возможную причину и предложить гипотезу, но инженер проверяет конфигурацию, версию и реальные разрешения. Если команда уже описала границы агентных действий, сопоставьте их с практикой защиты прав и секретов ИИ-агентов. После этого возникает предметный вопрос к владельцу системы.
Хотите проверить доступ команды к моделям и сессиям?
Приёмка пилота
Предлагаемый результат пилота — схема двух маршрутов и журнал тестов с ожидаемым и фактическим исходом. Для моделей нужны запись о каталоге, разрешённом вызове и отказе при снятом доступе. Для сессий нужны проверка обнаружения CLI, просмотр обезличенной истории, локальный Continue и отказ для пользователя без нужной роли. Связанный узел проверяют отдельно, поскольку документация оставляет его строки в режиме просмотра. Так можно увидеть, какая функция поддерживается именно вашей версией и настройкой.
Проверяйте содержимое истории до расширения аудитории каталога. Разработчик сверяет, откуда взят фрагмент контекста и какой объём попал в расшифровку OpenClaw. Владелец данных решает, кому разрешён просмотр, а администратор закрепляет права в системе. Для сбоев составьте короткий маршрут диагностики: статус plugin, наличие CLI, права на хранилище, доступ к каталогу моделей и ответ выбранного маршрута. Каждый пункт имеет наблюдаемый результат; догадки модели остаются подсказкой инженеру.
Стоимость работы описывайте через состав проверки: число окружений, правила доступа, состояние CLI, объём истории и требуемую документацию. Условия обсуждаются после просмотра схемы команды и желаемого сценария, без универсальной суммы. При внешнем разборе передайте обезличенную матрицу прав и результаты тестов для консультации по внедрению ИИ. Тесты отказов и отката можно сверить с материалом о проверке ИИ-агентов. Приёмка заканчивается явным решением владельца системы по каждому маршруту. Общей отметки «OpenCode подключён» здесь мало.
Выберите один разрешённый запрос модели и одну обезличенную локальную сессию. Проверьте их раздельно, затем добавьте попытку без прав на историю и модель. Зафиксируйте подтверждённые возможности вашей сборки.