Advanced setup
سير عمل وقت تشغيل وكيل OpenClaw
سير عمل المطوّر لبيئة تشغيل الوكيل (src/agents/) في مستودع OpenClaw.
التحقق من الأنواع والتدقيق
- بوابة التحقق المحلية الافتراضية:
pnpm check(التحقق من الأنواع، والتدقيق، وضوابط السياسات) - بوابة البناء:
pnpm buildعندما يمكن أن يؤثر التغيير في مخرجات البناء أو التحزيم أو حدود التحميل الكسول/الوحدات - بوابة التحقق الكاملة قبل الدفع:
pnpm build && pnpm check && pnpm check:test-types && pnpm test
تشغيل اختبارات بيئة تشغيل الوكيل
شغّل حزم اختبارات الوحدة لبيئة تشغيل الوكيل:
pnpm test \ "src/agents/agent-*.test.ts" \ "src/agents/embedded-agent-*.test.ts" \ "src/agents/agent-hooks/**/*.test.ts"يشمل نمط glob الأول أيضًا حزم agent-tools* وagent-settings و
agent-tool-definition-adapter*.
تُستبعد الاختبارات المباشرة من إعدادات اختبارات الوحدة؛ شغّلها عبر مغلّف
الاختبارات المباشرة (يضبط OPENCLAW_LIVE_TEST=1 ويتطلب بيانات اعتماد المزوّد):
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.tsالاختبار اليدوي
- شغّل Gateway في وضع التطوير (يتخطى اتصالات القنوات عبر
OPENCLAW_SKIP_CHANNELS=1):pnpm gateway:dev - شغّل دورة وكيل واحدة عبر Gateway:
pnpm openclaw agent --message "Hello" --thinking low - استخدم TUI لتصحيح الأخطاء تفاعليًا:
pnpm tui
لاختبار سلوك استدعاء الأدوات، اطلب إجراء read أو exec حتى تتمكن من مراقبة
تدفّق الأداة ومعالجة الحمولة.
إعادة الضبط إلى حالة نظيفة
توجد الحالة في دليل حالة OpenClaw: ~/.openclaw افتراضيًا، أو
$OPENCLAW_STATE_DIR عند تعيينه. المسارات التالية نسبية إلى ذلك الدليل:
| المسار | المحتويات |
|---|---|
openclaw.json |
الإعدادات |
state/openclaw.sqlite |
قاعدة بيانات حالة بيئة التشغيل المشتركة |
agents/<agentId>/agent/openclaw-agent.sqlite |
ملفات تعريف مصادقة النموذج لكل وكيل (مفاتيح API + OAuth) وحالة بيئة التشغيل |
credentials/ |
بيانات اعتماد المزوّد/القناة خارج مخزن ملفات تعريف المصادقة |
agents/<agentId>/sessions/ |
سجل النصوص المنسوخة ومصادر ترحيل الجلسات القديمة |
sessions/ |
مخزن جلسات الوكيل الواحد القديم (عمليات التثبيت القديمة فقط) |
workspace/ |
مساحة عمل الوكيل الافتراضي (تستخدم الوكلاء الإضافية workspace-<agentId>) |
احذف هذه المسارات لإجراء إعادة ضبط كاملة. لإعادة ضبط أضيق نطاقًا:
- الجلسات فقط: لا تحذف
agents/<agentId>/agent/openclaw-agent.sqlite؛ توجد صفوف الجلسات فيه إلى جانب حالة الوكيل الأخرى. استخدم/newأو/resetلبدء جلسة جديدة لمحادثة واحدة، وopenclaw sessions cleanupلصيانة الجلسات. - الاحتفاظ بالمصادقة: اترك
agents/<agentId>/agent/openclaw-agent.sqliteوcredentials/في موضعيهما.
لم تعد ملفات auth-profiles.json القديمة تُقرأ في وقت التشغيل؛
يستوردها openclaw doctor --fix إلى مخزن SQLite.
