# OpenClaw 🦞

"لایه‌برداری کن! لایه‌برداری کن!" — احتمالاً یک خرچنگ فضایی

Gateway برای هر سیستم‌عامل، برای عامل‌های هوش مصنوعی در Discord، Google Chat، iMessage، Matrix، Microsoft Teams، Signal، Slack، Telegram، WhatsApp، Zalo و موارد بیشتر.

پیام بفرستید و پاسخ عامل را از جیب خود دریافت کنید. یک Gateway را در کانال‌های داخلی، Plugin‌های کانال همراه، WebChat و Node‌های موبایل اجرا کنید.

# OpenClaw چیست؟

OpenClaw یک Gateway خودمیزبان است که برنامه‌های گفت‌وگو و سطوح کانالی محبوب شما را — کانال‌های داخلی به‌همراه Plugin‌های کانال همراه یا خارجی مانند Discord، Google Chat، iMessage، Matrix، Microsoft Teams، Signal، Slack، Telegram، WhatsApp، Zalo و موارد بیشتر — به عامل‌های کدنویسی هوش مصنوعی مانند Pi متصل می‌کند. شما یک فرایند Gateway واحد را روی دستگاه خودتان (یا یک سرور) اجرا می‌کنید و این فرایند به پل میان برنامه‌های پیام‌رسان شما و یک دستیار هوش مصنوعی همیشه دردسترس تبدیل می‌شود.

برای چه کسانی است؟ توسعه‌دهندگان و کاربران حرفه‌ای که یک دستیار هوش مصنوعی شخصی می‌خواهند که بتوانند از هر جا به آن پیام بدهند، بدون اینکه کنترل داده‌هایشان را واگذار کنند یا به یک سرویس میزبانی‌شده وابسته باشند.

چه چیزی آن را متفاوت می‌کند؟

• خودمیزبان: روی سخت‌افزار شما و طبق قواعد شما اجرا می‌شود
• چندکاناله: یک Gateway به‌طور هم‌زمان کانال‌های داخلی و Plugin‌های کانال همراه یا خارجی را سرویس می‌دهد
• عامل‌محور: برای عامل‌های کدنویسی با استفاده از ابزار، نشست‌ها، حافظه و مسیریابی چندعاملی ساخته شده است
• متن‌باز: با مجوز MIT و جامعه‌محور

به چه چیزهایی نیاز دارید؟ Node 24 (توصیه‌شده)، یا Node 22 LTS (22.14+) برای سازگاری، یک کلید API از ارائه‌دهنده انتخابی شما، و ۵ دقیقه زمان. برای بهترین کیفیت و امنیت، از قوی‌ترین مدل نسل جدید موجود استفاده کنید.

# چگونه کار می‌کند

flowchart LR
  A["Chat apps + plugins"] --> B["Gateway"]
  B --> C["Pi agent"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS app"]
  B --> G["iOS and Android nodes"]

Gateway منبع واحد حقیقت برای نشست‌ها، مسیریابی و اتصال‌های کانالی است.

# قابلیت‌های کلیدی

# شروع سریع

npm install -g openclaw@latest

openclaw onboard --install-daemon

openclaw dashboard

به نصب کامل و راه‌اندازی توسعه نیاز دارید؟ شروع به کار را ببینید.

# داشبورد

پس از شروع Gateway، رابط کنترل مرورگر را باز کنید.

• پیش‌فرض محلی: http://127.0.0.1:18789/
• دسترسی راه‌دور: سطوح وب و Tailscale

# پیکربندی (اختیاری)

پیکربندی در ~/.openclaw/openclaw.json قرار دارد.

• اگر کاری انجام ندهید، OpenClaw از باینری همراه Pi در حالت RPC با نشست‌های جداگانه برای هر فرستنده استفاده می‌کند.
• اگر می‌خواهید آن را محدود کنید، با channels.whatsapp.allowFrom و (برای گروه‌ها) قواعد اشاره شروع کنید.

نمونه:

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

# از اینجا شروع کنید

# بیشتر بیاموزید