الذاكرة والمهارات

# OpenClaw memory CLI
openclaw memory status          # حالة الفهرس والـ provider
openclaw memory search "query"  # بحث من سطر الأوامر
openclaw memory index --force   # أعد بناء الفهرس

# Dreaming sweep
openclaw memory rem-backfill --path ./memory --stage-short-term
openclaw memory rem-backfill --rollback

# شوف raw vs injected وحالة الـ truncation
openclaw doctor

# تأكيد إن الكتابة حصلت فعلاً
cat ~/.hermes/memories/MEMORY.md
cat ~/.hermes/memories/USER.md

# أنهي profile بتقرأ — الذاكرة per-profile
hermes profile list

# الذاكرة فيها: "User prefers dark mode in all editors"
memory(action="replace", target="memory",
       old_text="dark mode",
       content="User prefers light mode in VS Code, dark mode in terminal")

# ~/.hermes/config.yaml
memory:
  memory_enabled: true
  user_profile_enabled: true
  memory_char_limit: 2200   # ~800 tokens
  user_char_limit: 1375     # ~500 tokens
  write_approval: false     # true = require approval before any memory write

# تصفح الجلسات السابقة
hermes sessions list
hermes sessions list --workspace my-project
hermes sessions prune                        # حذف جلسات قديمة من التخزين
hermes sessions optimize                     # دمج FTS5 segments + VACUUM

# استئناف جلسة
hermes -c                                   # آخر جلسة CLI (terminal-aware)
hermes --resume 20250305_091523_a1b2c3d4

# إدارة مزود الذاكرة الخارجي
hermes memory setup      # picker تفاعلي + إعداد
hermes memory status     # شوف إيه النشط
hermes memory off        # عطّل الـ external provider

# أو يدوياً في ~/.hermes/config.yaml
# memory:
#   provider: openviking   # or honcho, mem0, holographic, retaindb,
#                          # byterover, supermemory, or hindsight

# البنية
mkdir -p ~/.hermes/skills/devops/deploy-production/references

# Minimal valid frontmatter
# name: lowercase, hyphens, <=64 chars
# description: <=60 chars, one sentence, ends with a period
# body: non-empty markdown after the closing ---

# ~/.hermes/skills/devops/deploy-production/SKILL.md
---
name: deploy-production
description: Ship a service to production and verify the rollout.
version: 0.1.0
author: Your Name (yourhandle), Hermes Agent
license: MIT
platforms: [linux, macos]
metadata:
  hermes:
    tags: [devops, deploy, production]
    related_skills: [systematic-debugging]
---

# Deploy to Production

## When to Use
- The user asks to deploy or ship a service

## Procedure
1. Confirm the working tree is clean: `git status --porcelain`.
2. `kubectl apply -k deploy/` from the repo root.
3. Watch: `kubectl rollout status deploy/<name> --timeout=120s`.

## Pitfalls

- `rollout status` exits 0 when a rollout is *paused*.

# ~/.hermes/config.yaml — شغّل الـ review على موديل أرخص
auxiliary:
  background_review:
    provider: openrouter
    model: google/gemini-3-flash-preview   # auto (default) = main chat model

# بوابة الموافقة على الكتابة
skills:
  write_approval: true

/skills pending             # قائمة بالكتابات المسجّلة + سطر gist لكل واحدة
/skills diff <id>          # الـ unified diff الكامل
/skills approve <id>       # طبّقها (أو 'all')
/skills reject <id>        # اسقطها (أو 'all')
/skills approval on        # شغّل البوابة واثبّتها

# أو في الشات: /learn
/learn docs/runbook.md and https://example.com/guide; focus on recovery

# ~/.hermes/config.yaml
curator:
  enabled: true
  interval_hours: 168        # 7 أيام
  min_idle_hours: 2
  stale_after_days: 14
  archive_after_days: 30
  consolidate: false         # LLM umbrella-building pass — opt-in
  prune_builtins: false      # archiving للـ bundled skills غير المستخدمة

hermes curator status                  # حالة الـ curator + إحصائيات المهارات
hermes curator usage                   # تيلemetrie استخدام لكل المهارات مع الـ provenance
hermes curator run                     # ادّعي مرور مراجعة دلوقتي
hermes curator pause && hermes curator resume
hermes curator pin deploy-production   # الـ skill ده مش هياخد انتقالات تلقائية
hermes curator list-archived
hermes curator restore <name>         # استرجع مهارة محرشفة

# ~/.hermes/config.yaml
context_file_max_chars: null   # default — سقف ديناميكي متناسب مع نافذة سياق الموديل
# أو حط رقم صحيح موجب لتثبيت سقف ثابت
# context_file_max_chars: 25000
context_file_read_timeout: 5.0

terminal:
  cwd: /home/myuser/projects

# Hermes ← OpenClaw
hermes claw migrate                    # migration تفاعلي كامل
hermes claw migrate --dry-run          # معاينة اللي هيتنقل
hermes claw migrate --preset user-data # ينقل من غير secrets
hermes claw migrate --overwrite        # استبدل التعارضات الموجودة
hermes claw migrate --migrate-secrets  # ضمّن الـ API keys

# OpenClaw ← Hermes : من Control UI
# Settings -> Import Memory -> اختار الوكيل -> راجع -> أكّد
# (Codex / Claude Code / Hermes — Markdown بس)

# تنظيف بعد الـ migration
hermes claw cleanup

# من Hermes إلى OpenClaw
cp ~/.hermes/memories/MEMORY.md ~/.openclaw/workspace/MEMORY.md
cp ~/.hermes/memories/USER.md   ~/.openclaw/workspace/USER.md
cp -r ~/.hermes/skills/ ~/.openclaw/workspace/skills/

# OpenClaw workspace كـ private git backup (موصى به في التوثيق)
cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md IDENTITY.md USER.md memory/
git commit -m "Add agent workspace"

# Phase 1 — foundation
hermes config get memory
hermes memory status
hermes profile list
cat ~/.hermes/memories/MEMORY.md      # أكّد الكتابة حصلت

# Phase 2 — أول مهارة
mkdir -p ~/.hermes/skills/devops/deploy-production/references
hermes skills list | grep deploy-production

# Phase 3 — خلّي الوكيل يبني الباقي
hermes skills list | tail -5

# Phase 4 — Curator
hermes curator status
hermes config set curator.stale_after_days 0   # اختبار فوري
hermes curator run
hermes config set curator.stale_after_days 14  # رجّع
hermes curator pin deploy-production