جراد البحر

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Hook

​

لماذا

• استدعاء واحد بدلًا من عدة استدعاءات: يشغل OpenClaw استدعاء أداة Lobster واحدًا ويحصل على نتيجة منظمة.
• الموافقات مدمجة: توقف الآثار الجانبية (إرسال بريد إلكتروني، نشر تعليق) سير العمل حتى تتم الموافقة عليها صراحة.
• قابل للاستئناف: تعيد سير العمل المتوقفة رمزًا؛ وافق واستأنف دون إعادة تشغيل كل شيء.

​

لماذا DSL بدلًا من البرامج العادية؟

• الموافقة/الاستئناف مدمجان: يمكن لبرنامج عادي مطالبة إنسان، لكنه لا يستطيع الإيقاف المؤقت والاستئناف برمز دائم دون أن تخترع أنت وقت التشغيل هذا بنفسك.
• الحتمية + قابلية التدقيق: خطوط المعالجة بيانات، لذلك يسهل تسجيلها، ومقارنتها، وإعادة تشغيلها، ومراجعتها.
• سطح مقيد للذكاء الاصطناعي: قواعد صغيرة + تمرير JSON تقلل مسارات الكود “الإبداعية” وتجعل التحقق واقعيًا.
• سياسة الأمان مدمجة: حدود الوقت، وحدود الإخراج، وفحوصات وضع الحماية، وقوائم السماح يفرضها وقت التشغيل، لا كل سكربت.
• ما يزال قابلًا للبرمجة: يمكن لكل خطوة استدعاء أي CLI أو سكربت. إذا أردت JS/TS، فأنشئ ملفات .lobster من الكود.

​

كيف يعمل

​

النمط: CLI صغير + قنوات JSON + موافقات

inbox list --json
inbox categorize --json
inbox apply --json

{
  "action": "run",
  "pipeline": "exec --json --shell 'inbox list --json' | exec --stdin json --shell 'inbox categorize --json' | exec --stdin json --shell 'inbox apply --json' | approve --preview-from-stdin --limit 5 --prompt 'Apply changes?'",
  "timeoutMs": 30000
}

{
  "action": "resume",
  "token": "<resumeToken>",
  "approve": true
}

gog.gmail.search --query 'newer_than:1d' \
  | openclaw.invoke --tool message --action send --each --item-key message --args-json '{"provider":"telegram","to":"..."}'

​

خطوات LLM المعتمدة على JSON فقط (llm-task)

{
  "plugins": {
    "entries": {
      "llm-task": { "enabled": true }
    }
  },
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": { "alsoAllow": ["llm-task"] }
      }
    ]
  }
}

​

قيد مهم: Lobster المدمج مقابل openclaw.invoke

openclaw.invoke --tool llm-task --action json --args-json '{ ... }'

openclaw.invoke --tool llm-task --action json --args-json '{
  "prompt": "Given the input email, return intent and draft.",
  "thinking": "low",
  "input": { "subject": "Hello", "body": "Can you help?" },
  "schema": {
    "type": "object",
    "properties": {
      "intent": { "type": "string" },
      "draft": { "type": "string" }
    },
    "required": ["intent", "draft"],
    "additionalProperties": false
  }
}'

• استدعاء أداة llm-task مباشرًا خارج Lobster، أو
• خطوات غير openclaw.invoke داخل خط معالجة Lobster حتى تتم إضافة جسر مدمج مدعوم.

​

ملفات سير العمل (.lobster)

name: inbox-triage
args:
  tag:
    default: "family"
steps:
  - id: collect
    command: inbox list --json
  - id: categorize
    command: inbox categorize --json
    stdin: $collect.stdout
  - id: approve
    command: inbox apply --approve
    stdin: $categorize.stdout
    approval: required
  - id: execute
    command: inbox apply --execute
    stdin: $categorize.stdout
    condition: $approve.approved

• يمرر stdin: $step.stdout وstdin: $step.json إخراج خطوة سابقة.
• يمكن لـ condition (أو when) حجب الخطوات بناءً على $step.approved.

​

تثبيت Lobster

​

تفعيل الأداة

{
  "tools": {
    "alsoAllow": ["lobster"]
  }
}

{
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": {
          "alsoAllow": ["lobster"]
        }
      }
    ]
  }
}

​

مثال: فرز البريد الإلكتروني

User: "Check my email and draft replies"
→ openclaw calls gmail.list
→ LLM summarizes
→ User: "draft replies to #2 and #5"
→ LLM drafts
→ User: "send #2"
→ openclaw calls gmail.send
(repeat daily, no memory of what was triaged)

{
  "action": "run",
  "pipeline": "email.triage --limit 20",
  "timeoutMs": 30000
}

{
  "ok": true,
  "status": "needs_approval",
  "output": [{ "summary": "5 need replies, 2 need action" }],
  "requiresApproval": {
    "type": "approval_request",
    "prompt": "Send 2 draft replies?",
    "items": [],
    "resumeToken": "..."
  }
}

{
  "action": "resume",
  "token": "<resumeToken>",
  "approve": true
}

​

معاملات الأداة

​

run

{
  "action": "run",
  "pipeline": "gog.gmail.search --query 'newer_than:1d' | email.triage",
  "cwd": "workspace",
  "timeoutMs": 30000,
  "maxStdoutBytes": 512000
}

{
  "action": "run",
  "pipeline": "/path/to/inbox-triage.lobster",
  "argsJson": "{\"tag\":\"family\"}"
}

​

resume

{
  "action": "resume",
  "token": "<resumeToken>",
  "approve": true
}

​

مدخلات اختيارية

• cwd: دليل العمل النسبي لخط المعالجة (يجب أن يبقى داخل دليل عمل Gateway).
• timeoutMs: إيقاف سير العمل إذا تجاوز هذه المدة (الافتراضي: 20000).
• maxStdoutBytes: إيقاف سير العمل إذا تجاوز الإخراج هذا الحجم (الافتراضي: 512000).
• argsJson: سلسلة JSON تمرر إلى lobster run --args-json (ملفات سير العمل فقط).

​

غلاف الإخراج

• ok → انتهى بنجاح
• needs_approval → متوقف مؤقتًا؛ مطلوب requiresApproval.resumeToken للاستئناف
• cancelled → رُفض أو أُلغي صراحة

​

الموافقات

• approve: true → استئناف ومتابعة الآثار الجانبية
• approve: false → إلغاء وإنهاء سير العمل

​

OpenProse

​

السلامة

• محلي داخل العملية فقط - تنفذ سير العمل داخل عملية Gateway؛ لا يجري Plugin نفسه أي اتصالات شبكية.
• لا أسرار - لا يدير Lobster OAuth؛ بل يستدعي أدوات OpenClaw التي تفعل ذلك.
• واعٍ بوضع الحماية - معطل عندما يكون سياق الأداة داخل وضع حماية.
• معزز - يفرض المشغل المدمج حدود الوقت وحدود الإخراج.

​

استكشاف الأخطاء وإصلاحها

• lobster timed out → زد timeoutMs، أو قسّم خط معالجة طويلًا.
• lobster output exceeded maxStdoutBytes → ارفع maxStdoutBytes أو قلل حجم الإخراج.
• lobster returned invalid JSON → تأكد من أن خط المعالجة يعمل في وضع الأداة ويطبع JSON فقط.
• lobster failed → تحقق من سجلات Gateway لمعرفة تفاصيل خطأ المشغل المدمج.

​

تعلّم المزيد

• Plugins
• تأليف أدوات Plugin

​

دراسة حالة: سير عمل مجتمعية

• النقاش: https://x.com/plattenschieber/status/2014508656335770033
• المستودع: https://github.com/bloomedai/brain-cli

​

ذو صلة

• الأتمتة - جدولة سير عمل Lobster
• نظرة عامة على الأتمتة - جميع آليات الأتمتة
• نظرة عامة على الأدوات - جميع أدوات الوكيل المتاحة