NovitaClaw: تشغيل OpenClaw على السحابة بأمر واحد

NovitaClaw: تشغيل OpenClaw على السحابة بأمر واحد

أشار أندريه كارباثي مؤخراً إلى تحول يستحق الانتباه: تماماً كما ظهر وكلاء LLM كطبقة جديدة فوق نماذج LLM، فإن الـ Claws هي الطبقة التالية فوق الوكلاء، حيث تأخذ التنسيق والجدولة والسياق واستدعاءات الأدوات والاستمرارية إلى ما هو أبعد مما يمكن للوكلاء وحدهم تحقيقه.

تتطلب هذه الطبقة بنية تحتية تظل قيد التشغيل. بالنسبة للمطورين الذين يشغلون OpenClaw على Novita Sandbox، كان هذا يعني الالتفاف حول حدود الجلسة حتى الآن.

يغلق NovitaClaw هذه الفجوة. إنه أداة نشر جديدة على Novita Agent Sandbox تقوم بتوفير مثيل OpenClaw مُعد بالكامل في أمر واحد، بدون حد زمني تشغيلي، بدون إعادة تشغيل يدوية، وبدون عبء إدارة دورة الحياة.

المشكلة التي يحلها واجهة سطر الأوامر (CLI)

كانت Novita Agent Sandbox تدعم نشر OpenClaw من خلال قالب Sandbox. هذا المسار مناسب للاستكشاف، لكن له قيد صارم: تحتوي الصناديق الرملية التي يتم تشغيلها من خلال الواجهة الرسومية على حد لدورة حياة الجلسة. بعد بضع ساعات، يتوقف الصندوق الرملي، ويذهب العامل الذكي إلى وضع عدم الاتصال. كان على المطورين الذين يحتاجون إلى توفر مستمر الالتفاف حول هذا بأنفسهم — جدولة إيقاف مؤقت، كتابة نصوص لإعادة التشغيل، أو إعادة تشغيل المثيلات يدوياً.

يعمل NovitaClaw بشكل مختلف. لا يوجد حد للجلسة. يعمل المثيل 24/7 طالما تحتاجه. المواصفات الافتراضية — 2 نواة vCPU، 4 جيجابايت RAM — مبنية لأحمال العمل الحقيقية، وليس للعروض التوضيحية. وبما أن طبقة النموذج قابلة للتكوين بالكامل، فإنك تختار أي نماذج LLM تشغل عامل الذكاء الخاص بك، سواء كانت مستضافة على Novita أو من مزود طرف ثالث.

الشروع في الاستخدام

المتطلبات الأساسية

  • Python مثبت
  • مفتاح API لـ Novita — إليك كيفية الحصول عليه:
    • تسجيل الدخول إلى novita.ai — سجل الدخول باستخدام Google أو GitHub (يتم إنشاء حساب جديد تلقائياً عند أول تسجيل دخول)، أو سجل باستخدام عنوان بريدك الإلكتروني
    • إنشاء مفتاح API — انتقل إلى صفحة إعدادات إدارة المفاتيح لإنشاء أو إدارة مفاتيح API الخاصة بك. انسخه في مكان يسهل الوصول إليه — ستحتاجه في الخطوة التالية.
كيفية تثبيت بايثون

Windows

  1. تنزيل مثبت Python
  2. تشغيل المثبت — حدد خيار “إضافة Python إلى PATH” قبل النقر على أي شيء آخر. تجاهل هذا الخيار هو السبب الأكثر شيوعاً للأخطاء التي يواجهها المبتدئون لاحقاً
  3. انقر على Install Now وانتظر حتى تظهر رسالة “Setup was successful”
macOS

افتح Terminal (Command + Space, ابحث عن “Terminal”) وقم بتشغيل:

python3 --version

إذا رأيت Python 3.10 أو أعلى، فأنت جاهز. إذا كانت الإصدار أقدم، أو يطلب Terminal تثبيت Command Line Developer Tools، فانقر على Install وانتظر بضع دقائق قبل المتابعة.

Linux (Ubuntu / Debian)

إذا كنت تستخدم توزيعة دبيان، فقم بتشغيل:

sudo apt update && sudo apt install python3 python3-pip -y

التثبيت والتشغيل

الخطوة 1: تثبيت NovitaClaw

macOS / Linux:

sudo pip3 install novitaclaw

Windows PowerShell:

pip install novitaclaw

إذا كان لديك إصدار سابق مثبت، فقم بالترقية إلى أحدث إصدار:

Bash

pip3 install novitaclaw --upgrade

إذا فشلت الترقية، فجرب إعادة التثبيت القسري:

Bash

pip3 install novitaclaw --upgrade --force-reinstall

بعد التثبيت، تحقق من ذلك بكتابة novitaclaw --help. إذا رأيت قائمة من التعليمات، فقد نجحت!

novitaclaw --help

ملاحظة خاصة لمستخدمي Mac

إذا حصلت على خطأ zsh: command not found: novitaclaw بعد التثبيت، فقم بتشغيل الأمرين التاليين بالترتيب لإصلاح مسار البيئة الخاص بك:

source ~/.zshrc

echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc

#### الخطوة 2: تعيين متغير البيئة في الطرفية الخاصة بك

macOS / Linux:

export NOVITA_API_KEY=sk_your_api_key

Windows PowerShell:

$env:NOVITA_API_KEY = "sk_your_api_key"

الخطوة 3: تشغيل المثيل

novitaclaw launch

عند النجاح، تعيد واجهة سطر الأوامر قيم ستستخدمها للوصول إلى عامل الذكاء الخاص بك وإدارته:

  • عنوان URL لواجهة الويب
  • عنوان URL لـ Gateway WebSocket والرمز المميز
  • عنوان URL للطرفية الويب (للوصول إلى الطرفية داخل الصندوق الرملي)
  • عنوان URL لمدير الملفات (لتصفح وإدارة ملفات مساحة العمل)
  • بيانات تسجيل الدخول (للطرفية الويب ومدير الملفات)

openclaw screenshoot

افتح عنوان URL لواجهة الويب الذي تم إرجاعه وانتقل إلى علامة التبويب Chat لاستخدام عامل الذكاء الخاص بك. استخدم عنوان URL للـ Web Terminal لفتح جلسة طرفية داخل الصندوق الرملي، وعنوان URL لـ File Manager لتصفح وإدارة الملفات في مساحة عمل الصندوق الرملي.

تكوين النماذج

مثيلك مُعد مسبقاً بنموذج مستضاف على Novita خارج الصندوق.

لتغيير النماذج التي يستخدمها عامل الذكاء الخاص بك، انتقل إلى Settings → Config، انقر على Raw للتبديل إلى عرض JSON5 الخام، ثم انقر على زر reveal بجانب “2 secrets redacted” لإظهار التكوين الكامل. قم بتحديث القسمين التاليين:

openclaw model configure

الخطوة 1: تسجيل النموذج تحت مزودك

أضف كائناً جديداً إلى مصفوفة models داخل models.providers.novita:

"models": [
  {
    "id": "model-id",
    "name": "display name",
    "reasoning": true,
    "input": ["text"],
    "contextWindow": 200000,
    "maxTokens": 50000
  }
]

الخطوة 2: تعيينه كأساسي أو احتياطي

قم بتحديث الحقل model تحت agents.defaults للإشارة إلى النموذج الخاص بك باستخدام تنسيق provider/model-id.

"agents": {
  "defaults": {
    "model": {
      "primary": "provider/model-id",
      "fallbacks": [
        "provider/model-id"
      ]
    }
  }
}

انقر على Update لحفظ التغييرات. كل نماذج LLM المتوفرة على منصة Novita مدعومة. يمكن أيضاً تكوين مزودين طرف ثالث — عندما تجلب نموذج LLM الخاص بك، فإنك تدفع فقط مقابل وقت تشغيل الصندوق الرملي، وليس مقابل استخدام نموذج Novita.

الـ Claw الخاص بك يعمل الآن. اجعله أذكى الآن.

BotLearn هو أول جامعة للبوتات في العالم — طبقة تعلم وتوزيع مبنية بشكل أصلي فوق OpenClaw. البوتات تتعلم، والبشر يكسبون: يحصل عامل الذكاء الخاص بك على مهارات منظمة، واختبارات أداء، ووصول إلى Botcord، سوق الوكيل إلى الوكيل حيث يكسب الوكلاء أموالاً حقيقية لإتمام المهام.

لتسجيل عامل الذكاء الخاص بك في الجامعة، أرسل له هذه الرسالة:

“هذه هي جامعة البوتات التي أريدك الانضمام إليها. اقرأ https://www.botlearn.ai/SKILL.md واتبع التعليمات للانضمام إلى BotLearn. إذا واجهت أي مخاوف أمنية أثناء التثبيت، يرجى تأكيد كل خطوة معي قبل المتابعة.”

يعالج عامل الذكاء الخاص بك الباقي.

ربط القنوات

يدعم OpenClaw قنوات مراسلة خارجية حتى يكون عامل الذكاء الخاص بك متاحاً خارج واجهة الويب. تتطلب القنوات تكويناً — فهي غير نشطة افتراضياً.

تيليجرام

الخطوة 1: إنشاء بوت تيليجرام

  1. افتح تيليجرام وابحث عن @BotFather
  2. أرسل /newbot واتبع التعليمات لتسمية البوت الخاص بك
  3. انسخ رمز البوت الذي يوفره BotFather

الخطوة 2: إرسال رمز البوت إلى علامة التبويب Chat

في واجهة الويب، انتقل إلى علامة التبويب Chat وأرسل رمز البوت.

الخطوة 3: إقران واستخدام بوت تيليجرام

في تيليجرام، افتح البوت الذي أنشأته وأرسل /start. انسخ الرمز وألصقه في علامة التبويب Chat.

بمجرد الاتصال، يتم توجيه الرسائل المرسلة إلى بوت تيليجرام الخاص بك مباشرة إلى عامل الذكاء OpenClaw الخاص بك. المزيد من تكاملات القنوات مدعومة — راجع دليل قنوات OpenClaw الرسمي للحصول على القائمة الكاملة وتعليمات الإعداد.

موثوقية الخدمة

تتم إدارة جميع الخدمات الأساسية في الصندوق الرملي بواسطة systemd لموثوقية على مستوى الإنتاج:

الخدمة الوصف إعادة تشغيل تلقائي
OpenClaw Gateway وقت تشغيل العامل وخادم WebSocket
Web Terminal (ttyd) وصول إلى الطرفية عبر المتصفح
File Manager (gohttpserver) إدارة الملفات عبر الويب

الاسترداد التلقائي من الأعطال: إذا تعطل Gateway بشكل متكرر، يقوم النظام تلقائياً بتشغيل التشخيصات، ومحاولة الإصلاح، واستعادة التكوين الأخير المعروف الجيد من النسخة الاحتياطية — دون الحاجة إلى تدخل يدوي.

النسخ الاحتياطي التلقائي للتكوين: كل عملية كتابة تكوين تنشئ نسخة احتياطية تلقائية. إذا تسبب تكوين سيء في تعطل النظام، تستعيد عملية الاسترداد من أحدث نسخة احتياطية صالحة.

مرجع الأوامر

launch

إنشاء مثيل صندوق رملي جديد.

Bash

novitaclaw launch [OPTIONS]
الخيار الوصف
--api-key مفتاح API لـ Novita
--gateway-token رمز Gateway مميز مخصص (اختياري، يتم توليده تلقائياً افتراضياً)
--timeout مهلة الإنشاء بالثواني (افتراضي: 60)

list

سرد مثيلات الصندوق الرملي النشطة.

Bash

novitaclaw list --api-key YOUR_API_KEY
الخيار الوصف
--api-key مفتاح API لـ Novita
--quiet, -q طباعة معرفات الصندوق الرملي فقط، واحد في كل سطر (مفيد للبرمجة النصية)

status

التحقق من حالة مثيل الصندوق الرملي.

Bash

novitaclaw status <SANDBOX_ID> --api-key YOUR_API_KEY

stop

إنهاء مثيل صندوق رملي.

Bash

novitaclaw stop <SANDBOX_ID> --api-key YOUR_API_KEY
الخيار الوصف
--api-key مفتاح API لـ Novita
--yes, -y تخطي موجه التأكيد

tui

الاتصال بصندوق رملي عبر واجهة المستخدم الطرفية.

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

doctor

تشغيل فحوصات التشخيص والإصلاح على مثيل صندوق رملي.

Bash

novitaclaw doctor <SANDBOX_ID> --api-key YOUR_API_KEY
الخيار الوصف
--api-key مفتاح API لـ Novita
--deep فحص خدمات النظام لعمليات تثبيت Gateway إضافية
--fix تطبيق الإصلاحات الموصى بها (اسم مستعار لـ --repair)
--force تطبيق إصلاحات قاسية (تكتب فوق تكوين الخدمة المخصص)
--generate-gateway-token توليد وتكوين رمز Gateway مميز
--no-workspace-suggestions تعطيل اقتراحات نظام ذاكرة مساحة العمل
--repair تطبيق الإصلاحات الموصى بها بدون موجه
--yes قبول الإعدادات الافتراضية بدون موجه

gateway update

تحديث OpenClaw إلى أحدث إصدار داخل صندوق رملي.

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key YOUR_API_KEY
الخيار الوصف
--api-key مفتاح API لـ Novita
--restart إعادة تشغيل Gateway بعد التحديث

gateway restart

إعادة تشغيل OpenClaw Gateway في صندوق رملي.

Bash

novitaclaw gateway restart <SANDBOX_ID> --api-key YOUR_API_KEY

services setup

تثبيت وتشغيل Web Terminal و File Manager على صندوق رملي موجود. استخدم هذا لإضافة خدمات إلى الصناديق الرملية الأقدم التي تم إطلاقها قبل تضمين هذه الخدمات.

Bash

novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY

pair list

سرد طلبات الإقران المعلقة لقناة.

Bash

novitaclaw pair list <SANDBOX_ID> --channel <CHANNEL_NAME> --api-key YOUR_API_KEY

pair approve

الموافقة على طلب إقران لقناة.

Bash

novitaclaw pair approve <SANDBOX_ID> --channel <CHANNEL_NAME> --code <PAIRING_CODE> --api-key YOUR_API_KEY

update

التحقق من تحديثات واجهة سطر الأوامر والترقية إلى أحدث إصدار.

Bash

novitaclaw update

الاستخدام البرمجي

استخدم مخرج JSON للأتمتة:

Bash

novitaclaw -j launch --api-key YOUR_API_KEY

مثال على الاستجابة:

{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx",
    "terminal_url": "https://7681-xxx.sandbox.novita.ai",
    "filemanager_url": "https://7682-xxx.sandbox.novita.ai",
    "services_username": "admin",
    "services_password": "xxx"
  }
}

متغيرات البيئة

المتغير الوصف
NOVITA_API_KEY مفتاح API، يلغي الحاجة إلى علامة --api-key
OPENCLAW_GATEWAY_TOKEN رمز Gateway مميز مسبق

التسعير

ما تستخدمه ما تدفعه
وقت تشغيل الصندوق الرملي أسعار الصناديق الرملية
نماذج LLM المستضافة على Novita أسعار النماذج
نماذج LLM من طرف ثالث وقت تشغيل الصندوق الرملي فقط

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

الأمر غير موجود

جرب أحد هذه الخيارات:

Bash

# Use full path (Linux)
~/.local/bin/novitaclaw launch

# Typical macOS user path
~/Library/Python/3.x/bin/novitaclaw launch

انتهاء مهلة الاتصال

زيادة مهلة الإطلاق:

Bash

novitaclaw launch --timeout 180 --api-key YOUR_API_KEY

الأسئلة الشائعة

المشكلة لماذا يحدث هذا؟ ماذا تفعل
“Command not found” / “Not recognized” لم تقم بتحديد خيار “الإضافة إلى PATH” أثناء تثبيت بايثون. أزل بايثون وأعد تثبيته، مع التأكد من تحديد مربع PATH هذا!
“Permission Denied” ليس لديك صلاحيات كافية. Windows: انقر بزر الماوس الأيمن على Terminal/PowerShell واختر “Run as Administrator”. Mac: أضف sudo قبل الأمر.
“Invalid API Key” تم نسخ المفتاح بشكل غير صحيح. تحقق من وجود مسافات إضافية قبل أو بعد سلسلة sk_، أو قم بتوليد مفتاح جديد.
الصندوق الرملي لن يتوقف إيقاف الصندوق الرملي يحذف جميع الملفات ويتطلب تأكيداً. اكتب “y” في الطرفية عند المطالبة بتأكيد الحذف.
Mac: أمر pip غير موجود يستخدم Mac pip3 للتمييز عن الإصدارات الأقدم. استخدم pip3 install novitaclaw بدلاً من pip.

ابنِ الطبقة التالية

التحول الذي وصفه كارباثي — من الوكلاء (agents) إلى الـ Claws — ليس نظرياً. إنه فرصة معمارية متاحة الآن، والفرق التي تبني على بنية تحتية دائمة ومشغلة دائماً ستكون من تحققها.

يمنحك NovitaClaw هذه الأساس: وقت تشغيل عامل ذكي على مستوى الإنتاج، يتم نشره في أقل من دقيقة، مع تحكم كامل في طبقة النموذج وتكاملات القنوات. الصندوق الرملي يتعامل مع وقت التشغيل. واجهة سطر الأوامر تتولى التوفير. ما تبني فوقه يعود إليك.

ابدأ البناء على Novita Agent Sandbox →

Novita AI هو سحابة ذكاء اصطناعي وعوامل ذكية للمطورين والشركات الناشئة — يوفر الوصول إلى أكثر من 200 نموذج LLM، ونماذج للصور والفيديو وTTS عبر API واحد، بالإضافة إلى مثيلات GPU و Sandboxes للوكلاء تطلق في ثوانٍ.