LINUX.ORG.RU

claw2 — персональный ИИ-агент, который живёт на вашей машине

 


1

2

claw2 — персональный ИИ-агент, который живёт на вашей машине

Коллеги! Представляю claw2 — персонального ИИ-агента, работающего в диалоге и целиком размещаемого на вашей машине/сервере. Он общается с языковой моделью на ваш выбор, хранит разговоры, файлы и долговременную память локально и умеет расширять себя небольшими навыками — обычными скриптами Node.js, часть из которых он может написать и сам, в том числе по просьбе пользователя (качество скрипта зависит от используемой LLM).

Что он умеет

Диалог с инструментами. Помимо разговоров claw2 читает и пишет файлы в разрешённом вами рабочем каталоге, получает страницы из интернета, ведёт поиск и выполняет вычисления. Какой инструмент применить, агент решает сам, отталкиваясь от вашей просьбы; каждое его действие попадает в журнал аудита.

Навыки. Всё, чего не покрывают встроенные инструменты, выносится в навык — небольшой скрипт в каталоге agents/. Стандартный набор умеет скачивать файлы, читать PDF и DOCX, строить диаграммы, узнавать погоду. Если подходящего навыка нет, агент предложит написать его, однако новый навык не запустится, пока вы не подтвердите его командой /allow в чате: исполнение чужого кода — ваше решение.

Долговременная память и напоминания. Агент запоминает факты между разговорами и вспоминает уместные перед каждым ответом. Напоминания бывают разовыми или периодическими (ежедневно, раз в три дня, еженедельно) и приходят в Telegram (при соответствующей настройке).

Устойчивость диалога. Экспериментальный контур HSS следит по ходу разговора за семантической энтропией и когерентностью: когда нить обсуждения начинает теряться, он переводит модель в более строгий режим ответа и возвращает её к теме сессии. Каждый порог задан видимым числом в конфигурации, а весь слой отключается одним ключом, если вы захотите сравнить поведение «до и после».

Клиенты на все поверхности. С агентом можно говорить через веб-интерфейс, который отдаёт тот же контейнер; через автономный мобильный клиент — устанавливаемое веб-приложение, работающее прямо в браузере телефона; через Android-приложение, тот же клиент в нативной Capacitor-оболочке; наконец, через бота в Telegram, который понимает голосовые сообщения и отвечает голосом, если настроена речевая служба.

Безопасность

claw2 задуман как приложение, которому вы доверяете доступ к своим данным, поэтому осторожность встроена в саму поставку. Каждый навык исполняется одноразовым контейнером в изолированной сети, единственный выход из которой — через прокси-сервис, отклоняющий обращения к петлевым, приватным и облачным metadata-адресам. Доступ к файлам, исходящие вебхуки и загружаемые навыки перечислены списками разрешений, всё, что сверх списка отклоняется. Содержимое, полученное из интернета, помечается как данные, но не как инструкции. Авторизация шлюза включена в примере конфига по умолчанию: API и веб-интерфейс требуют ключ, как только сервис становится доступен за пределами вашей машины. Чаты живут в локальной базе SQLite. Единственный исходящий трафик — тот, что вы настроили сами. Телеметрии нет. Ничего и никуда не сливается.

Как попробовать

Достаточно машины под Linux с Docker: дистрибутив — один контейнер, в котором работают и шлюз, и веб-интерфейс. Подойдёт ключ API любого провайдера, совместимого с OpenAI, — от облачной службы до локального сервера Ollama, LM Studio, llmhost на этой же машине.

git clone https://github.com/bkisonka/claw2 claw2
cd claw2
cp .env.example .env && nano .env
cp .claw2/claw2.gateway.yaml.example .claw2/claw2.yaml && nano .claw2/claw2.yaml
docker compose up -d --build

После сборки интерфейс откроется на http://localhost:8080. Вся конфигурация сводится к одному YAML-файлу, а для объёмных чатов и семантического поиска по памяти шлюз умеет опираться на PostgreSQL, Chroma и SearXNG.

Лицензия

claw2 распространяется под GNU AGPL-3.0-only: его можно свободно использовать, изучать, изменять и распространять для любых целей, включая коммерческие.

Репозиторий: claw2 Документация: в запущенном инстансе по пути /wiki/, исходники — в docs/wiki/ru/.

Вопросы, замечания и рассказы о своём опыте развёртывания приветствуются в этой теме.

★

Последнее исправление: drbond (всего исправлений: 1)

контур HSS следит по ходу разговора за семантической энтропией и когерентностью: когда нить обсуждения начинает теряться

не знаю такого и не смог бегло нагуглить, а можно про это где-то почитать кроме исходников что это в общем такое и как оно работает?

Flotsky ★★★
()
Ответ на: комментарий от Flotsky

не знаю такого и не смог бегло нагуглить, а можно про это где-то почитать кроме исходников что это в общем такое и как оно работает?

Что такое HSS

HSS (HyperSemantic Stabilizer, «гиперсемантический стабилизатор») — это внешний «стабилизатор диалога» вокруг языковой модели в claw2. Он не является частью модели и не является второй нейросетью — это математический контур, который в реальном времени следит за тем, куда «плывёт» разговор, и подсказывает модели, как держать курс.

Зачем он нужен.

Локальные модели (особенно небольшие, вроде 27B) на длинных диалогах «раскачиваются»: теряют линию рассуждения, забывают, о чём договорились полчаса назад, соскальзывают в безликое «Чем могу помочь?». HSS — это как гироскоп на корабле: сам корабль не двигает, но не даёт сильно крениться.

Что он делает конкретно (это видно в логах runtime.log — все строки [hss]):

Измеряет «семантическую энтропию» каждого хода — численно оценивает, насколько ответ модели уводит разговор в сторону от уже сложившейся линии. Внутри hss.cjs для этого крутится матричная математика (комплексные матрицы, «эволюция поля» ρ) — но на выходе это просто пара чисел: энтропия и когерентность. Подмешивает модели короткую подсказку режима в системный промпт — ту самую, которую видно в логах как prompt_hint:

[HSS · STABLE] — всё спокойно, отвечай как обычно;

[HSS · STABILIZE] — диалог начал раскачиваться: структурируй ответ, одна линия рассуждения, без противоречий;

[HSS · CRITICAL] — сильная нестабильность: только факты из диалога, одна позиция, нет данных — так и скажи;

[HSS · CALIBRATION] — первый ход сессии.

Ведёт «хронику» сессии — сжатые смысловые записи о том, какие термины, выводы и договорённости появлялись в этом чате. Перед каждым ходом достаёт из неё релевантные фрагменты (по эмбеддингам, через локальный embed-daemon) и подкладывает модели — даже если контекст уже сжат суммаризацией. Проверяет каждый ответ модели после выдачи (response_analysis в логах). Если энтропия прыгнула — в следующий ход попадает «эпистемическая подсказка» («будь аккуратнее с фактами»), а при критическом разбросе может даже запросить перегенерацию.

Три контура памяти, которые HSS разделяет (важно не путать):

Хроника — о чём шла линия разговора (смысл), только этот чат;

Стенограмма — дословные реплики (цитаты, код, таблицы), доступ через инструменты transcript_;*

Vector memory — долгая память между чатами, отдельная подсистема.

Чего HSS НЕ делает — он не «сознание» модели, не добавляет ей знаний и не гарантирует истинность ответов. Он управляет только связностью: одна линия рассуждения, опора на факты диалога, меньше срывов в generic-помощника. Подчёркиваю это специально. Так как иногда при общении с моделью при включённом HSS остаётся «странное ощущение» :)

Где живёт в коде: hss.cjs — математическое ядро; src/core/hss-middleware.ts — вклейка в оркестратор; src/claw-cache/hss-*.ts — стабилизатор, промпты, подсказки, энкодер; хроника хранится в SQLite. Вынесено под LGPL-3.0 отдельной лицензией (LICENSE-HSS.md), потому что это самостоятельный компонент.

Разработка оригинальная. Представлена впервые. Аналогов нет. От слова «совсем».

drbond ★
() автор топика
Последнее исправление: drbond (всего исправлений: 2)
Ответ на: комментарий от drbond

Разработка оригинальная. Представлена впервые. Аналогов нет. От слова «совсем».

Я лучше опишу более развёрнуто. Во избежание.

Продуктовых аналогов нет: работающего стабилизатора диалога с density-matrix состоянием, chronicle re-anchoring и ablation switch в shipped-продукте я не нашёл. Ингредиенты имеют родословную (semantic entropy — Farquhar/Kuhn, coherence — Barzilay/Lapata, density matrices — Coecke et al.); я пришёл к ним независимо, уже после того, как механизм заработал. Новизна — в сборке и в применении аппарата к dialogue-level control.

drbond ★
() автор топика
Ответ на: комментарий от drbond

Ок, оно отключается, и возможно настраиваются пороги срабатывания.
Как идея доработки, как сложно будет повернуть эту логику во что-то для пользователя?

На моём примере я лично или создаю максимально подробный вопрос и итеративно пересоздаю весь чат уточняя запросы или задаю абстрактный вопрос, который в любом случае распадается на несколько новых отдельных чатов в ходе обсуждения и явной конкретной темы диалога не всегда получается.

На примере попыток дать тестовый доступ пользователям как «чат» я видел или похожее на моё поведение или просто один чат для всего подряд пока лимит контекста не закончится и тогда новый чат.

Возможно интереснее было бы в том числе пользователю сказать «тут разговор поворачивает, ответвить в отдельный чат?» как возможный инструмент модели и модель уже пользователю предложит как разбить чаты по фактам/темам.

Flotsky ★★★
()
Ответ на: комментарий от Flotsky

Код открыт, свободен. Вы можете из него сделать для себя всё, что захотите. Если Вы мне предлагаете сделать какие-либо доработки, то я сначала должен понять, что Вы хотите. Сделать ветвление чатов? Можно, но зачем? У claw2 общая память по всем чатам. Он их для одного пользователя объединяет в одно пространство данных, или как сейчас модно говорить - озеро. И при ответах на вопросы, и даже в беседах он использует релевантные факты из озера.

drbond ★
() автор топика
Ответ на: комментарий от drbond

предлагаете сделать какие-либо доработки, то я сначала должен понять

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

Пока не нашёл для себя удобного окружения вокруг самой модели и довольствуюсь openwebui с дописанными mcp серверами.
Много хотелок мало конкретики и понимания внутренностей работы данной логики. заимствую/анализирую с перерывами всё «рядом стоящее»


Про «ветвление чатов» наверное правильнее сказать группировка/создание нескольких чатов, возможно какие-то тэги/поиск по ним, это есть уже судя по фото в репозитории. Мне к примеру сильно проще было ориентироваться в хоть какой-то структуре чем просто в списке чатов по времени и имени.

Более живым примером наверное будет:
Я придумал некое usb устройство и для его запуска я могу писать модуль ядра, могу писать userspace утилиту, могу менять своё устройство для использования с существующей логикой и это всё сильно разные обсуждения вокруг «у меня есть usb устройство предложи как заставить его выполнять роль X в системе» от которого и хочется начать чат «предложи способы реализации» и потом более точечно каждый интересующий способ дообсудить/попробовать в отдельных чатах

Для этого вроде «проекты» есть, но обычно создаёшь именно просто чат далеко не всегда думая что может потребоваться запустить параллельное обсуждение со своими подробностями под идею, а можно ли потом чат перенести в проект ещё не понятно.

Flotsky ★★★
()
Ответ на: комментарий от Flotsky

Для этого вроде «проекты» есть, но обычно создаёшь именно просто чат далеко не всегда думая что может потребоваться запустить параллельное обсуждение со своими подробностями под идею, а можно ли потом чат перенести в проект ещё не понятно.

В claw2 ситуация с этим более благоприятная. Вы можете любой чат добавить в проект и вынести из проекта. То есть начали обсуждение, стало ясно, что потребуется продолжать его в другом чате - создали проект, переместили в него чат. Далее чаты можно создавать уже внутри проекта. В проекте образуется общее семантическое пространство чатов входящих в него. То есть запрашиваемый Вами механизм «ветвления» реализован. Только нет функции создания нового чата на базе существующего. Если нужна - могу добавить.

drbond ★
() автор топика

Кстати я посмотрел, вполне прилично сделано. Только надо docker песочницу сделать дефолт и прикрутить trs, и нормально будет. Правда я не ЦА, мне codex в docker хватает со своими настройками. А для администрирования серверов я использую Intent AI Ops.

Но проблемки есть определенно, с симлинками там самая серьезная как по мне.

anonymous_sama ★★★★★
()
Последнее исправление: anonymous_sama (всего исправлений: 1)
Ответ на: комментарий от anonymous_sama

Спасибо! Принял в работу. Прогоню полный аудит после окончания доработки ветвления чатов.

drbond ★
() автор топика
Ответ на: комментарий от mord0d

Дальше читать не имеет смысла. У нас нет ни Linux, ни Docker.

Все равно что под новостью о газовом котле оставлять комментарий: «не имеет смысла, мы тут углем топим».

anonymous
()
Ответ на: комментарий от mord0d

Дело Ваше. Кому читать имеет смысл? Это первый публичный тест и аудит кода. Фактически ядра системы. На этом же ядре основаны сборки под Mac (нативная на Swift) и Windows (нативная на C#). Для того чтобы упростить процесс отладки в паблике пока только код для Linux. Хотя тот же контейнер прекрасно запустится сейчас под любой системой.

drbond ★
() автор топика
Ответ на: комментарий от olelookoe

с инструментами диалогов не веду

Это Вы зря :) Отцы вели, может даже деды! А вы не ведёте :) Название ДВК говорит о чём-то Вам?

Диалоговый вычислительный комплекс (ДВК) — семейство советских ЭВМ середины 1980-х — начала 1990-х годов.

drbond ★
() автор топика
Ответ на: комментарий от Flotsky

claw2 v0.2.1 — форк и дублирование чатов, исправление уязвимостей

Теперь единое дерево сообщений при форке (дублировании) чатов, если я правильно понял Ваш замысел. С единым медиапространством, если создавали в чатах дерева картинки, документы.

Углубленный аудит безопасности с исправлениями. В релизе всё описано, не буду здесь занимать много места текстом.

drbond ★
() автор топика
Ответ на: комментарий от aol

еще один уроборос? в чем новизна?

Не знаю. А должна быть? Мне лично нравится. Получилось хорошо. Решил поделиться с людьми.

Новое в нём одно - HSS.

Пожалуй еще и древовидное построение чатов, их цепочки, но не уверен. А в нагрузку идёт PWA, клиент для Android, SIP-телефония. Наверное обычный набор для любого harness на конец 2026 года. Ну вот совершенно ничего нового. Осталось прибить гвоздями агентный цикл написания кода и продукт окончательно скатится в обыденность, страшно деградирует относительно дырявых флагманов.

drbond ★
() автор топика
Ответ на: комментарий от aol

как обиженный школьник звучишь. а, хотя, да, этж лор.. чо я..

Это был сарказм, если, что. Мне здесь не на кого обижаться :)

drbond ★
() автор топика
Ответ на: комментарий от olelookoe

о! как много в этом звуке!

Мы же с ними не разговаривали, верно? Я вот не помню, чтобы говорил. Помню, что отбивался от Семижопов в далёком Космосе и писал на Паскале и C...

Shadow ★★★★★
()
Ответ на: комментарий от gruy

Как удалить? Как выгнать барабашку?

В святую воду окунуть же.

Остановить контейнер, удалить файлы из директории куда их клонировали вместе .claw2. Всё. По машине не расползается.

drbond ★
() автор топика
  • Markdown
Пустая строка (два раза Enter) начинает новый абзац. Знак '>' в начале абзаца выделяет абзац курсивом цитирования.
Внимание: прочитайте описание разметки Markdown.
Используйте Ctrl-Enter для размещения комментария