سير عمل وقت تشغيل وكيل OpenClaw

مسار عمل سليم للعمل على وقت تشغيل وكيل OpenClaw في OpenClaw.

فحص الأنواع والتدقيق

• بوابة التحقق المحلية الافتراضية: pnpm check
• بوابة البناء: pnpm build عندما يمكن أن يؤثر التغيير في مخرجات البناء أو التحزيم أو حدود التحميل الكسول/الوحدات
• بوابة الهبوط الكاملة لتغييرات وقت تشغيل الوكيل: pnpm check && pnpm test

تشغيل اختبارات وقت تشغيل الوكيل

شغّل مجموعة اختبارات وقت تشغيل الوكيل مباشرةً باستخدام Vitest:

pnpm test \  "src/agents/agent-*.test.ts" \  "src/agents/embedded-agent-*.test.ts" \  "src/agents/agent-tools*.test.ts" \  "src/agents/agent-settings.test.ts" \  "src/agents/agent-tool-definition-adapter*.test.ts" \  "src/agents/agent-hooks/**/*.test.ts"

لتضمين تمرين المزوّد الحي:

OPENCLAW_LIVE_TEST=1 pnpm test src/agents/embedded-agent-runner-extraparams.live.test.ts

يغطي هذا مجموعات اختبارات الوحدات الرئيسية لوقت تشغيل الوكيل:

• src/agents/agent-*.test.ts
• src/agents/embedded-agent-*.test.ts
• src/agents/agent-tools*.test.ts
• src/agents/agent-settings.test.ts
• src/agents/agent-tool-definition-adapter.test.ts
• src/agents/agent-hooks/*.test.ts

الاختبار اليدوي

المسار الموصى به:

• شغّل Gateway في وضع التطوير:
  • pnpm gateway:dev
• شغّل الوكيل مباشرةً:
  • pnpm openclaw agent --message "Hello" --thinking low
• استخدم TUI لتصحيح الأخطاء تفاعليًا:
  • pnpm tui

بالنسبة إلى سلوك استدعاء الأدوات، اطلب إجراء read أو exec حتى تتمكن من رؤية بث الأدوات ومعالجة الحمولة.

إعادة تعيين نظيفة

توجد الحالة ضمن دليل حالة OpenClaw. الافتراضي هو ~/.openclaw. إذا كان OPENCLAW_STATE_DIR مضبوطًا، فاستخدم ذلك الدليل بدلاً من ذلك.

لإعادة تعيين كل شيء:

• openclaw.json للتكوين
• agents/<agentId>/agent/auth-profiles.json لملفات تعريف مصادقة النموذج (مفاتيح API + OAuth)
• credentials/ لحالة المزوّد/القناة التي لا تزال موجودة خارج مخزن ملف تعريف المصادقة
• agents/<agentId>/sessions/ لسجل جلسات الوكيل
• agents/<agentId>/sessions/sessions.json لفهرس الجلسات
• sessions/ إذا كانت المسارات القديمة موجودة
• workspace/ إذا كنت تريد مساحة عمل فارغة

إذا كنت تريد فقط إعادة تعيين الجلسات، فاحذف agents/<agentId>/sessions/ لذلك الوكيل. إذا كنت تريد الاحتفاظ بالمصادقة، فاترك agents/<agentId>/agent/auth-profiles.json وأي حالة مزوّد ضمن credentials/ في مكانها.

المراجع

• الاختبار
• بدء الاستخدام

ذات صلة

• بنية وقت تشغيل وكيل OpenClaw