اتصال MausBot به چابکان

MausBot یا OpenMausBot برنامه‌ای برای کار با چند دستیار AI است. می‌توانید اتصال چابکان را مستقیماً به‌عنوان یک موتور سازگار با OpenAI تعریف کنید؛ برای این روش، کلید API سرویس AI لازم است.

آماده‌سازی

طبق راهنمای شروع، سرویس و اعتبار مصرف را آماده کنید و یک کلید جدا برای MausBot بسازید. Model ID را از مدل‌های قابل استفاده بردارید.

تنظیم	مقدار
Driver	`openai-compat`
URL	`https://ai.chabokan.net/v1`
API Key	کلید سرویس AI چابکان
Model	شناسهٔ دقیق مدل موجود در سرویس

نصب و شروع

نسخهٔ دسکتاپ مناسب سیستم‌عامل را از صفحهٔ دانلود رسمی دریافت کنید. برای اجرای ترمینالی، با Node.js نسخهٔ ۲۴ یا جدیدتر:

npm install -g openmausbot
openmausbot

در راه‌اندازی اولیه، گزینهٔ سرویس API یا endpoint سازگار را انتخاب کنید. اتصال گوشی برای آزمون اولیه لازم نیست. اگر اتصال دستی می‌خواهید، برنامه را متوقف کنید و روش بخش بعد را انجام دهید. دستور openmausbot setup نیز تنظیم اولیه را دوباره باز می‌کند. راهنمای رسمی اجرای ترمینالی

تعریف موتور چابکان

فایل ~/.openmausbot/config.json را باز کنید و ورودی زیر را به بخش instances اضافه کنید. اگر فایل تنظیمات موجود است، سایر موتور‌ها و تنظیمات آن را نگه دارید.

{
  "instances": {
    "chabokan": {
      "driver": "openai-compat",
      "displayName": "Chabokan AI",
      "environment": {
        "CHABOKAN_AI_API_KEY": "sk-chbk-REPLACE_WITH_YOUR_KEY"
      },
      "config": {
        "url": "https://ai.chabokan.net/v1",
        "apiKeyEnv": "CHABOKAN_AI_API_KEY",
        "model": "YOUR_MODEL_ID"
      }
    }
  }
}

کلید نمونه و YOUR_MODEL_ID را جایگزین و برنامه را دوباره اجرا کنید. apiKeyEnv نام متغیر داخل environment است، نه خود کلید. اگر مسیر دادهٔ سفارشی تعیین کرده‌اید، فایل تنظیمات همان workspace را ویرایش کنید. ساختار موتور و نیاز به شروع مجدد در راهنمای موتور سفارشی MausBot مستند شده‌اند.

کلید در این فایل به‌صورت متن ذخیره می‌شود؛ فایل و نسخهٔ پشتیبانش را عمومی نکنید.

ساخت Bot و آزمون

در تنظیمات موتور‌ها، آماده‌بودن Chabokan AI را بررسی کنید.
Bot جدید بسازید و موتور چابکان و مدل موردنظر را انتخاب کنید.
ابتدا درخواست ساده‌ای مثل «فقط بنویس اتصال برقرار است» بفرستید.
نتیجه را در لاگ درخواست‌های سرویس چابکان بررسی کنید.

برای اتصال سایر providerهای سازگار و انتخاب موتور، راهنمای providerهای MausBot را ببینید.

ابزارخوانی و کنترل کامپیوتر

پاسخ متنی موفق، پشتیبانی مدل از ابزار یا تصویر را تأیید نمی‌کند. برای کار با فایل‌ها و ابزار‌ها، مدلی با قابلیت tools و برای تحلیل تصویر یا اسکرین‌شات، مدلی با ورودی تصویر انتخاب کنید. در نسخه‌های دارای پشتیبانی ابزار در openai-compat، امکانات به مدل و مجوزهای همان Bot وابسته‌اند. برای مدل فاقد ابزارخوانی، "tools": false را در config قرار دهید. دامنهٔ قابلیت‌های موتور مستقیم

ابتدا خواندن یک فایل آزمایشی را امتحان کنید. تنظیم مجوز کامپیوتر، مرورگر و برنامه‌ها در MausBot انجام می‌شود؛ کلید چابکان به‌تنهایی این دسترسی‌ها را ایجاد نمی‌کند.

رفع خطا

مشکل	بررسی
موتور در دسترس نیست	نسخهٔ دارای `openai-compat`، ساختار JSON و شروع مجدد برنامه
401	کلید AI، تطابق نام `apiKeyEnv` و مقدار `environment`
مدل پیدا نمی‌شود	Model ID دقیق و دسترسی پلن به مدل
متن پاسخ می‌دهد ولی ابزار اجرا نمی‌کند	پشتیبانی `tools` در مدل، نسخهٔ MausBot و مجوز Bot
تصویر پذیرفته نمی‌شود	قابلیت ورودی تصویر مدل

برای تفکیک خطای ابزار از اتصال درگاه، آزمون مستقیم و عیب‌یابی AI را انجام دهید.

آماده‌سازی​

نصب و شروع​

تعریف موتور چابکان​

ساخت Bot و آزمون​

ابزارخوانی و کنترل کامپیوتر​

رفع خطا​