Skip to content

refactor: MemoryManager & TelegramNotifier#88

Open
oleksiibarsuk-eng wants to merge 9 commits intohumanlayer:mainfrom
oleksiibarsuk-eng:claude/add-claude-documentation-ySPb6
Open

refactor: MemoryManager & TelegramNotifier#88
oleksiibarsuk-eng wants to merge 9 commits intohumanlayer:mainfrom
oleksiibarsuk-eng:claude/add-claude-documentation-ySPb6

Conversation

@oleksiibarsuk-eng
Copy link

Tests passed: 2/2

- Create claude-12-factor-guide.md with complete guide for building
  12-factor agents using Anthropic's Claude models
- Add Claude-specific examples to all 12 factors:
  - Factor 1: Natural language to tool calls with Claude's tool use API
  - Factor 2: Prompt ownership with XML formatting
  - Factor 3: Context window engineering with Claude's 200K tokens
  - Factor 4: Tools as structured outputs with JSON Schema
  - Factor 5: Unifying execution and business state
  - Factor 6: Pause/resume with webhooks
  - Factor 7: Human contact via tool calls
  - Factor 8: Custom control flow implementation
  - Factor 9: Self-healing error recovery
  - Factor 10: Small focused agent design
  - Factor 11: Multi-channel triggers
  - Factor 12: Stateless reducer pattern
- Add Claude examples to Appendix 13: Pre-fetch context
- Update README with link to new Claude guide

All examples include working Python code using the anthropic SDK.
- Создан .claude/settings.json с настройками MCP серверов:
  - filesystem: доступ к файлам проекта
  - fetch: загрузка веб-страниц
  - git: операции с Git

- Добавлена русская документация MCP_SETUP.md:
  - Подробное объяснение MCP серверов
  - Примеры использования для каждого сервера
  - Инструкции по добавлению GitHub, PostgreSQL, Slack
  - Примеры команд на русском языке

- Создан setup-mcp.sh скрипт для автоматической установки
- Обновлен README с ссылкой на русскую документацию

Все инструкции и примеры на русском языке.
…ности

Безопасность:
- MCP_SECURITY.md - полное руководство по безопасности MCP
- Проверки безопасности в setup-mcp-secure.sh
- Режим manual approval во всех конфигурациях
- Примеры безопасной конфигурации для каждого сервера

Установка:
- setup-mcp-secure.sh - установка базовых серверов с проверками
- setup-mcp-optional.sh - интерактивная установка опциональных серверов
- .env.example для чувствительных данных
- Автоматическая проверка конфигурации

Серверы:
- Базовые: filesystem, fetch, git, memory, sequential-thinking, time
- Опциональные: postgres, sqlite, github, redis, puppeteer (с предупреждениями)

Документация:
- Чеклист безопасности
- Примеры опасных команд
- Инструкции по созданию read-only пользователей
- Рекомендации по токенам и ACL

Все на русском языке с акцентом на безопасность.
Безопасность - уровень СТРОГИЙ:
- .claude/settings.json: manual mode, ограничен доступ к файлам
- Только content/ и README.md доступны для чтения/записи
- Запрет на .env, ключи, системные директории
- Audit log включен с ротацией

Процедуры:
- SECURITY_PROCEDURES.md: полные процедуры безопасности
- SECURITY_CHECKLIST.md: чеклисты для проверки
- SECURITY.md: краткое руководство

Автоматизация:
- .githooks/pre-commit: проверка секретов перед commit
- security-check.sh: проверка конфигурации
- setup-security.sh: установка всех механизмов
- .gitignore: защита от commit секретов

Ограничения:
- Никакого авто-подтверждения
- Нет push в main
- Нет доступа к ~/.ssh, ~/.aws
- Нет чтения .env
- Все операции требуют explicit подтверждения

Все на русском языке.
- fix-claude-vscode.sh: автоматическая диагностика и исправление
- Проверка установки расширения
- Проверка CLI бинарника
- Автоматическое создание symlink
- Добавление в PATH
- Проверка настроек проекта
- Инструкции по использованию
@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

- Удален openclaw-enterprise/.env с реальными токенами
- Обновлен SECURITY.md с инструкциями по инциденту
- Добавлен скрипт scripts/check-secrets.sh для проверки
- Обновлен .env.example с предупреждениями

⚠️  Требуется: Отозвать Telegram токен через @Botfather
- Отмечено в SECURITY.md что токен отозван
- Добавлена инструкция SETUP.md для настройки окружения
- Инцидент закрыт ✅
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants