دليل الوكيل
الذكي.
@aloun.pro
ahmad@aloun.pro
هذا مرجعك، لا واجبك.
لا تحتاج إلى حفظ ما في هذا الدليل، بل إلى معرفة أين تجده. صُمِّم لتفتحه في أثناء العمل — حين يكون أمامك agent يكاد يعمل، وتحتاج إلى الملاحظة الحاسمة، أو نقطة النهاية الصحيحة، أو القالب الذي يُصلح المشكلة.
رُتِّب وفق التسلسل الذي ستحتاجه فعلاً: المفاهيم التي تُرسّخ تفكيرك، ثم دورة البناء والإطلاق التي تحوّل التصميم إلى منتجٍ حقيقي، ثم كتالوجٌ مفصّل للخدمات التي تمنح وكيلك يدين يعمل بهما في العالم، ثم مثالٌ تطبيقي يجمع ذلك كلّه، وأخيراً رفُّ المراجع — المصطلحات، والقوالب، وحلّ المشكلات.
المفاهيم الأساسية
الأركان الأربعة
كلُّ agent — مهما بلغت بساطته أو تقدّمه — مبنيٌّ من الأجزاء الأربعة نفسها. وعند حدوث أيّ خلل، يكون غالباً في أحد هذه الأربعة.
العقل · الـ LLM
صاحب القرار. يقرأ الموقف ويختار الخطوة التالية. وهو النموذج (Claude, GPT, Gemini…).
الهدف · المهمة + النجاح
الغاية من وجود الـ agent، وكيف تعرف أنه نجح. بيان مهمة + معايير نجاح.
الأدوات · ما يستطيع فعله
الأفعال التي يستطيع تنفيذها في العالم — إرسال بريد، أو بحث، أو الكتابة في قاعدة بيانات، أو مراسلة شخص.
الذاكرة · ما يحمله معه
ما يتذكّره داخل المهمة، وعبر المهام. القصيرة هي المحادثة؛ والطويلة هي ما يجعله «يعرفك».
الدورة — يستقبل ← يفكّر ← ينفّذ
الـ agents لا تُجيب مرّةً ثم تتوقّف، بل تعمل في دورة: تقرأ المدخل، وتقرّر ما تفعله، وتنفّذه، وتفحص النتيجة، ثم تقرّر من جديد. هذه الدورة هي ما يفصل الـ agent عن الـ chatbot.
الـ Harness — ما يربط الكلّ
الـ harness هو النسيج الرابط: البيئة التي تَصِل العقل بأدواته وذاكرته وتُشغّل الدورة. ليس الـ LLM، وليس أداةً بعينها — بل ما يقع بينها ويجعلها تعمل كإطارٍ واحد. تخيّل آليّة ساعةٍ دقيقة: أجزاءٌ صغيرةٌ كثيرة، وحركةٌ واحدةٌ منسّقة.
الـ Blueprint — 5 أقسام
قبل أن تفتح أيّ أداة، تملأ blueprint من صفحةٍ واحدة. إنه التصميم المعماري لوكيلك. أتقِن ملأه، يغدُ البناء بسيطاً.
| # | القسم | ماذا يُجيب |
|---|---|---|
| 1 | بيان المهمة Task Statement | جملةٌ واحدة: ما الذي يفعله الـ agent بالضبط؟ محدّدة، وواضحة، وقابلة للتحقّق. |
| 2 | معايير النجاح Success Criteria | كيف نعرف أنه نجح؟ ما شكل المُخرَج المتوقَّع؟ وما معنى «الفشل»؟ |
| 3 | المدخلات Inputs | ما الذي يتلقّاه — نص، أو ملف، أو بريد، أو رسالة، أو رابط، أو صورة — ومن أين؟ |
| 4 | التعليمات Instructions | القواعد التي يتّبعها. الشخصية، والحدود، والنبرة. استهدِف 3-5 قواعد محدّدة. |
| 5 | الأدوات والذاكرة Tools + Memory | ما يحتاجه ليتصرّف، وما ينبغي أن يتذكّره عبر المرّات. |
من الـ Blueprint إلى البناء
جدول التحويل
لكلّ قسمٍ في الـ Blueprint موضعٌ واضحٌ في بيئة التشغيل.
| قسم الـ Blueprint | إلى أين ينتقل |
|---|---|
| بيان المهمة | الـ System prompt / حقل الهدف |
| معايير النجاح | مقياس التقييم + حالات الاختبار |
| المدخلات | إعداد الـ Trigger + صيغة المدخل |
| التعليمات | قواعد الـ System prompt + الحدود |
| الأدوات والذاكرة | اختيار الـ Skills + إعداد الذاكرة |
دورة البناء — الصادقة
أوّل تشغيلٍ سيكون خاطئاً. وهذا ليس فشلاً، بل هو المنهج ذاته. والقيمة تكمن في المحاولتين الثانية والثالثة.
التكرار — ثلاث محاولاتٍ مصقولة
اجعله يعمل
أثبِت أنه قادرٌ على إنجاز المهمة، ولو مرّةً واحدة.
اجعله موثوقاً
يُنجز المهمة في كلّ مرّة، ومع أيّ مدخل.
اجعله أنيقاً
يتعامل مع الحالات الصعبة والنبرة برشاقة.
قائمة الإطلاق
كتالوج الـ APIs والخدمات
أولاً — طريقتان للاتصال
تتّصل كلُّ خدمةٍ تقريباً بإحدى طريقتين، ومعرفة أيّهما توفّر عليك ساعات.
مفتاحٌ واحد. تنسخه من الخدمة وتلصقه في وكيلك. بسيطٌ ومباشر.
مصافحة. توافق على صلاحياتٍ محدّدة عبر نافذة تسجيل دخول. تُستخدم حين تحوي الخدمة بياناتٍ شخصية.
تتكفّل بيئة التشغيل (OpenClaw) بمعظم التفاصيل — وغالباً ما يقتصر دورك على الموافقة أو لصق المفتاح.
notion.so/profile/integrations، ثم شارِك الصفحة/القاعدة المستهدفة مع التكامل.POST /v1/pages · PATCH /v1/pages/{id} · POST /v1/databases/{id}/queryelevenlabs.io/app/settings/api-keys.POST /v1/text-to-speech/{voice_id} · POST /v1/voices/add · GET /v1/voiceseleven_multilingual_v2 أو eleven_v3. جرّب كليهما — الإصدار v3 أغنى نبرةً، وأحياناً يقرأ v2 الفصحى ذات النكهة الخليجية على نحوٍ أطبع.voice_id.توقف تُوقف الـ agent.بقيّة صندوق الأدوات
messages.list · .get · .send · .modifyevents.list · events.insert · freebusy.queryvalues.get · values.appendPOST /chat/completions (متوافق مع OpenAI)العقول — اختر نموذجك
النماذج: claude-opus-4-8، claude-sonnet-5، claude-haiku-4-5. الأفضل للسياق الطويل، والتعليمات الدقيقة, وجودة العربية.
النماذج: gpt-5، gpt-5-mini. الأفضل للسرعة، واتّساع المنظومة، والمُخرَج المنظَّم JSON.
قاعدة: Claude لكلّ ما يحتاج قراءةً كثيرة أو اتّباع قواعد دقيقة. وGPT للسرعة والاتّساع. لا تدفع زائداً — فأرخص نموذجٍ يجتاز المطلوب هو الصحيح. قارِن على benchlm.ai.
البنية التحتية والاستضافة
Resend
بريدٌ تشغيليٌّ من وكيلك — تأكيدات، وملخصات، وتنبيهات. تسليمٌ نظيف، وAPI بسيط. مجاني 3k/الشهر. resend.com/docs
Cloudflare
Workers + D1 (قاعدة بيانات، ممتازة للذاكرة) + R2 (تخزين ملفات). تُشغّل منظومةً شخصية بنحو 0$. developers.cloudflare.com
Zapier · Make · n8n
جرّب التدفّق قبل بنائه على نحوٍ متقن. n8n = استضافةٌ ذاتية مع كودٍ عند الحاجة؛ وMake = وضوحٌ بصري؛ وZapier = أكثر تكاملات.
Telegram Bot
bots بلا احتكاك — ودون توثيق أعمال. راسِل @BotFather للحصول على الرمز. ممتازٌ للأدوات الداخلية. core.telegram.org/bots
توليد الصور والفيديو
مثالٌ تطبيقي
الـ Blueprint، مملوءاً
1 · بيان المهمة
كلّ صباحٍ في السابعة بتوقيت الكويت، اقرأ بريدي الجديد منذ الأمس، واستخرج ما يحتاج انتباهي، واحفظ ملخّصاً منظَّماً في Notion، وأرسل لي ملاحظةً صوتية قصيرة عبر WhatsApp.
2 · معايير النجاح
ملاحظةٌ صوتية في WhatsApp قبل 7:05، وأقلّ من 90 ثانية. وفي قاعدة «Morning Briefs» صفٌّ جديد: التاريخ، وأهمّ 3 رسائل، ومهامّ. يفشل إذا: صنّف شيئاً عاجلاً وهو غير عاجل، أو فوّت شيئاً عاجلاً فعلاً، أو عمل بعد 7:15.
3 · المدخلات
Gmail — الرسائل التي وصلت بعد السادسة مساء أمس. وصفحة «Contexts» في Notion — مَن المهم، وأيّ المشاريع نشطة.
4 · التعليمات
5 · الأدوات والذاكرة
الأدوات: Gmail (قراءة)، وNotion (قراءة + كتابة)، وElevenLabs (TTS، صوتٌ مستنسَخ)، وOpenClaw WhatsApp (إرسال). الذاكرة: قاعدة «Contexts» (طويلة) + آخر 7 ملخّصات يومية (قصيرة، كي لا يكرّر نفسه).
المعمارية
المصطلحات
| المصطلح | بالعربية | في سطر |
|---|---|---|
| Agent | وكيل | نظام ذكاءٍ اصطناعي يقرّر ويتصرّف نحو هدف. |
| API | واجهة برمجية | الطريقة التي يتحدّث بها برنامجٌ إلى آخر. |
| Context window | نافذة السياق | أقصى نصٍّ يستطيع النموذج استحضاره دفعةً واحدة. |
| Embedding | تمثيل رقمي | تمثيلٌ رقميٌّ للمعنى؛ يُشغّل البحث. |
| Fine-tuning | تخصيص النموذج | إعادة تدريب النموذج على بياناتك. نادراً ما يحتاجه الوكيل. |
| Function calling | استدعاء الأدوات | كيف يُشغّل الـ LLM أداةً. |
| Guardrail | حدّ أمان | قاعدةٌ لا يتجاوزها الوكيل. |
| Hallucination | هلوسة | أن يختلق النموذج شيئاً بثقة. |
| Harness | الإطار | البيئة التي تربط العقل والأدوات والذاكرة. |
| Latency | زمن الاستجابة | المدّة التي يستغرقها الطلب. |
| LLM | نموذج لغوي كبير | النموذج اللغوي الكبير — العقل. |
| Memory | ذاكرة | قصيرة: داخل الجلسة. طويلة: عبر الجلسات. |
| Prompt | التعليمات | ما تقوله للنموذج. |
| RAG | استرجاعٌ معزّز | تزويد النموذج بمستنداتك وقت السؤال. |
| Rate limit | حدّ الاستدعاءات | أقصى عددٍ من الطلبات في وحدة زمن. |
| System prompt | تعليمات النظام | التعليمات الدائمة — شخصية الوكيل. |
| Temperature | درجة العشوائية | 0 = حتمي، و1 = إبداعي. |
| Token | رمز | نحو 3-4 أحرف. وحدة الحساب. |
| Tool | أداة | شيءٌ يستطيع الوكيل فعله (يرسل، أو يبحث، أو يحفظ…). |
| Vector DB | قاعدة متجهات | حيث تعيش الـ embeddings. تُشغّل الـ RAG. |
| Webhook | خطاف ويب | رابطٌ يُنبَّه عند وقوع حدثٍ في مكانٍ آخر. |
قوالب التعليمات
هيكل الـ System Prompt
YOU ARE: [role, in one line] YOUR JOB: [task statement — Blueprint §1] YOUR SUCCESS: [criteria — Blueprint §2] INPUTS YOU RECEIVE: - [type 1] - [type 2] RULES (must follow): 1. [rule] 2. [rule] 3. [rule] TOOLS AVAILABLE: - [tool]: use when [condition] - [tool]: use when [condition] WHEN IN DOUBT: [the fallback] NEVER: [the hard no]
كتلة النبرة / الصوت
TONE: [warm / formal / playful]
LANGUAGE: [Arabic (Kuwaiti-MSA) /
English / bilingual]
LENGTH: [terse / medium / thorough]
NEVER USE: [banned words]
كتلة المراجعة الذاتية (مهمّةٌ جداً للموثوقية)
BEFORE OUTPUTTING, CHECK: - Does this meet every success criterion? - Have I followed all rules? - Am I inventing anything? If unsure, say so. If any check fails, revise.
كتلة المراجعة الذاتية وحدها تُصلح من مشكلات الموثوقية أكثر من أيّ ترقية نموذج. دَعِ الـ agent يصحّح نفسه قبل أن يتكلّم.
حلّ المشكلات
| العَرَض | السبب المحتمل | جرّب هذا |
|---|---|---|
| يتجاهل تعليمة | التعليمة مدفونةٌ في الـ prompt | حرّكها إلى الأعلى، وعلّمها بـ RULE: |
| المُخرَج طويل | لا قيد على الطول | أضف «بحدٍّ أقصى N جملة». |
| يهلوس حقائق | لا تأريض | أضف RAG، أو اطلب منه أن يقول «لا أعرف». |
| يستخدم أداةً خاطئة | وصف الأدوات غامض | أعد كتابة «متى تُستخدم» لكلّ أداة. |
| يعمل بلا توقّف | لا شرط توقّف | أضف «STOP عند X» إلى الـ system prompt. |
| ممتازٌ في التجربة، سيّئٌ في الواقع | السياق الحقيقي مختلف | سجّل المدخلات الحقيقية وأعِد تشغيلها. |
| خطأ 429 | حدّ الاستدعاء | أضف إعادة محاولةٍ مع تأخيرٍ تصاعدي. |
| خطأ 401 | المصادقة | بدّل المفتاح، وتحقّق من متغيّرات البيئة. |
| Notion 404 | الصفحة غير مُشارَكة مع التكامل | شارِكها مع التكامل. |
| قالب WhatsApp مرفوض | مراجعة Meta (Cloud API) | بسّط المتغيّرات، وتجنّب اللغة الترويجية. |
المصادر والخطوات القادمة
مُوصىً بها لك
benchlm.ai
قارِن الـ LLMs على مهامَّ حقيقية. اختر عقلك بالدليل، لا بالضجيج.
awesome-openclaw-skills
مهاراتٌ جاهزة من المجتمع — استخدمها بدل الكتابة من الصفر. github.com/VoltAgent
openclaw-security-practice-guide
أنماط أمان. اقرأها قبل إطلاق أيّ شيءٍ حقيقي. github.com/slowmist
designarena.ai
ساحة مقارنةٍ تفاعلية لأدوات AI الحديثة.
🌙 مهارات الوكلاء العربية · ArabAgentSkills
مجموعة مهاراتٍ جاهزة مصمّمة للسياق العربي ومنطقة الشرق الأوسط — بوّابات الدفع المحلية، والفوترة الإلكترونية، والهوية، واللوجستيات، ومعالجة اللغة العربية، إضافةً إلى معايير كتابةٍ ومحتوى. مرجعٌ ثمين حين تبني وكلاء لجمهورٍ عربي. github.com/ArabAgentSkills/Skills
وثائقٌ تفتحها أسبوعياً
| Notion API | developers.notion.com | Anthropic | docs.anthropic.com |
| ElevenLabs | elevenlabs.io/docs | OpenAI | platform.openai.com |
| WhatsApp Cloud | developers.facebook.com | Cloudflare | developers.cloudflare.com |
ماذا تفعل هذا الأسبوع
The AI Agent
Manual.
@aloun.pro
ahmad@aloun.pro
This is your reference,
not your homework.
You don't need to memorize what's in here. You need to know where to find it. This manual is built to be opened mid-build — when you're staring at an agent that almost works and you need the one gotcha, the right endpoint, or the prompt pattern that fixes it.
It's organized in the order you'll actually reach for it: the concepts to ground your thinking, the build-and-ship loop to turn a design into something real, a deep catalog of the services that give your agent hands in the world, a worked example that stitches it all together, and then the reference shelf — glossary, prompt templates, and troubleshooting.
Core Concepts
The 4 Building Blocks
Every agent — no matter how simple or advanced — is made of the same four parts. When something breaks, it's almost always one of these four.
Brain · the LLM
The decision-maker. Reads the situation and chooses the next step. This is the model (Claude, GPT, Gemini…).
Goal · task + success
What the agent is for, and how you'll know it worked. A task statement plus success criteria.
Tools · what it can do
The actions it can take in the world — send email, search, write to a database, message a person.
Memory · what it carries
What it remembers within a task, and across tasks. Short-term is the conversation; long-term is what makes it “know you.”
The Loop — Perceive → Think → Act
Agents don't answer once and stop. They run in a cycle: read the input, decide what to do, do it, look at the result, and decide again. That cycle is what separates an agent from a chatbot.
The Harness — what holds it together
The harness is the connective tissue: the runtime that wires the Brain to its Tools and Memory and runs the loop. It's not the LLM, and it's not any single tool — it's what sits between them and makes them work as one framework. Think of a precision watch mechanism: many small parts, one coordinated movement.
The Blueprint — 5 sections
Before you open any tool, you fill a one-page blueprint. This is the architectural design of your agent. Fill it well and the build is simple.
| # | Section | What it answers |
|---|---|---|
| 1 | Task Statement | One sentence: what does the agent do, exactly? Specific, clear, verifiable. |
| 2 | Success Criteria | How will we know it worked? What does the output look like? What counts as failure? |
| 3 | Inputs | What does it receive — text, file, email, message, link, image — and from where? |
| 4 | Instructions | The rules it follows. Personality, boundaries, tone. Aim for 3–5 specific rules. |
| 5 | Tools + Memory | What it needs to act, and what it must remember across runs. |
From Blueprint to Build
The Translation Table
Each blueprint section maps cleanly to where it lives in your agent runtime.
| Blueprint section | Where it lands |
|---|---|
| Task Statement | System prompt / goal input |
| Success Criteria | Evaluation rubric + your test cases |
| Inputs | Trigger configuration + input schema |
| Instructions | System prompt rules + guardrails |
| Tools + Memory | Skill selections + memory store config |
The Build Loop — the honest one
Your first run will be wrong. That's not failure — it's the process. The value lives in the second and third pass.
Iteration — the three refined prototypes
Make it work
Prove it can do the task at all, even once.
Make it reliable
It does the task every time, on any input.
Make it tasteful
It handles edge cases and tone with grace.
The Shipping Checklist
APIs & Services Catalog
First, the two ways things connect
Almost every service authenticates one of two ways. Knowing which is which saves hours.
A single secret. Copy the key from the service, paste it into your agent. Simple and direct.
A handshake. You approve specific permissions through a login window. Used when the service holds personal data.
Your runtime (OpenClaw) handles most of the plumbing — you mostly just approve, or paste the key.
notion.so/profile/integrations, then share the target page/database with the integration.POST /v1/pages · PATCH /v1/pages/{id} · POST /v1/databases/{id}/queryelevenlabs.io/app/settings/api-keys.POST /v1/text-to-speech/{voice_id} · POST /v1/voices/add · GET /v1/voiceseleven_multilingual_v2 or eleven_v3. Test both — v3 has richer prosody, v2 sometimes reads Gulf-flavored MSA more naturally.voice_id.توقف / stop that pauses the agent.The rest of the toolkit
messages.list · .get · .send · .modifyevents.list (timeMin/Max) · events.insert · freebusy.queryvalues.get · values.append (batch rows)POST /chat/completions (OpenAI-compatible)The Brains — pick your model
Models: claude-opus-4-8, claude-sonnet-5, claude-haiku-4-5. Best for long context, nuanced instructions, and Arabic quality.
Models: gpt-5, gpt-5-mini. Best for speed, broad ecosystem, and structured JSON output.
Rule of thumb: Claude for anything that must read a lot or follow subtle rules. GPT for speed and breadth. Don't overpay — the cheapest model that clears the bar is the right one. Compare on benchlm.ai.
Plumbing & Hosting
Resend
Transactional email from your agent — confirmations, digests, alerts. Clean deliverability, simple API. Free 3k/mo. resend.com/docs
Cloudflare
Workers (edge functions) + D1 (SQLite, great for memory) + R2 (file storage, no egress fees). Runs a personal agent stack for ~$0. developers.cloudflare.com
Zapier · Make · n8n
Prototype a flow before building it properly. n8n = self-hosted + code-when-needed; Make = visual clarity; Zapier = most integrations.
Telegram Bot
Zero-friction bots — no business verification. Talk to @BotFather for a token. Great for internal tools and personal notifications. core.telegram.org/bots
Image & Video Generation
Worked Example
The blueprint, filled in
1 · Task Statement
Every morning at 7:00 Kuwait time, read my new emails since yesterday, extract what needs my attention, save a structured digest to Notion, and send me a short voice note via WhatsApp.
2 · Success Criteria
Voice note in WhatsApp by 7:05, under 90 seconds. Notion “Morning Briefs” has a new row: date, top 3 emails, action items. Fails if it flags a non-urgent item as urgent, misses a truly urgent one, or runs after 7:15.
3 · Inputs
Gmail — messages received after 6 PM yesterday. Notion “Contexts” page — who's important, which projects are live.
4 · Instructions
5 · Tools + Memory
Tools: Gmail (read), Notion (read + write), ElevenLabs (TTS, cloned voice), OpenClaw WhatsApp (send). Memory: Notion “Contexts” DB (long-term) + the previous 7 daily briefs (short-term, to avoid repeating itself).
The architecture
Glossary
| Term | العربية | In one line |
|---|---|---|
| Agent | وكيل | An AI system that decides and acts toward a goal. |
| API | واجهة برمجية | The way one program talks to another. |
| Context window | نافذة السياق | The max text a model can hold in mind at once. |
| Embedding | تمثيل رقمي | A numeric representation of meaning; powers search. |
| Fine-tuning | تخصيص النموذج | Retraining a model on your data. Rarely needed for agents. |
| Function calling | استدعاء الأدوات | How the LLM triggers a tool. |
| Guardrail | حد أمان | A rule the agent must not cross. |
| Hallucination | هلوسة | When the model confidently makes something up. |
| Harness | الإطار | The runtime that wires Brain + Tools + Memory. |
| Latency | زمن الاستجابة | How long a request takes. |
| LLM | نموذج لغوي كبير | Large Language Model — the Brain. |
| Memory (short/long) | ذاكرة قصيرة/طويلة | Short: within a run. Long: across runs. |
| Prompt | التعليمات | What you tell the model. |
| RAG | استرجاع معزّز | Give the model your documents at query time. |
| Rate limit | حد الاستدعاءات | Max requests per unit of time. |
| System prompt | تعليمات النظام | The always-on instructions — the agent's personality. |
| Temperature | درجة العشوائية | 0 = deterministic, 1 = creative. |
| Token | رمز | ~3–4 characters of text. The billing unit. |
| Tool | أداة | Something the agent can do (send, search, save…). |
| Vector DB | قاعدة متجهات | Where embeddings live. Powers RAG. |
| Webhook | خطاف ويب | A URL pinged when something happens elsewhere. |
Prompt Templates
The System Prompt skeleton
YOU ARE: [role, in one line] YOUR JOB: [task statement — from Blueprint §1] YOUR SUCCESS: [criteria — from Blueprint §2] INPUTS YOU RECEIVE: - [type 1] - [type 2] RULES (must follow): 1. [rule] 2. [rule] 3. [rule] TOOLS AVAILABLE: - [tool]: use when [condition] - [tool]: use when [condition] WHEN IN DOUBT: [the fallback] NEVER: [the hard no]
The tone / voice block
TONE: [warm / formal / playful]
LANGUAGE: [Arabic (Kuwaiti-MSA) /
English / bilingual]
LENGTH: [terse / medium / thorough]
NEVER USE: [banned words]
The self-review block (huge for reliability)
BEFORE OUTPUTTING, CHECK: - Does this meet every success criterion? - Have I followed all rules? - Am I inventing anything? If unsure, say so. If any check fails, revise.
The self-review block alone will fix more reliability problems than any model upgrade. Make the agent grade itself before it speaks.
Troubleshooting
| Symptom | Likely cause | Try this |
|---|---|---|
| Ignores an instruction | Instruction buried in the prompt | Move it to the top, mark it RULE: |
| Output too long | No length constraint | Add “Max N sentences.” |
| Hallucinates facts | No grounding | Add RAG, or tell it to say “I don't know.” |
| Wrong tool used | Ambiguous tool descriptions | Rewrite each tool's “use when.” |
| Runs forever / loops | No stop condition | Add “STOP when X” to the system prompt. |
| Great in dev, bad live | Real context differs | Log real inputs, replay them. |
| API error 429 | Rate limit | Add retries with backoff. |
| API error 401 | Auth | Rotate the key, check env vars. |
| Notion 404 | Page not shared with integration | Share it with the integration. |
| WhatsApp template rejected | Meta review (Cloud API) | Simplify variables, avoid promo language. |
Resources & Next Steps
Recommended for you
benchlm.ai
Compare LLMs on real tasks. Pick your Brain by evidence, not hype.
awesome-openclaw-skills
Community-built skills — reuse instead of writing from scratch. github.com/VoltAgent
openclaw-security-practice-guide
Safety patterns. Read before you ship anything real. github.com/slowmist
designarena.ai
Interactive comparison arena for modern AI tools.
🌙 Arab Agent Skills
Agent-ready skills built for the Arab / MENA region — local payment gateways, e-invoicing, identity, logistics, and Arabic NLP, plus writing and content standards. The reference to keep when you build agents for an Arabic audience. github.com/ArabAgentSkills/Skills
Docs you'll open weekly
| Notion API | developers.notion.com | Anthropic | docs.anthropic.com |
| ElevenLabs | elevenlabs.io/docs | OpenAI | platform.openai.com/docs |
| WhatsApp Cloud | developers.facebook.com/docs/whatsapp | Cloudflare | developers.cloudflare.com |