🦞🤖

آموزش OpenClaw از صفرِ صفر

قراره چی یاد بگیریم؟ می‌خواهیم یک «دستیار هوش مصنوعی شخصی» روی کامپیوتر خودمان راه بیندازیم!

این آموزش قدم‌به‌قدم است؛ یعنی حتی اگر تا حالا اسم این چیزها به گوشَت نخورده باشد، اگر مرحله‌ها را به ترتیب انجام بدهی، آخرش یک ربات باهوش داری که با تو حرف می‌زند و برایت کار انجام می‌دهد. 🚀

📌 قبل از شروع، این‌ها را بدان

مرحله ۱ از ۱۰

۱ OpenClaw اصلاً چی هست؟ 🦞

تصور کن یک دوست ربات خیلی باهوش داری که داخل کامپیوترت زندگی می‌کند. به او پیام می‌دهی: «ایمیل‌هایم را مرتب کن»، «برایم یادآوری بگذار»، «این سایت را برایم بخوان» — و او واقعاً این کارها را انجام می‌دهد، نه اینکه فقط جواب بدهد. OpenClaw (بخوان: اوپِن‌کلاو، یعنی «چنگالِ باز» 🦞) دقیقاً همین است: یک برنامهٔ رایگان و متن‌باز۱ که یک دستیار هوش مصنوعی۲ شخصی برایت می‌سازد.

🤔 چه فرقی با چت‌بات‌های معمولی دارد؟ چت‌بات‌های معمولی مثل یک دوستِ پشتِ تلفن هستند: فقط حرف می‌زنند. اما OpenClaw مثل دوستی است که کنار کامپیوترت نشسته: هم حرف می‌زند، هم دست دارد! می‌تواند فایل باز کند، در اینترنت بگردد و کارها را خودش انجام بدهد.

نقشهٔ کلی: این سیستم چطور کار می‌کند؟

📱 تو (از تلگرام، واتساپ یا مرورگر)
⬅️
🦞 OpenClaw روی کامپیوتر تو
⬅️
🧠 مغز هوش مصنوعی (مثلاً Claude یا GPT)

یعنی: تو پیام می‌دهی ← OpenClaw پیام را می‌گیرد ← از یک «مغز» هوش مصنوعی کمک می‌گیرد ← بعد کار را روی کامپیوترت انجام می‌دهد و جوابت را می‌فرستد.

📖 پاورقی‌های این بخش ۱. متن‌باز (Open Source): یعنی «دستور پختِ» برنامه برای همه آزاد است؛ هرکس می‌تواند ببیند داخلش چه خبر است و آن را بهتر کند — مثل دستور کیکی که سرآشپز آن را مخفی نکرده.
۲. هوش مصنوعی (AI): برنامه‌ای کامپیوتری که می‌تواند مثل آدم‌ها متن بفهمد، جواب بدهد و تصمیم بگیرد.
مرحله ۲ از ۱۰

۲ پیش‌نیازها: چه چیزهایی لازم داریم؟ 🎒

مثل درست‌کردن کیک که اول مواد لازم را روی میز می‌چینیم، ما هم اول وسایلمان را آماده می‌کنیم:

۱

یک کامپیوتر با ویندوز ۱۰ یا ۱۱ (یا مک/لینوکس) که به تو اجازهٔ نصب برنامه بدهد.

۲

اینترنت وصل و پایدار — چون هم برای نصب و هم برای حرف‌زدن با «مغز» هوش مصنوعی لازم است.

۳

یک کلید API۳ از یک شرکت هوش مصنوعی (مثل Anthropic سازندهٔ Claude، یا OpenAI سازندهٔ GPT). این را در مرحله ۵ لازم داریم.

۴

حدود ۳۰ دقیقه وقت و کمی حوصله. 😊

⚠️ مواظب باش — فقط با کمک یک بزرگ‌تر! گرفتن کلید API معمولاً به حساب کاربری، ایمیل و گاهی کارت بانکی نیاز دارد و استفاده از آن ممکن است هزینه داشته باشد (مثل شارژ سیم‌کارت که با مصرف کم می‌شود). این بخش را حتماً با پدر، مادر یا یک بزرگ‌ترِ مطمئن انجام بده.
📖 پاورقی ۳. کلید API (API Key): یک رمز طولانی مثل sk-abc123... که مثل «کارت عضویت باشگاه» است: با نشان‌دادنش، شرکت هوش مصنوعی می‌فهمد تو اجازهٔ استفاده داری. آن را مثل رمز عبور، به هیچ‌کس نگو و جایی عمومی ننویس.
✅ خودت را امتحان کن الان باید بدانی: کامپیوترت روشن می‌شود؟ اینترنت داری؟ یک بزرگ‌تر برای مرحلهٔ کلید API کنارت هست؟ اگر هر سه «بله» است، برو مرحلهٔ بعد!
مرحله ۳ از ۱۰

۳ آشنایی با «پنجرهٔ دستور» 💻

برای نصب OpenClaw از چیزی به اسم PowerShell۴ استفاده می‌کنیم. نترس! این فقط یک پنجرهٔ ساده است که به جای کلیک‌کردن، جمله‌های دستوری تایپ می‌کنی و کامپیوتر انجامشان می‌دهد — مثل اینکه به جای اشاره‌کردن به غذا در رستوران، اسمش را بلند بگویی!

باز کردن PowerShell در ویندوز

۱

روی دکمهٔ استارت (علامت ویندوز ⊞ پایین صفحه) کلیک کن.

۲

تایپ کن: powershell

۳

روی نتیجه‌ای که نوشته Windows PowerShell راست‌کلیک کن.

۴

گزینه‌ای شبیه به «Run as administrator» (اجرا به‌عنوان مدیر) را انتخاب کن.

۵

اگر پنجره‌ای پرسید «اجازه می‌دهی؟»، روی Yes کلیک کن.

💡 نکته یک پنجرهٔ آبی یا مشکی باز می‌شود که داخلش می‌شود تایپ کرد. همین است! قرار نیست چیز ترسناکی ببینی. 😄
📖 پاورقی ۴. PowerShell / ترمینال: برنامه‌ای که در آن «دستور»۵ تایپ می‌کنیم. در مک و لینوکس اسمش Terminal است.
۵. دستور (Command): جمله‌ای که کامپیوتر زبانش را می‌فهمد؛ آن را تایپ می‌کنی و کلید Enter را می‌زنی تا اجرا شود.
✅ ایست بازرسی الان باید یک پنجرهٔ PowerShell باز جلویت باشد که یک خط چشمک‌زن دارد و منتظر تایپ توست. اگر باز نشد، برو بخش «رفع اشکال».
مرحله ۴ از ۱۰

۴ نصب OpenClaw 📦

حالا جادوی اصلی! فقط یک خط باید تایپ کنی و بقیه‌اش خودکار انجام می‌شود — نصب‌کننده حتی برنامهٔ کمکی Node.js۶ را هم خودش برایت نصب می‌کند.

در ویندوز (داخل PowerShell)

۱

این دستور را عیناً تایپ کن (یا کپی کن و با راست‌کلیک داخل پنجره بچسبان):

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

کلید Enter را بزن.

۳

صبر کن تا نوشته‌ها تمام شوند. (ممکن است چند دقیقه طول بکشد — این عادی است، دارد برنامه را دانلود و نصب می‌کند.)

💡 اگر مک یا لینوکس داری به‌جای دستور بالا، در Terminal این را بزن:
curl -fsSL https://openclaw.ai/install.sh | bash
در مک ممکن است بار اول رمز کاربرِ مدیر (بزرگ‌ترِ خانه!) لازم شود.
🤔 چرا این دستور؟ این خط به کامپیوتر می‌گوید: «برو از سایت رسمی openclaw.ai برنامهٔ نصب را بیاور و اجرایش کن.» مثل اینکه به پیک بگویی: برو از فلان مغازهٔ مشخص، فلان بسته را بگیر و بیاور.
📖 پاورقی ۶. Node.js: یک «موتور» رایگان که خیلی از برنامه‌ها برای روشن‌شدن به آن نیاز دارند — مثل باتری برای اسباب‌بازی. خوشبختانه نصب‌کنندهٔ OpenClaw خودش آن را برایت آماده می‌کند.
✅ ایست بازرسی وقتی نصب تمام شد، تایپ کن openclaw --version و Enter بزن. باید یک شمارهٔ نسخه (چیزی شبیه چند عدد با نقطه) ببینی. اگر خطای «شناخته نشد» دیدی، پنجره را ببند، دوباره باز کن و همین را امتحان کن. باز هم نشد؟ برو «رفع اشکال».
مرحله ۵ از ۱۰

۵ راه‌اندازی اولیه و دادن کلید API 🔑

حالا باید به دستیارمان «جان» بدهیم! این کار با یک راهنمای پرسش‌وپاسخ انجام می‌شود که خودِ برنامه قدم‌به‌قدم از تو سؤال می‌پرسد. این بخش را کنار بزرگ‌ترت انجام بده چون کلید API لازم است.

۱

در همان پنجره، این دستور را تایپ کن و Enter بزن:

openclaw onboard --install-daemon
۲

راهنما از تو می‌پرسد کدام «مغز» هوش مصنوعی را می‌خواهی (مثلاً Anthropic یا OpenAI). با کلیدهای بالا/پایین یکی را انتخاب کن و Enter بزن.

۳

وقتی کلید API را خواست، بزرگ‌ترت آن را از سایت همان شرکت گرفته و اینجا می‌چسباند.

۴

بقیهٔ سؤال‌ها را با Enter رد کن تا از تنظیمات پیشنهادیِ خودش استفاده شود. (بعداً هر وقت خواستی می‌توانی با دستور openclaw configure تغییرشان بدهی.)

💡 نکته: «daemon» چیست؟ آن تکهٔ --install-daemon یعنی: «این دستیار را طوری نصب کن که همیشه در پس‌زمینه بیدار باشد» — مثل نگهبانی که حتی وقتی تو خوابی، سر پستش است. اسم فنی‌اش «دیمِن»۷ است.
📖 پاورقی ۷. دیمن (Daemon): برنامه‌ای که بی‌سروصدا در پس‌زمینهٔ کامپیوتر کار می‌کند، بدون اینکه پنجره‌ای ببینی.
✅ ایست بازرسی راهنما باید بدون پیغام خطای قرمز تمام شده باشد و پیامی شبیه «تمام شد / آماده است» دیده باشی. اگر وسطش گیر کردی، نگران نباش: دوباره openclaw onboard را اجرا کن؛ از همان‌جا ادامه می‌دهد.
مرحله ۶ از ۱۰

۶ بررسی اینکه همه‌چیز روشن است 🔍

قبل از اولین گفت‌وگو، مطمئن شویم «قلب» سیستم می‌تپد! قلبِ OpenClaw چیزی است به اسم گِیت‌وی۸.

۱

این دستور را تایپ کن و Enter بزن:

openclaw gateway status
۲

در جواب، دنبال کلمه‌ای شبیه running (در حال اجرا) و عددی مثل 18789 بگرد.

📖 پاورقی ۸. گیت‌وی (Gateway): یعنی «دروازه». همان بخشی از OpenClaw که همهٔ پیام‌ها از آن رد می‌شوند — مثل نگهبانِ درِ مدرسه که همه از جلوی او وارد و خارج می‌شوند.
✅ ایست بازرسی اگر کلمهٔ running را دیدی: عالی است، قلب می‌تپد! ❤️ اگر ندیدی، دستور openclaw gateway start را بزن و دوباره وضعیت را چک کن.
مرحله ۷ از ۱۰

۷ اولین گفت‌وگو با دستیارت! 🎈

لحظهٔ هیجان‌انگیز رسید! OpenClaw یک صفحهٔ مخصوص گفت‌وگو به اسم داشبورد۹ دارد که در مرورگرت باز می‌شود.

۱

این دستور را تایپ کن و Enter بزن:

openclaw dashboard
۲

صبر کن تا مرورگرت (مثل کروم یا اِج) خودش باز شود و صفحهٔ OpenClaw را نشان بدهد.

۳

در جعبهٔ گفت‌وگو، اولین پیامت را بنویس. مثلاً: «سلام! تو کی هستی و چه کارهایی بلدی؟»

۴

Enter بزن و جوابش را بخوان! 🥳

💡 چند ایدهٔ بامزه برای شروع «برای فردا ساعت ۵ یادآوری بگذار که به مادربزرگ زنگ بزنم» · «یک اسم بامزه برای خودت انتخاب کن» · «امروز هوای شهر ما چطور است؟»
📖 پاورقی ۹. داشبورد (Dashboard): صفحهٔ فرمان و کنترل؛ مثل داشبورد ماشین که همهٔ دکمه‌ها و نشانگرها یک‌جا جلوی چشمت است.
✅ ایست بازرسی الان باید در مرورگر، جوابِ دستیارت را ببینی. اگر صفحه باز نشد یا جواب نیامد، برو بخش «رفع اشکال».
مرحله ۸ از ۱۰

۸ (اختیاری) وصل کردن به تلگرام 📱

قشنگ‌ترین بخش OpenClaw این است که لازم نیست پشت کامپیوتر باشی! می‌توانی از گوشی‌ات و از داخل تلگرام (یا واتساپ، دیسکورد و…) با دستیارت حرف بزنی. طبق راهنمای رسمی، ساده‌ترین راه برای شروع، تلگرام است، چون فقط یک «توکنِ ربات»۱۰ می‌خواهد.

مسیر کلی این است (جزئیات دقیق در راهنمای رسمی آمده):

۱

در تلگرام، ربات رسمی @BotFather را پیدا کن — این ربات، «کارخانهٔ ربات‌سازی» تلگرام است.

۲

به او دستور /newbot را بفرست و اسمی برای ربات خودت انتخاب کن.

۳

BotFather یک «توکن» (رمز طولانی) به تو می‌دهد؛ آن را کپی کن و به کسی نده.

۴

در کامپیوتر، دستور openclaw configure را بزن و بخش کانال‌ها (Channels)، گزینهٔ تلگرام را انتخاب کن و توکن را بچسبان.

۵

حالا در تلگرام به ربات خودت پیام بده — دستیارت جواب می‌دهد! 🤯

📖 پاورقی ۱۰. توکن (Token): یک رمز طولانی که مثل «کلیدِ درِ خانهٔ ربات» است؛ هرکس آن را داشته باشد می‌تواند ربات را کنترل کند. پس مخفی نگهش دار!
💡 نکته ممکن است نام دقیق منوها در نسخه‌های جدید کمی فرق کند. اگر گم شدی، راهنمای رسمی تلگرامِ OpenClaw در این نشانی است: docs.openclaw.ai/channels/telegram (راهنمای رسمی حتی ترجمهٔ فارسی هم دارد!).
مرحله ۹ از ۱۰

۹ نکات امنیتی خیلی مهم 🛡️

OpenClaw قدرتمند است — و هر چیز قدرتمندی، قانون‌های ایمنی دارد. مثل دوچرخه که بدون کلاه ایمنی سوارش نمی‌شویم!

⚠️ مواظب باش — این ۵ قانون را همیشه رعایت کن ۱) کلید API و توکن‌ها را هرگز برای کسی نفرست و در گروه‌ها ننویس.
۲) این دستیار به فایل‌های کامپیوترت دسترسی دارد؛ پس فقط روی کامپیوتری نصبش کن که بزرگ‌ترها اجازه داده‌اند.
۳) در تنظیمات، فقط به شمارهٔ خودت اجازهٔ پیام‌دادن به ربات را بده (به این کار «جفت‌سازی» یا pairing می‌گویند) تا غریبه‌ها نتوانند به ربات تو دستور بدهند.
۴) «مهارت»ها (Skills) و افزونه‌ها را فقط از منابع رسمی و شناخته‌شده نصب کن — افزونهٔ ناشناس مثل آب‌نباتِ آدم غریبه است!
۵) اگر دستیار خواست کاری مهم انجام دهد (خرید، ارسال ایمیل، پاک‌کردن فایل)، اول خودت بررسی کن، بعد اجازه بده.
🤔 چرا این‌قدر سخت‌گیری؟ چون این ربات «دست» دارد! همان‌طور که سوئیچ ماشین را به هرکسی نمی‌دهیم، کنترل کامپیوترمان را هم بی‌حساب‌وکتاب به کسی — حتی یک ربات — نمی‌سپاریم.
مرحله ۱۰ از ۱۰

🔧 رفع اشکال — اگر چیزی کار نکرد

😕 مشکل ۱: می‌نویسد openclaw is not recognized (شناخته نشد) علت: پنجرهٔ PowerShell هنوز از نصب جدید خبر ندارد.
راه‌حل: پنجره را کامل ببند، یک پنجرهٔ جدید باز کن و دوباره امتحان کن. اگر نشد، کامپیوتر را یک‌بار خاموش و روشن کن.
😕 مشکل ۲: موقع نصب، خطای قرمز درباره اینترنت یا دانلود می‌دهد علت: اینترنت قطع شده یا سایت در دسترس نیست.
راه‌حل: اول مطمئن شو با مرورگر می‌توانی سایت باز کنی. بعد دستور نصب را دوباره اجرا کن. گاهی فقط باید چند دقیقه بعد دوباره امتحان کنی.
😕 مشکل ۳: دستیار جواب نمی‌دهد یا خطای کلید API می‌دهد علت: کلید اشتباه وارد شده، یا اعتبارش تمام شده است.
راه‌حل: با کمک بزرگ‌ترت، در سایت شرکت هوش مصنوعی وضعیت کلید را چک کنید؛ بعد با دستور openclaw configure کلید درست را دوباره وارد کن.
😕 مشکل ۴: دستور openclaw dashboard صفحه‌ای باز نمی‌کند علت: «گیت‌وی» خاموش است.
راه‌حل: اول openclaw gateway start را بزن، بعد دوباره openclaw dashboard را امتحان کن.
😕 مشکل ۵: وسط راه‌اندازی (onboard) گیر کردم یا اشتباه انتخاب کردم علت: اشکالی ندارد؛ برای همه پیش می‌آید!
راه‌حل: دوباره openclaw onboard را اجرا کن، یا با openclaw configure فقط همان بخش را درست کن.
💡 هنوز گیر کرده‌ای؟ راهنمای رسمی در docs.openclaw.ai (با ترجمهٔ فارسی) و انجمن کاربران در دیسکورد هست. سؤال‌پرسیدن عیب نیست — همهٔ حرفه‌ای‌ها هم سؤال می‌پرسند!

🎉 تمام شد! حالا تو بلدی…

حالا یک دستیار هوش مصنوعیِ واقعی داری که مال خودِ توست. آفرین به تو! 🦞💙