آموزش OpenClaw؛ نصب، راه‌اندازی و ترفندهای کاربردی

OpenClaw یا اوپن‌کلاو، راهی برای داشتن یک دستیار هوش مصنوعی روی کامپیوتر یا سرور خودتان است. مدل را به ابزارها و پیام‌رسان وصل می‌کنید، سپس از همان محیط به آن کار می‌دهید. در این آموزش، نصب OpenClaw در ویندوز، مک و لینوکس، راه‌اندازی ربات تلگرام و چند کار واقعی را قدم‌به‌قدم پیش می‌بریم.

دستورهای این مقاله با مستندات رسمی در ۳ اکتبر ۲۰۲۶ تطبیق داده شده‌اند. نصب را روی یک دستگاه شخصی شروع کنید؛ انتقال به سرور وقتی منطقی است که جریان کارتان روی همان دستگاه درست عمل کند.

OpenClaw چطور کار می‌کند؟

سه بخش را بشناسید: Gateway اتصال‌ها و جلسه‌ها را مدیریت می‌کند؛ مدل درخواست را می‌فهمد؛ ابزارها کارهایی مثل خواندن فایل یا استفاده از مرورگر را انجام می‌دهند. تلگرام فقط یکی از راه‌های صحبت با این دستیار است. اگر Gateway خاموش باشد یا مدل اعتبار نداشته باشد، ظاهر سالم ربات کمکی نمی‌کند. نقطهٔ شروع مستندات OpenClaw

برای آشنایی با تفاوت پاسخ دادن و انجام دادن، مقایسهٔ انواع چت‌بات هوش مصنوعی را ببینید. در عمل، بهتر است اولین درخواست شما یک کار محدود با خروجی مشخص باشد: مثلاً «از این سه فایل، فهرست اصلاحات پروژه را بساز».

کدام روش نصب مناسب شماست؟

برای دیدن همهٔ ستون‌ها، جدول را به چپ و راست بکشید.

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

پیش‌نیازها: نسخهٔ Node را درست انتخاب کنید

راهنمای فعلی، Node.js 24.16 به بالا در شاخهٔ ۲۴ یا 26.1 به بالا در شاخهٔ ۲۶ را می‌خواهد و شاخهٔ ۲۶ را توصیه می‌کند. بنابراین آموزش قدیمی با Node 22 را برای نسخهٔ فعلی مبنا قرار ندهید. با این دستور نسخه را ببینید:

node --version

برای دسترسی به مدل، یک ورود موجودِ قابل پشتیبانی مانند Claude Code یا Codex CLI، یا کلید API ارائه‌دهنده لازم است. ورود شناسایی‌شده در راه‌اندازی با یک درخواست واقعی بررسی می‌شود؛ صرف پیدا شدن فایل ورود، تضمین اتصال نیست. پیش‌نیازهای رسمی

نصب و راه‌اندازی مرحله‌به‌مرحله

۱. یک بار با npx امتحان کنید

در Terminal مک و لینوکس یا ترمینال ویندوز اجرا کنید:

npx openclaw@latest

در نصب تازه، Quick start را انتخاب کنید. اگر مسیر مدل قابل استفاده پیدا شود، تنظیمات ذخیره و داشبورد باز می‌شود؛ در غیر این صورت، راه‌اندازی دستی ارائه‌دهنده را کامل کنید. برای انتخاب‌های بیشتر، Custom setup مناسب است. در این اجرای آزمایشی، Gateway تا زمانی فعال است که ترمینال باز بماند؛ Ctrl+C آن را متوقف می‌کند.

۲. نصب دائمی را متناسب با سیستم انجام دهید

مک و لینوکس: دستور رسمی نصب‌کننده این است. اسکریپت را از دامنهٔ رسمی دریافت می‌کند و روی دستگاه اجرا می‌کند؛ قبل از اجرا، محتوای آن را بررسی کنید.

curl -fsSL https://openclaw.ai/install.sh | bash

ویندوز، در PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

نصب‌کننده، راه‌اندازی هدایت‌شده را باز می‌کند. کاربران ویندوز که رابط گرافیکی می‌خواهند می‌توانند Windows Hub را از لینک رسمی انتخاب کنند. مسیرهای npm، Docker و WSL2 نیز در راهنمای نصب توضیح داده شده‌اند؛ چند روش را هم‌زمان نصب نکنید تا معلوم باشد کدام نسخه اجرا می‌شود.

۳. مدل را تنظیم و اولین پاسخ را دریافت کنید

اگر انتخاب مدل را بعداً عوض می‌کنید، از این مسیر برگردید:

openclaw configure

نام مدل، روش ورود و محدودیت مصرف را بررسی کنید. سپس داشبورد را باز کنید:

openclaw dashboard

برای آزمون اولیه، این درخواست را بفرستید: «به فارسی پاسخ بده و فقط یک چک‌لیست پنج‌مرحله‌ای برای آماده‌سازی پروژهٔ تدوین بنویس.» این کار اتصال مدل را می‌سنجد؛ هنوز دسترسی مرورگر یا پوشه‌های پروژه را ثابت نمی‌کند. آن‌ها را در یک کار کوچک جداگانه بررسی کنید.

۴. Gateway را در پس‌زمینه نگه دارید

پس از نصب CLI، اجرای آزمایشی قبلی را با Ctrl+C ببندید و سرویس را نصب کنید:

openclaw gateway install
openclaw gateway status

نوع سرویس به سیستم‌عامل وابسته است. در وضعیت استاندارد، رابط محلی از پورت 18789 استفاده می‌کند. باز کردن همین پورت روی اینترنت، روش مناسبی برای دسترسی از بیرون نیست؛ برای سرور، راهنمای امنیت Gateway و دسترسی احراز هویت‌شده را دنبال کنید.

اتصال OpenClaw به تلگرام

۱. در تلگرام، حساب دقیق @BotFather را باز کنید. با /newbot نام و شناسهٔ ربات را بسازید و توکن را نگه دارید.

۲. برای جلوگیری از ماندن توکن در تاریخچهٔ دستورهای ترمینال، آن را با روش فایل توکن یا تنظیماتِ شرح‌داده‌شده در راهنمای Telegram setup ثبت کنید. راه سریع CLI نیز وجود دارد؛ بخش YOUR_BOT_TOKEN جای‌نگهدار است و باید با توکن خودتان عوض شود:

openclaw channels add --channel telegram --token YOUR_BOT_TOKEN
openclaw channels status --probe

۳. به ربات پیام خصوصی بدهید و درخواست اتصال را ببینید:

openclaw pairing list telegram
openclaw pairing approve telegram YOUR_PAIRING_CODE

فقط کد مربوط به حساب خودتان را تأیید کنید. کد اتصال طبق مستندات پس از یک ساعت منقضی می‌شود. اتصال به گروه مرحلهٔ دیگری دارد: شناسهٔ گروه، کاربران مجاز و شرط منشن را تنظیم کنید. برای شروع، یک گفت‌وگوی خصوصی کافی است.

چهار کاربرد واقعی برای سازندهٔ محتوا

دستیار آماده‌سازی پروژه: فایل بریف و یادداشت مشتری را بدهید و فهرست شات‌های لازم، فایل‌های کمبود و سؤال‌های مبهم را بخواهید. خروجی باید به فایل منبع اشاره کند تا چیزی به خواستهٔ مشتری اضافه نشود.

گزارش تحقیق: چند لینک مشخص دربارهٔ یک ابزار جدید بدهید و جدول «ادعا، تاریخ، منبع» بگیرید. اگر ابزار مرور وب فعال نیست، از دستیار انتظار بررسی زندهٔ قیمت نداشته باشید.

مرتب‌سازی فایل: ابتدا طرح نام‌گذاری را روی یک پوشهٔ آزمایشی بسازید؛ فهرست نام قدیم و جدید را ببینید، سپس تغییر را تأیید کنید. فایل‌های اصلی پروژه بهترین محل اولین آزمون نیستند.

دستیار پیگیری: از قابلیت زمان‌بندیِ نسخهٔ خود برای گزارش مشخص استفاده کنید؛ منطقهٔ زمانی، موعد و محل تحویل را صریح تعیین کنید. درخواست «هر صبح چک کن» بدون تعیین دستگاه همیشه‌روشن و مسیر تحویل، جریان کار کاملی نیست.

فایل بریف پیوست را بخوان. یک جدول با ستون‌های «درخواست مشتری»، «شات یا دارایی لازم»، «اطلاعات کمبود» و «ارجاع به بخش بریف» بساز. فقط از اطلاعات فایل استفاده کن. موارد نامعلوم را سؤال بنویس. فعلاً هیچ فایلی را تغییر نده و هیچ پیامی ارسال نکن. خروجی فارسی و قابل استفاده در جلسهٔ پیش‌تولید باشد.

ترفندهای OpenClaw برای نتیجهٔ بهتر

حافظه را کوتاه و قابل اصلاح نگه دارید

در ساختار فعلی، USER.md برای ترجیح‌ها، MEMORY.md برای تصمیم‌های ماندگار و فایل‌های روزانهٔ پوشهٔ memory برای یادداشت‌های کاری استفاده می‌شوند. به‌جای ذخیره کردن تمام مکالمه در حافظهٔ اصلی، چند قاعدهٔ کاربردی بدهید: زبان پاسخ، قالب تحویل، منطقهٔ زمانی و روش نام‌گذاری پروژه. راهنمای حافظه

مثلاً بگویید: «به خاطر بسپار که گزارش پروژه باید با کارهای انجام‌شده، کارهای باقی‌مانده و سؤال‌های مشتری تمام شود.» سپس بخواهید بگوید این ترجیح را کجا ثبت کرده است. رمز و کلید API را داخل حافظه نگذارید.

لحن را از مجوز جدا کنید

فایل SOUL.md می‌تواند رفتار و لحن دستیار را مشخص کند. راهنمای رسمی SOUL.md نقطهٔ شروع خوبی است. اما جملهٔ «بدون اجازه حذف نکن» جای تنظیم فنی مجوز و تأیید اجرای ابزار را نمی‌گیرد. برای پوشه‌های حساس، سیاست دسترسی را هم محدود کنید.

هر کار را با معیار تحویل بنویسید

«این پروژه را بررسی کن» مبهم است. «فهرست فایل‌های ویدئویی بدون پروکسی، مسیر هر فایل و تعداد موارد را بده» قابل بررسی است. اول طرح، بعد اجرا، سپس گزارش تغییرات: این ترتیب برای کارهای فایل و مرورگر خطا را راحت‌تر نشان می‌دهد.

رفع خطا: از این ترتیب شروع کنید

برای دیدن همهٔ ستون‌ها، جدول را به چپ و راست بکشید.

برای تشخیص کلی، openclaw doctor را اجرا کنید. ابزار openclaw triage نیز تشخیص اولیه ارائه می‌دهد؛ اگر فقط بررسی می‌خواهید، پیش از سپردن گزارش به یک دستیار دیگر، مسیر محلی را انتخاب کنید. گزارش را پیش از اشتراک‌گذاری از نظر اطلاعات شخصی مرور کنید. راهنمای شروع و عیب‌یابی

هزینه و ارزش استفاده

هزینهٔ OpenClaw را در سه بخش ببینید: مدل، دستگاه یا سرور، و زمانی که برای نگهداری صرف می‌کنید. برای کار تکرارشوندهٔ دارای فایل و ابزار، کنترل بیشتر می‌تواند مفید باشد. برای چند پرسش ساده، تنظیم یک Gateway احتمالاً زمان اضافه می‌گیرد. فارسی بودن درخواست، محدودیت پرداخت یا دسترسی سرویس مدل از ایران را برطرف نمی‌کند؛ شرایط ارائه‌دهنده را جدا بررسی کنید.

شروع پیشنهادی: یک مدل، یک کانال خصوصی و یک کار مشخص. وقتی همان کار با خروجی قابل اعتماد تکرار شد، حافظه و اتصال‌های بیشتر را اضافه کنید.