الأدوات والقدرات

1. SYSTEM BUILD  — runtime يجمّع الأدوات ويحوّلها لـ function definitions
2. MODEL OUTPUT — { "name": "read_file",
                              "input": { "path": "README.md" } }
3. RUNTIME EXEC — تحقّق: الأداة موجودة؟ الصلاحيات؟ الـ schema؟
                       ← تشغيل فعلي على القرص + secret redaction
4. TOOL RESULT  — { "role": "tool",
                              "content": "1|# Velox Academy\n2|..." }
5. FINAL ANSWER — النموذج بيقرأ النتيجة ويرد شفهي

# شوف الأدوات المتاحة (واجهة تفاعلية)
hermes tools

# عرض فقط
hermes tools list

# تفعيل / تعطيل بالاسم
hermes tools enable browser
hermes tools disable x_search

# لأداة واحدة في هذه الجلسة فقط (override مؤقت)
hermes chat --toolsets "web,terminal"

read_file(path="config.yaml", offset=1, limit=2000)

# تعديل جزئي — بيرجع unified diff وبيعمل syntax check
patch(path="src/config.py",
      old_string="timeout = 30",
      new_string="timeout = 180")

# بحث في المحتوى أو بالاسم (rg-backed) مع file_glob وحدود
search_files(pattern="database", path=".", file_glob="*.yaml", limit=20)

terminal:
  backend: ssh      # local | docker | ssh | singularity | modal | daytona | vercel_sandbox
  cwd: "."
  timeout: 180      # مهلة الأمر بالثواني

TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

# نفّذ npm test على الـ sandbox بمهلة 300 ثانية
openclaw exec --host auto --timeout 300 "npm test"

# نفّذ في الخلفية (مثل npm run dev) — timeoutSeconds: 0 يلغي المهلة
openclaw exec --background "npm run dev"

results = web_search("RAG best practices 2026", limit=5)   # رخيص جداً
pages  = web_extract(["https://a.com", "https://b.com"])       # أغلى: بيفتح الصفحة

# اضبط إعدادات البحث والجلب من الـ CLI
openclaw configure --section web

web:
  cache_exempt_hosts:      # دايماً fetched live؛ يسري فوراً
    - mysite.vercel.app
    - "*.ngrok-free.app"
    - mysite.dev           # suffix match

browser_navigate(url)          # أول نداء دائماً — يثبّت الجلسة
browser_snapshot(full=false)    # العناصر التفاعلية بس (compact)
browser_click(@e5)              # نقرة على عنصر بمعرّف من الـ snapshot
browser_type(@e3, "text")       # كتابة في input (بيمسح الحقل الأول)
browser_press("Enter")          # Enter للإرسال، Escape للإغلاق
browser_console()               # console + أخطاء JS ← لكشف الأخطاء الصامتة

# أداتين إضافيتين — بيتسجلوا بس لو في endpoint CDP متاح
browser_cdp("Page.captureScreenshot")
browser_dialog(action="accept") # بعد ما الـ snapshot يعرض pending_dialogs

# افتح الـ CLI بتاع المتصفح
openclaw browser --help

# اضبط الـ profile من الإعدادات
openclaw configure --section browser

from hermes_tools import web_search, web_extract
import json

queries = [
    "vector database 2026",
    "RAG best practices 2026",
    "LLM agent frameworks 2026",
    "MCP servers directory",
    "prompt caching explained",
]

all_results = []
for q in queries:
    results = web_search(q, limit=3)
    urls = [r["url"] for r in results["data"]["web"]]
    for i in range(0, len(urls), 5):
        batch = urls[i:i+5]                    # 5 URLs في نداء واحد
        page = web_extract(batch)
        for p in page.get("results", []):
            if p.get("content"):
                all_results.append({"q": q, "url": p["url"],
                                    "text": p["content"][:800]})

print(json.dumps(all_results, indent=2))   # بس ده اللي بيرجع

code_execution:
  mode: project   # أو "strict"

mcp_servers:
  time:                          # stdio — command-based
    command: "uvx"
    args: ["mcp-server-time"]
    timeout: 120                  # مهلة كل نداء بالثواني
    connect_timeout: 60

  docs:                          # HTTP — url-based
    url: "https://mcp.example.com/mcp"
    headers:
      Authorization: "Bearer sk-..."
    timeout: 180

hermes mcp                # picker تفاعلي (افتراضي)
hermes mcp catalog        # قائمة نصية قابلة للـ scripting
hermes mcp install n8n    # تثبيت entry من الكتالوج بالاسم
hermes mcp configure NAME # تبديل اختيار الأدوات (الفلترة)
hermes mcp serve           # تشغيل Hermes كـ MCP server

# سيرفر stdio محلي
openclaw mcp add local-tools --command node --arg ./dist/mcp-server.js
openclaw mcp doctor local-tools --probe

# سيرفر HTTP بعيد، يعرض جزء من أدواته بس
openclaw mcp add docs --url https://mcp.example.com/mcp \
  --transport streamable-http --include 'search,read_*'

# اتأكد إن السيرفرات المفعّلة بتتصل فعلاً
openclaw mcp probe context7 --json

mcp_servers:
  company_api:
    command: "npx"
    args: ["-y", "company-mcp"]
    env:
      DATABASE_URL: "postgresql://..."   # لازم صريح — مش بينتقل تلقائياً
    tools:
      include: ["db_read", "db_query", "db_schema"]

# حدّث فلاتر الأدوات لكل سيرفر (أسماء و globs بسيطة بـ *)
openclaw mcp tools context7 --include 'resolve-library-id,get-library-docs'
openclaw mcp configure docs --include 'search,read_*'

# موافقات Codex: auto | prompt | approve (approve بس للسيرفرات الموثوقة)
openclaw mcp add memory --command npx --arg -y \
  --arg @modelcontextprotocol/server-memory --approval approve

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"docs.read"}}'

# شغّل login — callback loopback + تخزين في SQLite مشترك
openclaw mcp login docs
openclaw mcp status --verbose
openclaw mcp doctor docs --probe
openclaw mcp logout docs

~/.hermes/plugins/my-plugin/
├── plugin.yaml      # manifest
├── __init__.py      # register() — بيربط الـ schemas بالـ handlers
├── schemas.py       # tool schemas (اللي النموذج بيشوفه)
└── tools.py         # tool handlers (اللي بيشتغل لما الأداة تنادى)

def register(ctx):
    schema = {
        "name": "hello_world",
        "description": "Returns a friendly greeting for the given name.",
        "parameters": {
            "type": "object",
            "properties": {"name": {"type": "string"}},
            "required": ["name"],
        },
    }

    def handle_hello(params, **kwargs):
        del kwargs
        name = params.get("name", "World")
        return json.dumps({"success": True, "greeting": f"Hello, {name}!"})

    ctx.register_tool(name="hello_world", toolset="hello_world",
                      schema=schema, handler=handle_hello)
    ctx.register_hook("post_tool_call", on_tool_call)

openclaw plugins init my-plugin --name "My Plugin"   # scaffolding
npm run plugin:build                                  # بناء
npm run plugin:validate                                # تحقق
openclaw plugins install ./my-plugin
openclaw plugins enable my-plugin
openclaw plugins inspect my-plugin --runtime --json

# الوسط الموصى به
hermes config set approvals.mode smart

# يتخطى كل موافقات الأوامر (مش موصى به)
hermes config set approvals.mode off

{
  tools: {
    profile: "coding",
    deny: ["group:fs"],              // group denies بتتجاوز allow صريح
    byProvider: { anthropic: { profile: "minimal" } },
    toolsBySender: {
      "channel:discord:1234567890123": { alsoAllow: ["group:fs"] },
      "*": { deny: ["exec", "process", "write", "edit", "apply_patch"] },
    },
  },
}

from hermes_tools import terminal
import json

# شغّل عملية طويلة في الخلفية وكمّل اللفّة
sid = terminal(command="hermes chat -q 'Set up CI/CD for ~/myapp'",
                background=True, notify_on_complete=True)
print(json.dumps({"session_id": sid}))

image_gen:
  max_parallel_requests: 4   # صور متوازية في batch نداء واحد (افتراضي 4)

{
  mcp: { servers: { "fast-server": {
        url: "https://mcp.example.com",
        supportsParallelToolCalls: true } } },
  tools: { media: { concurrency: 2 } },
}

# المعالج التفاعلي: صور + صوت + كل الأدوات
hermes tools

# Hermes: 11 موديل FAL من غير مفتاح، و Edge TTS مجاني من غير مفتاح

image_gen:
  model: fal-ai/flux-2/klein/9b   # افتراضي: سريع، نص واضح، $0.006/MP
  use_gateway: false             # true لو مشترك Nous Portal
  max_parallel_requests: 4

tts:
  provider: "edge"               # edge | elevenlabs | openai | minimax | mistral | xai | piper
  speed: 1.0
  edge:
    voice: "en-US-AriaNeural"    # 322 صوت، 74 لغة

stt:
  enabled: true
  provider: local                # faster-whisper مجاني

{
  tools: { media: {
    concurrency: 2,
    models: [
      { provider: "openai", model: "gpt-4o-mini-transcribe", capabilities: ["audio"] },
      { provider: "xai", model: "grok-imagine-image", capabilities: ["image"] },
    ],
  } },
}

# OpenClaw
openclaw doctor
openclaw mcp status --verbose
openclaw plugins inspect my-plugin --runtime --json

# Hermes
hermes doctor
hermes tools list
hermes mcp catalog

mkdir serena-mcp && cd serena-mcp
npm init -y
npm install @modelcontextprotocol/sdk

# سجّل الأداتين في السيرفر
node index.js

mcp_servers:
  serena:
    command: "node"
    args: ["/home/you/serena-mcp/index.js"]
    timeout: 60
    tools:
      include: ["note_read"]      # أدوات القراءة بس

# اختبر السيرفر قبل ما تعتمد عليه
hermes mcp test serena
hermes mcp configure serena

# OpenClaw: نفس السيرفر بنفس الفلاتر
openclaw mcp add serena --command node --arg /home/you/serena-mcp/index.js
openclaw mcp tools serena --include 'note_read'
openclaw mcp probe serena --json