کار حرفه‌ای با OpenClaw — تنظیمات اولیه، روش کار و ترفندها

OpenClaw چیست و چگونه کار می‌کند؟

⏱️ ۵ دقیقه مرحله ۱ از ۱۲

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

در آموزش قبلی مسیر صعود (ایستگاه ۵) با OpenClaw آشنا شدید. حالا وقت آن است که آن را مثل یک حرفه‌ای راه بیندازیم و به‌کار بگیریم. چهار قطعهٔ اصلی این سیستم را بشناسید:

📱 کانال‌هاتلگرام، مرورگر، …

⇐

🚪 Gatewayمغز مدیریتی — همیشه روشن

⇐

🤖 Agentخودِ دستیار هوشمند

⇐

🧰 Skillsمهارت‌ها و ابزارها

📖 پاورقی — واژه‌های این بخش: Gateway (گِیت‌وی): یعنی «دروازه». برنامه‌ای که در پس‌زمینهٔ کامپیوترتان روشن می‌ماند و همهٔ پیام‌ها از هر کانالی اول به آن می‌رسند؛ مثل تلفنچیِ یک شرکت. Agent (اِیجنت): یعنی «عامل / کارگزار». همان هوش مصنوعی‌ای است که فکر می‌کند و جواب می‌سازد. Channel (چنل): یعنی «کانال». راهِ ارتباطی شما با دستیار: تلگرام، واتس‌اپ، صفحهٔ مرورگر و غیره. Skill (اسکیل): یعنی «مهارت». افزونه‌های کوچکی که به دستیار توانایی‌های تازه می‌دهند؛ مثل دورهٔ آموزشی‌ای که منشی شما می‌گذراند.

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

✅ ایست بازرسی: اگر بتوانید با یک جمله برای دوست‌تان توضیح دهید که «Gateway چه فرقی با Agent دارد»، این مرحله را با موفقیت گذرانده‌اید. (جواب: Gateway تلفنچی است، Agent متخصصی است که جواب می‌دهد.)

پیش‌نیازها — چه چیزهایی لازم داریم؟

⏱️ ۱۰ دقیقه مرحله ۲ از ۱۲

قبل از شروع، این سه چیز را آماده کنید:

۲-۱) Node.js نسخهٔ ۲۴ (پیشنهاد رسمی) — نسخهٔ 22.19 به بالا هم پشتیبانی می‌شود. اگر ایستگاه ۱ مسیر صعود (نصب پایتون، Node.js و VS Code) را گذرانده‌اید، Node.js را دارید. برای اطمینان، ترمینال^۱ را باز کنید و بنویسید:

node --version

اگر عددی مثل v24.x.x یا v22.19 به بالا دیدید، آماده‌اید.

۲-۲) یک کلید API از یک سرویس‌دهندهٔ مدل هوش مصنوعی — مثل OpenRouter که در ایستگاه ۳ مسیر صعود ساختید، یا Anthropic / OpenAI / Google. ویزارد نصب خودش از شما کلید را می‌پرسد؛ فقط آن را از قبل در جایی امن کپی داشته باشید.

۲-۳) اتصال اینترنت پایدار — برای دانلود برنامه و گفتگو با مدل‌ها.

📌 کاربران ویندوز: طبق مستندات رسمی، ساده‌ترین مسیر روی ویندوز، برنامهٔ Windows Hub است؛ ولی مسیر نصب با PowerShell (که در همین آموزش می‌بینید) و مسیر WSL2 هم به‌طور رسمی پشتیبانی می‌شوند.

📖 پاورقی: ۱) ترمینال: پنجره‌ای که در آن به‌جای کلیک، «فرمان متنی» می‌نویسید. در ویندوز: منوی استارت ← تایپ PowerShell ← Enter. در مک: برنامهٔ Terminal. کلید API: رمز عبورِ مخصوصِ برنامه‌هاست؛ رشته‌ای طولانی از حروف و اعداد که به سرویس هوش مصنوعی می‌گوید «این درخواست از طرف حساب فلانی است».

✅ ایست بازرسی: فرمان node --version عدد نسخه را نشان می‌دهد و کلید API در دسترس شماست؟ برویم سراغ نصب.

نصب OpenClaw

⏱️ ۵ دقیقه مرحله ۳ از ۱۲

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

۳-۱) ویندوز — PowerShell را باز کنید و این را بنویسید و Enter بزنید:

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

۳-۲) مک یا لینوکس — ترمینال را باز کنید و این را اجرا کنید:

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

اسکریپت نصب، خودش Node را بررسی می‌کند، OpenClaw را دانلود و نصب می‌کند و در پایان پیام موفقیت نشان می‌دهد.

⚠️ مواظب باش — خطای مجوز در PowerShell: اگر ویندوز جلوی اجرای اسکریپت را گرفت، PowerShell را با «Run as Administrator» باز کنید، اول فرمان Set-ExecutionPolicy RemoteSigned را اجرا کنید (و با Y تأیید کنید)، سپس دوباره فرمان نصب را بزنید.

💡 نکته — راه جایگزین: اگر با npm راحت‌ترید، این فرمان هم همان نتیجه را می‌دهد:

npm install -g openclaw@latest

روش‌های Docker و Nix هم در مستندات رسمی (docs.openclaw.ai/install) توضیح داده شده‌اند.

✅ ایست بازرسی: ترمینال را ببندید، دوباره باز کنید و بنویسید openclaw --version. اگر شمارهٔ نسخه چاپ شد، نصب کامل است. اگر نوشت «فرمان پیدا نشد»، به بخش رفع اشکال (مرحلهٔ ۱۲) بروید.

تنظیمات اولیه — ویزارد onboard قدم‌به‌قدم

⏱️ ۱۰ دقیقه مرحله ۴ از ۱۲

مهم‌ترین بخش نصب همین‌جاست. OpenClaw یک «ویزارد»^۱ دارد که مثل یک راهنمای تور، دست شما را می‌گیرد و همهٔ تنظیمات اولیه را قدم‌به‌قدم می‌پرسد. آن را با این فرمان اجرا کنید:

openclaw onboard --install-daemon

📖 پاورقی: ۱) ویزارد (Wizard): یعنی «جادوگر»؛ در نرم‌افزار، به راهنمای پرسش‌وپاسخیِ مرحله‌به‌مرحله می‌گویند. daemon (دیمِن): برنامه‌ای که بی‌سروصدا در پس‌زمینه اجرا می‌شود. سوئیچ --install-daemon یعنی «Gateway را طوری نصب کن که با روشن‌شدن سیستم، خودش روشن شود» — همان منشیِ همیشه‌حاضر.

ویزارد این‌ها را از شما می‌پرسد. برای هر کدام چه جوابی بدهید:

۴-۱) انتخاب سرویس‌دهندهٔ مدل (Provider): از فهرست، سرویسی را انتخاب کنید که کلیدش را دارید — مثلاً OpenRouter (اگر در فهرست بود)، Anthropic یا OpenAI. با کلیدهای جهت‌نما بالا و پایین بروید و با Enter انتخاب کنید.

۴-۲) وارد کردن کلید API: کلید را جای‌گذاری (Paste) کنید و Enter بزنید. نگران نباشید اگر هنگام تایپ چیزی دیده نشد — کلیدها برای امنیت مخفی نمایش داده می‌شوند.

۴-۳) تنظیمات Gateway: پیشنهادهای پیش‌فرض ویزارد برای شروع عالی‌اند؛ روی همه Enter بزنید و رد شوید.

۴-۴) کانال‌ها، مهارت‌ها و افزونه‌های اختیاری: فعلاً همه را رد کنید (Skip). این‌ها را بعداً در همین آموزش، آگاهانه و بادقت اضافه می‌کنیم.

۴-۵) نصب سرویس پس‌زمینه (daemon): تأیید کنید تا Gateway به‌صورت خودکار همیشه روشن بماند.

💡 نکته — عجله‌ای نیست: طبق مستندات رسمی، هر مرحلهٔ اختیاری را که رد کنید، بعداً می‌توانید با فرمان openclaw configure به آن برگردید. پس بدون استرس، سریع‌ترین مسیر را بروید.

✅ ایست بازرسی: ویزارد با پیام موفقیت تمام شد و به خط فرمان برگشتید؟ تنظیمات اولیه انجام شد؛ حالا مطمئن شویم موتور واقعاً روشن است.

راستی‌آزمایی: آیا موتور روشن شده؟

⏱️ ۳ دقیقه مرحله ۵ از ۱۲

۵-۱) وضعیت Gateway را بپرسید:

openclaw gateway status

۵-۲) در خروجی دنبال این باشید: Gateway در حال گوش‌دادن روی پورت^۱ 18789 است.

📖 پاورقی: ۱) پورت (Port): مثل شمارهٔ واحد در یک ساختمان. کامپیوتر شما یک ساختمان است و هر برنامه در یک «واحد» شماره‌دار به درخواست‌ها گوش می‌دهد. واحدِ OpenClaw شمارهٔ 18789 است.

✅ ایست بازرسی: عبارت مربوط به پورت 18789 را در خروجی می‌بینید؟ عالی است. اگر خطا دیدید، فرمان openclaw gateway را اجرا کنید تا Gateway به‌صورت دستی و موقتی بالا بیاید و پیام خطا را واضح ببینید؛ بعد به مرحلهٔ ۱۲ سر بزنید.

اولین گفتگو در داشبورد

⏱️ ۵ دقیقه مرحله ۶ از ۱۲

۶-۱) این فرمان را اجرا کنید:

openclaw dashboard

مرورگرتان باز می‌شود و Control UI — یعنی صفحهٔ کنترل و گفتگوی OpenClaw — را نشان می‌دهد.

۶-۲) در جعبهٔ گفتگو یک پیام ساده بنویسید؛ مثلاً: «سلام! خودت را معرفی کن.»

۶-۳) منتظر پاسخ بمانید. اگر جواب گرفتید، یعنی کل زنجیره — Gateway، کلید API و مدل — درست کار می‌کند. 🎉

💡 نکته: اگر مرورگر خودکار باز نشد، خودتان آدرس http://127.0.0.1:18789/ را در مرورگر باز کنید — این آدرسِ محلیِ داشبورد است و فقط از روی همین دستگاه در دسترس است.

✅ ایست بازرسی: الان باید یک پاسخ هوش مصنوعی در داشبورد ببینید. ندیدید؟ رایج‌ترین علت، کلید API اشتباه است — با openclaw configure بخش مدل را دوباره تنظیم کنید.

اتصال تلگرام — دستیار در جیب شما

⏱️ ۱۵ دقیقه مرحله ۷ از ۱۲

طبق مستندات رسمی، سریع‌ترین کانال برای اتصال، تلگرام است — فقط یک «توکن ربات»^۱ می‌خواهد. بعد از این مرحله، از گوشی‌تان و از هر جای دنیا با دستیارتان حرف می‌زنید.

۷-۱) در تلگرام، ربات رسمی @BotFather را باز کنید.

⚠️ مواظب باش: ربات‌های تقلبی با نام مشابه وجود دارند. مطمئن شوید نام کاربری دقیقاً @BotFather است (معمولاً با تیک تأیید).

۷-۲) فرمان /newbot را بفرستید.

۷-۳) یک نام نمایشی برای ربات بنویسید (مثلاً «دستیار من»).

۷-۴) یک نام کاربری بنویسید که به bot ختم شود (مثلاً mehdi_helper_bot).

۷-۵) BotFather یک توکن به شما می‌دهد — رشته‌ای شبیه 123456:ABC-xyz.... آن را کپی کنید و مثل رمز عبور از آن محافظت کنید.

۷-۶) در ترمینال، openclaw configure را اجرا کنید، بخش کانال‌ها (Channels) را انتخاب کنید، تلگرام را فعال کنید و توکن را جای‌گذاری کنید. سیاست پیام مستقیم را روی حالت پیش‌فرض pairing (جفت‌سازی^۲) بگذارید.

۷-۷) Gateway را دوباره راه‌اندازی کنید تا تنظیمات اعمال شود:

openclaw gateway restart

۷-۸) حالا از تلگرامِ خودتان به ربات‌تان یک پیام بدهید («سلام»). چون سیاست pairing فعال است، ربات هنوز جواب نمی‌دهد — این طبیعی و درست است!

۷-۹) در ترمینال، درخواست‌های در انتظار را ببینید و خودتان را تأیید کنید:

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

به‌جای <CODE> همان کدی را بگذارید که در خروجی فرمان اول دیدید.

۷-۱۰) دوباره از تلگرام پیام بدهید. این بار دستیار جواب می‌دهد. 🎉

📖 پاورقی: ۱) توکن ربات (Bot Token): شناسنامه و کلید ربات تلگرامی شماست؛ هر کسی آن را داشته باشد، صاحب ربات است. ۲) جفت‌سازی (Pairing): ساز‌وکار امنیتی OpenClaw: هر فرد غریبه‌ای که به ربات پیام بدهد، اول باید توسط شما (صاحب سیستم) تأیید شود. کدهای جفت‌سازی بعد از یک ساعت منقضی می‌شوند.

⚠️ مواظب باش — هرگز ربات را «باز» نگذارید: حالت dmPolicy: "open" یعنی هر کسی در تلگرام که نام ربات شما را پیدا کند، می‌تواند به دستیار شما — و ابزارهای آن — فرمان بدهد. برای دستیار شخصی، همیشه pairing یا allowlist را نگه دارید.

✅ ایست بازرسی: از گوشی به ربات پیام دادید و پاسخ هوش مصنوعی گرفتید؟ رسماً یک دستیار شخصیِ همیشه‌روشن در جیب دارید.

فایل پیکربندی و فرمان‌های روزمره

⏱️ ۱۰ دقیقه مرحله ۸ از ۱۲

همهٔ تنظیمات OpenClaw در یک فایل متنی نگه‌داری می‌شود: ~/.openclaw/openclaw.json (علامت ~ یعنی پوشهٔ خانگی کاربر شما). ویزارد و فرمان openclaw configure همین فایل را ویرایش می‌کنند؛ حرفه‌ای‌ها گاهی مستقیم هم آن را با VS Code باز می‌کنند.

این جدول را مثل «جعبه‌ابزار روزانه» نگه دارید:

فرمان	چه کاری می‌کند؟
`openclaw dashboard`	باز کردن داشبورد گفتگو در مرورگر
`openclaw gateway status`	نمایش وضعیت روشن/خاموش بودن Gateway
`openclaw gateway restart`	راه‌اندازی دوباره پس از هر تغییر تنظیمات
`openclaw configure`	باز کردن دوبارهٔ ویزارد تنظیمات (بخش‌به‌بخش)
`openclaw logs --follow`	نمایش زندهٔ گزارش رویدادها — بهترین دوست شما هنگام خطایابی
`openclaw doctor`	«پزشک» سیستم: مشکلات پیکربندی را پیدا و گزارش می‌کند
`openclaw channels status`	وضعیت اتصال کانال‌ها (تلگرام و …)

دو فرمان کاربردی دیگر برای کار مستقیم از ترمینال:

# گفتگو با دستیار بدون باز کردن هیچ رابطی
openclaw agent --message "یک چک‌لیست انتشار برای سایتم بنویس" --thinking high

# ارسال پیام به یک مخاطب از طریق کانال متصل
openclaw message send --channel telegram --target 123456789 --message "سلام از OpenClaw"

📖 پاورقی: ‎--thinking high‎: از دستیار می‌خواهد پیش از پاسخ، عمیق‌تر «فکر» کند — برای کارهای پیچیده عالی است، ولی کندتر و پرهزینه‌تر است. لاگ (Log): دفترچهٔ گزارش لحظه‌به‌لحظهٔ برنامه؛ هر اتفاقی — پیام رسیده، خطا، تصمیم — در آن ثبت می‌شود.

✅ ایست بازرسی: فرمان openclaw doctor را همین حالا اجرا کنید. اگر بدون هشدار قرمز تمام شد، سیستم شما سالم است؛ اگر هشداری داد، همان‌جا توضیح می‌دهد چه چیزی را اصلاح کنید.

ترفندها و کاربردهای حرفه‌ای

⏱️ ۲۰ دقیقه مرحله ۹ از ۱۲

🧰 ترفند ۱ — مهارت‌ها (Skills): به دستیارتان توانایی جدید بدهید

مهارت‌ها افزونه‌های آماده‌ای هستند که کارهای مشخصی را به دستیار اضافه می‌کنند — از جست‌وجوی وب تا کار با فایل‌ها. مخزن رسمی مهارت‌ها ClawHub نام دارد (بخش ClawHub در مستندات رسمی). راه فعال‌سازی: اجرای openclaw configure و انتخاب بخش مهارت‌ها، یا اضافه‌کردن هنگام onboard. هر مهارت را فقط وقتی نصب کنید که واقعاً لازم دارید — مهارتِ کمتر، سطح خطای کمتر.

⏰ ترفند ۲ — کارهای زمان‌بندی‌شده (cron)

OpenClaw ابزار زمان‌بندی داخلی دارد؛ یعنی می‌توانید به دستیار بگویید کاری را «هر روز ساعت ۸ صبح» انجام دهد — مثلاً «هر صبح خلاصهٔ برنامهٔ امروزم را در تلگرام بفرست». ساده‌ترین راه: همین را به زبان آدمیزاد در چت از خودِ دستیار بخواهید؛ دستیار از ابزار زمان‌بندی‌اش استفاده می‌کند. جزئیات در بخش ابزارهای مستندات (docs.openclaw.ai/tools) آمده است.

👥 ترفند ۳ — چند دستیار تخصصی (Multi-agent)

لازم نیست یک دستیار همه‌کاره داشته باشید. OpenClaw اجازه می‌دهد چند Agent جدا تعریف کنید که هرکدام فضای کاری^۱ و حافظهٔ جداگانه دارند — مثلاً یکی «برنامه‌نویس»، یکی «مدیر محتوا». حتی در گروه‌های تلگرامیِ تاپیک‌دار، می‌توانید هر تاپیک را به یک Agent متفاوت وصل کنید. این یعنی یک گروه تلگرام، یک دفترِ کار کامل با چند متخصص!

💬 ترفند ۴ — فرمان‌های داخل چت

در خودِ گفتگوی تلگرام، فرمان‌هایی با / در اختیار دارید؛ چند نمونهٔ پرکاربرد:

فرمان	کاربرد
`/status`	نمایش وضعیت جلسهٔ فعلی
`/activation always`	در گروه: دستیار به همهٔ پیام‌ها پاسخ دهد (فقط برای همین جلسه)
`/activation mention`	در گروه: فقط وقتی منشن شد پاسخ دهد (حالت امن‌تر)
`/reasoning on`	نمایش روند فکرکردن دستیار همراه پاسخ

📡 ترفند ۵ — نمایش زندهٔ پاسخ در تلگرام (Streaming)

به‌صورت پیش‌فرض، OpenClaw پاسخ را همان‌طور که ساخته می‌شود، به‌صورت زنده در پیام تلگرام ویرایش و کامل می‌کند (حالت partial). اگر دوست دارید فقط پاسخ نهایی و تمیز ارسال شود، در فایل پیکربندی، مقدار channels.telegram.streaming را روی "off" بگذارید و Gateway را restart کنید.

🌐 ترفند ۶ — پراکسی برای اتصال پایدار تلگرام

اگر سرور یا کامپیوتر شما برای رسیدن به api.telegram.org مشکل دارد، مستندات رسمی راه‌حل داخلی دارد: در فایل پیکربندی، برای کانال تلگرام یک پراکسی^۲ تعریف کنید:

{
  "channels": {
    "telegram": {
      "proxy": "socks5://user:password@proxy-host:1080"
    }
  }
}

⌨️ ترفند ۷ — منوی فرمان‌های اختصاصی در تلگرام

می‌توانید برای ربات‌تان منوی فرمان شخصی بسازید تا کارهای پرتکرار یک‌ضربه‌ای شوند:

{
  "channels": {
    "telegram": {
      "customCommands": [
        { "command": "backup", "description": "پشتیبان‌گیری گیت" },
        { "command": "generate", "description": "ساخت تصویر" }
      ]
    }
  }
}

📖 پاورقی: ۱) فضای کاری (Workspace): پوشه و حافظهٔ اختصاصی هر Agent؛ مثل میزِ کار جداگانهٔ هر کارمند. ۲) پراکسی (Proxy): واسطه‌ای که ترافیک اینترنتی شما را از مسیر دیگری عبور می‌دهد؛ مثل پیکِ امینی که نامه را از راه باز به مقصد می‌رساند.

💡 نکتهٔ طلایی حرفه‌ای‌ها: بعد از هر تغییر در فایل پیکربندی، این دو فرمان را پشت‌سرهم بزنید: openclaw doctor (بررسی سلامت تنظیمات) و سپس openclaw gateway restart (اعمال تغییرات). این عادت، ۹۰٪ سردرگمی‌ها را حذف می‌کند.

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

۱۰

امنیت — قواعد طلایی

⏱️ ۷ دقیقه مرحله ۱۰ از ۱۲

دستیار شما به ابزارهای واقعی روی کامپیوترتان دسترسی دارد؛ پس امنیت آن، امنیت کامپیوتر شماست. این پنج قاعده را جدی بگیرید:

۱۰-۱) پیام‌های ورودی را «ورودیِ غیرقابل‌اعتماد» بدانید. مستندات رسمی صریح می‌گوید: هر پیام مستقیمی که به ربات می‌رسد باید غیرقابل‌اعتماد فرض شود. به همین دلیل، جفت‌سازی (pairing) را هرگز غیرفعال نکنید.

۱۰-۲) برای ربات تک‌نفره، فهرست مجاز (allowlist) بسازید. مطمئن‌ترین حالت: dmPolicy: "allowlist" به‌همراه شناسهٔ عددی تلگرامِ خودتان در allowFrom. شناسهٔ عددی‌تان را امن پیدا کنید: به ربات‌تان پیام بدهید، openclaw logs --follow را اجرا کنید و مقدار from.id را بخوانید.

۱۰-۳) در گروه‌ها، منشن را اجباری نگه دارید. تنظیم requireMention: true (پیش‌فرض) یعنی دستیار فقط وقتی صدایش کنید جواب می‌دهد — نه به هر پیام گروه.

۱۰-۴) Gateway را روی اینترنت باز نکنید. داشبورد روی 127.0.0.1 یعنی فقط دستگاه خودتان در دسترس است — همین درست است. باز کردن آن برای دسترسی از راه دور، نیازمند دستورالعمل امنیتی مخصوص در مستندات رسمی است؛ بدون مطالعهٔ آن اقدام نکنید.

۱۰-۵) توکن و کلیدها را هرگز جایی نفرستید. توکن ربات و کلید API را در هیچ چتی، اسکرین‌شاتی یا مخزن گیت‌هابی قرار ندهید. اگر لو رفت، در BotFather با /revoke توکن جدید بگیرید و کلید API را در پنل سرویس‌دهنده باطل کنید.

⚠️ مواظب باش: فرمان openclaw doctor تنظیمات پرریسک (مثل سیاست پیام‌های باز) را به شما هشدار می‌دهد. هر چند وقت یک بار — و حتماً بعد از هر تغییر امنیتی — آن را اجرا کنید.

✅ ایست بازرسی: آیا می‌توانید بگویید ربات شما الان در کدام حالت است — pairing ،allowlist یا open؟ اگر جواب open است، همین حالا برگردید و آن را عوض کنید.

۱۱

به‌روزرسانی و نگه‌داری

⏱️ ۵ دقیقه مرحله ۱۱ از ۱۲

OpenClaw پروژه‌ای فعال است و مرتب نسخهٔ جدید می‌دهد. روال درستِ به‌روزرسانی:

۱۱-۱) نسخهٔ جدید را نصب کنید (همان روش نصب اولیه؛ مثلاً npm install -g openclaw@latest).

۱۱-۲) بلافاصله «پزشک» را اجرا کنید — این توصیهٔ صریح مستندات رسمی بعد از هر ارتقاست:

openclaw doctor

اگر تنظیمات قدیمی‌شده‌ای داشته باشید، گاهی openclaw doctor --fix می‌تواند خودش آن‌ها را به قالب جدید مهاجرت دهد.

۱۱-۳) Gateway را دوباره راه‌اندازی کنید: openclaw gateway restart.

💡 نکته: پیش از ارتقاهای بزرگ، یک کپی از فایل ~/.openclaw/openclaw.json در جایی امن نگه دارید — بازگشت به عقب را یک‌دقیقه‌ای می‌کند.

✅ ایست بازرسی: بعد از ارتقا: openclaw --version عدد جدید را نشان می‌دهد و doctor بدون خطای قرمز تمام می‌شود.

۱۲

رفع اشکال 🔧

⏱️ در صورت نیاز مرحله ۱۲ از ۱۲

نشانه	علت رایج	راه‌حل
فرمان `openclaw` «پیدا نشد»	ترمینال قدیمی مسیرِ برنامهٔ تازه‌نصب را نمی‌شناسد	ترمینال را کاملاً ببندید و دوباره باز کنید؛ اگر حل نشد، سیستم را یک بار راه‌اندازی مجدد کنید
خطای `EACCES` هنگام نصب با npm	مشکل مجوز پوشهٔ npm	هرگز با `sudo` نصب نکنید؛ طبق مستندات، مسیر سراسری npm را به پوشهٔ کاربری منتقل کنید و دوباره نصب کنید
داشبورد باز نمی‌شود	Gateway روشن نیست	`openclaw gateway status` را بزنید؛ اگر خاموش بود، `openclaw gateway restart`
دستیار در چت جواب نمی‌دهد ولی داشبورد کار می‌کند	هنوز pairing تأیید نشده یا شناسهٔ شما در allowlist نیست	`openclaw pairing list telegram` و سپس approve؛ یا شناسهٔ عددی‌تان را به `allowFrom` اضافه کنید
خطای `getMe returned 401` در لاگ	توکن ربات تلگرام اشتباه یا باطل‌شده است	توکن را از BotFather دوباره کپی یا با `/revoke` نو کنید و در تنظیمات جای‌گذاری کنید
ربات در گروه به پیام‌های بدون منشن جواب نمی‌دهد	حالت حریم خصوصی تلگرام (Privacy Mode) روشن است	در BotFather فرمان `/setprivacy` را Disable کنید، سپس ربات را از گروه حذف و دوباره اضافه کنید
اتصال تلگرام قطع‌ووصل می‌شود (fetch failed)	مشکل شبکه/DNS در مسیر api.telegram.org	ترفند ۶ مرحلهٔ ۹ (پراکسی اختصاصی تلگرام) را اعمال کنید و restart بزنید
هر مشکل نامشخص دیگر	—	دو دوست همیشگی: `openclaw doctor` و `openclaw logs --follow`؛ پیام خطا معمولاً خودش راه را نشان می‌دهد

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

✅ OpenClaw را نصب کنی و با ویزارد onboard تنظیمات اولیه را کامل انجام دهی
✅ Gateway را مدیریت کنی: وضعیت، restart، لاگ زنده و «پزشک» سیستم
✅ از داشبورد مرورگر و ترمینال با دستیارت کار کنی
✅ تلگرام را امن (با pairing و allowlist) وصل کنی و از گوشی فرمان بدهی
✅ ترفندهای حرفه‌ای را به‌کار ببری: مهارت‌ها، زمان‌بندی، چند Agent، پراکسی و منوی اختصاصی
✅ سیستم را امن نگه داری و اصولی به‌روزرسانی کنی

🏔️ ایستگاه ۶ مسیر صعود را فتح کردی. حالا نه‌فقط بالای قله‌ای، بلکه در قله خانه ساخته‌ای.