---
read_when:
- معرفی OpenClaw به تازهواردان
summary: OpenClaw یک Gateway چندکاناله برای عاملهای هوش مصنوعی است که روی هر سیستمعاملی اجرا میشود.
title: OpenClaw
x-i18n:
generated_at: "2026-07-27T16:40:34Z"
model: gpt-5.6
postprocess_version: locale-links-v1
prompt_version: 32
provider: openai
source_hash: 0ce948d12d4b4fcbde2597f9b33f50b99c4f677b69e0f5d72677b2f6683291f3
source_path: index.md
workflow: 16
---
# OpenClaw 🦞
> _«پوستاندازی! پوستاندازی!»_ — احتمالاً یک خرچنگ فضایی
Gateway مستقل از سیستمعامل برای عاملهای هوش مصنوعی در Discord، Google Chat، iMessage، Matrix، Microsoft Teams، Signal، Slack، Telegram، WhatsApp، Zalo و موارد دیگر.
پیام بفرستید و پاسخ عامل را در جیب خود دریافت کنید. یک Gateway را در میان Pluginهای کانال، WebChat و Nodeهای همراه اجرا کنید.
توسعهیافته بهصورت آزاد توسط بنیاد OpenClaw، یک سازمان غیرانتفاعی.
OpenClaw را نصب کنید و Gateway را ظرف چند دقیقه راهاندازی کنید.
راهاندازی هدایتشده با `openclaw onboard` و جریانهای جفتسازی.
Discord، Signal، Telegram، WhatsApp و موارد دیگر را متصل کنید تا از هرجا گفتوگو کنید.
داشبورد مرورگر را برای گفتوگو، پیکربندی و نشستها اجرا کنید.
## مرور مستندات
مرورگرهای همراه ممکن است منوی بخش را بدون نوار کامل زبانههای دسکتاپ نمایش دهند. از
این پیوندهای مرکزی برای دسترسی به همان بخشهای سطحبالای مستندات از داخل صفحه استفاده کنید.
نمای کلی، ویترین، گامهای نخست و راهنماهای راهاندازی.
روشهای نصب، بهروزرسانیها، کانتینرها، میزبانی و راهاندازی پیشرفته.
کانالهای پیامرسانی، جفتسازی، مسیریابی، گروههای دسترسی و تضمین کیفیت کانال.
معماری، نشستها، زمینه، حافظه و مسیریابی چندعاملی.
ابزارها، Skills، cron، webhookها و قابلیتهای خودکارسازی.
بازار Plugin، انتشار، گزینش و راهنمای اعتماد.
ارائهدهندگان، پیکربندی مدل، جایگزینی هنگام خرابی و سرویسهای مدل محلی.
macOS، Windows، iOS، Android، Nodeها و رابطهای وب.
پیکربندی، امنیت، عیبیابی و عملیات Gateway.
مرجع CLI، طرحوارهها، RPC، یادداشتهای انتشار و الگوها.
رفع اشکال، پرسشهای متداول، آزمایش، عیبیابی و بررسیهای محیطی.
## OpenClaw چیست؟
OpenClaw یک **Gateway خودمیزبان** است که برنامههای گفتوگوی محبوب شما — Discord، Google Chat، iMessage، Matrix، Microsoft Teams، Signal، Slack، Telegram، WhatsApp، Zalo و موارد دیگر از طریق Pluginهای کانال — را به عاملهای کدنویسی هوش مصنوعی متصل میکند. یک فرایند Gateway را روی دستگاه خودتان (یا یک سرور) اجرا میکنید و آن به پلی میان برنامههای پیامرسانی شما و یک دستیار هوش مصنوعی همیشهدردسترس تبدیل میشود.
**برای چه کسانی است؟** توسعهدهندگان و کاربران حرفهای که دستیار هوش مصنوعی شخصی میخواهند تا از هرجا به آن پیام بدهند، بدون آنکه کنترل دادههایشان را واگذار کنند یا به یک سرویس میزبانیشده متکی باشند.
**چه چیزی آن را متمایز میکند؟**
- **خودمیزبان**: روی سختافزار شما و طبق قواعد شما اجرا میشود
- **چندکاناله**: یک Gateway بهطور همزمان به تمام Pluginهای کانال پیکربندیشده سرویس میدهد
- **عاملمحور**: برای عاملهای کدنویسی با امکان استفاده از ابزار، نشستها، حافظه و مسیریابی چندعاملی ساخته شده است
- **متنباز**: دارای مجوز MIT و جامعهمحور
**به چه چیزهایی نیاز دارید؟** Node 24.15+ (توصیهشده)، Node 22 LTS (`22.22.3+`) برای سازگاری، یا Node 25.9+، یک کلید API از ارائهدهنده منتخب و 5 دقیقه زمان. برای بهترین کیفیت و امنیت، از قدرتمندترین مدل نسل جدید موجود استفاده کنید.
## نحوه کار
```mermaid
flowchart LR
A["برنامههای گفتوگو + Pluginها"] --> B["Gateway"]
B --> C["عامل OpenClaw"]
B --> D["CLI"]
B --> E["رابط کنترل وب"]
B --> F["برنامه macOS"]
B --> G["Nodeهای iOS و Android"]
```
Gateway منبع واحد حقیقت برای نشستها، مسیریابی و اتصالهای کانال است.
## قابلیتهای کلیدی
Discord، iMessage، Signal، Slack، Telegram، WhatsApp، WebChat و موارد دیگر با یک فرایند Gateway.
Pluginهای کانال، Matrix، Nostr، Twitch، Zalo و موارد دیگر را اضافه میکنند؛ Pluginهای رسمی در صورت نیاز نصب میشوند.
نشستهای جداگانه برای هر عامل، فضای کاری یا فرستنده.
تصاویر، صدا و اسناد را ارسال و دریافت کنید.
داشبورد مرورگر برای گفتوگو، پیکربندی، نشستها و Nodeها.
Nodeهای iOS و Android را برای Canvas، دوربین و جریانهای کاری صوتی جفت کنید.
## شروع سریع
```bash
npm install -g openclaw@latest
```
```bash
openclaw onboard --install-daemon
```
رابط کنترل را در مرورگر باز کنید و پیامی بفرستید:
```bash
openclaw dashboard
```
یا یک کانال متصل کنید ([Telegram](/fa/channels/telegram) سریعترین است) و از تلفن خود گفتوگو کنید.
به نصب کامل و راهاندازی توسعه نیاز دارید؟ [شروع به کار](/fa/start/getting-started) را ببینید.
## داشبورد
پس از شروع Gateway، رابط کنترل مرورگر را باز کنید.
- پیشفرض محلی: [http://127.0.0.1:18789/](http://127.0.0.1:18789/)
- دسترسی از راه دور: [رابطهای وب](/fa/web) و [Tailscale](/fa/gateway/tailscale)
## پیکربندی (اختیاری)
پیکربندی در `~/.openclaw/openclaw.json` قرار دارد.
- اگر **هیچ کاری نکنید**، OpenClaw از محیط اجرای عامل OpenClaw همراه استفاده میکند؛ پیامهای مستقیم نشست اصلی عامل را به اشتراک میگذارند و هر گفتوگوی گروهی نشست مستقل خود را دریافت میکند.
- اگر میخواهید دسترسی را محدود کنید، از `channels.whatsapp.allowFrom` و (برای گروهها) قواعد اشاره شروع کنید.
مثال:
```json5
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
```
## از اینجا شروع کنید
همه مستندات و راهنماها، سازماندهیشده بر اساس مورد استفاده.
تنظیمات اصلی Gateway، توکنها و پیکربندی ارائهدهنده.
الگوهای دسترسی SSH و tailnet.
راهاندازی مختص کانال برای Discord، Feishu، Microsoft Teams، Telegram، WhatsApp و موارد دیگر.
Nodeهای iOS و Android با جفتسازی، Canvas، دوربین و کنشهای دستگاه.
نقطه شروع برای راهحلهای رایج و رفع اشکال.
## بیشتر بیاموزید
قابلیتهای کامل کانال، مسیریابی و رسانه.
جداسازی فضای کاری و نشستهای مختص هر عامل.
توکنها، فهرستهای مجاز و کنترلهای ایمنی.
عیبیابی Gateway و خطاهای رایج.
خاستگاه پروژه، مشارکتکنندگان و مجوز.