From d23c542a5800f9b41989199c3c97db79487a2dcf Mon Sep 17 00:00:00 2001 From: Usama Saqib Date: Fri, 27 Feb 2026 00:28:53 +0100 Subject: [PATCH] Added README.urdu.md for Urdu speaking audience --- README.fr.md | 2 +- README.ja.md | 2 +- README.pt-br.md | 2 +- README.urdu.md | 1195 +++++++++++++++++++++++++++++++++++++++++++++++ README.vi.md | 2 +- README.zh.md | 2 +- 6 files changed, 1200 insertions(+), 5 deletions(-) create mode 100644 README.urdu.md diff --git a/README.fr.md b/README.fr.md index f1d4f848e..077ec3b3c 100644 --- a/README.fr.md +++ b/README.fr.md @@ -14,7 +14,7 @@ Twitter

- [中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [English](README.md) | **Français** + [中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [English](README.md) | [Urdu](README.urdu.md) | **Français** --- diff --git a/README.ja.md b/README.ja.md index 48fb89fe3..e28614ed6 100644 --- a/README.ja.md +++ b/README.ja.md @@ -12,7 +12,7 @@ License

-[中文](README.zh.md) | **日本語** | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md) +[中文](README.zh.md) | **日本語** | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [Urdu](README.urdu.md) | [English](README.md) diff --git a/README.pt-br.md b/README.pt-br.md index 1dbee5201..dfbb5e5a9 100644 --- a/README.pt-br.md +++ b/README.pt-br.md @@ -14,7 +14,7 @@ Twitter

- [中文](README.zh.md) | [日本語](README.ja.md) | **Português** | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md) + [中文](README.zh.md) | [日本語](README.ja.md) | **Português** | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [Urdu](README.urdu.md) | [English](README.md) --- diff --git a/README.urdu.md b/README.urdu.md new file mode 100644 index 000000000..47ee046e4 --- /dev/null +++ b/README.urdu.md @@ -0,0 +1,1195 @@ +
+ PicoClaw + +

PicoClaw: انتہائی مؤثر AI معاون گو میں

+ +

$10 ہارڈویئر · 10MB ریم · 1 سیکنڈ بوٹ · 皮皮虾，我们走！

+ +

+ Go + Hardware + License +
+ Website + Twitter +
+ + Discord +

+ +[中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md) | **اردو** + +
+ +--- + +🦐 PicoClaw ایک انتہائی ہلکا پھلکا ذاتی AI معاون ہے جو [nanobot](https://github.com/HKUDS/nanobot) سے متاثر ہو کر بنایا گیا ہے، اور اسے گو میں نئے سرے سے تیار کیا گیا ہے۔ یہ ایک خود بوٹ اسٹریپنگ عمل کے ذریعے تیار کیا گیا ہے، جہاں AI ایجنٹ نے خود پورے آرکیٹیکچرل مائیگریشن اور کوڈ کی اصلاح کو انجام دیا۔ + +⚡️ $10 ہارڈویئر پر <10MB ریم کے ساتھ چلتا ہے: یہ OpenClaw سے 99% کم میموری اور Mac mini سے 98% سستا ہے! + + + + + + +
+

+ +

+ 		+

+ +

+
+ +> [!CAUTION] +> **🚨 سیکیورٹی اور آفیشل چینلز / حفاظتی بیان** +> +> * **کوئی کرپٹو نہیں:** PicoClaw کا **کوئی** آفیشل ٹوکن/کوائن نہیں ہے۔ `pump.fun` یا دیگر تجارتی پلیٹ فارمز پر تمام دعوے **فراڈ** ہیں۔ +> +> * **آفیشل ڈومین:** **[picoclaw.io](https://picoclaw.io)** واحد آفیشل ویب سائٹ ہے، اور کمپنی کی ویب سائٹ **[sipeed.com](https://sipeed.com)** ہے۔ +> * **انتباہ:** بہت سے `.ai/.org/.com/.net/...` ڈومینز تیسرے فریق کے ذریعے رجسٹرڈ ہیں۔ +> * **انتباہ:** PicoClaw ابھی ابتدائی ترقی کے مراحل میں ہے اور اس میں نیٹ ورک سیکیورٹی کے نامعلوم مسائل ہو سکتے ہیں۔ v1.0 ریلیز سے پہلے پروڈکشن ماحول میں تعینات نہ کریں۔ +> * **نوٹ:** PicoClaw نے حال ہی میں بہت سے PRs کو ضم کیا ہے، جس کی وجہ سے تازہ ترین ورژنز میں میموری کے استعمال میں اضافہ (10–20MB) ہو سکتا ہے۔ ہم موجودہ فیچر سیٹ کے مستحکم ہونے کے بعد وسائل کی اصلاح کو ترجیح دیں گے۔ + +## 📢 خبریں + +2026-02-16 🎉 PicoClaw نے ایک ہفتے میں 12K ستارے حاصل کیے! آپ سب کے تعاون کا شکریہ! PicoClaw ہماری توقعات سے زیادہ تیزی سے بڑھ رہا ہے۔ PRs کی بڑی تعداد کے پیش نظر، ہمیں کمیونٹی کے منتظمین کی اشد ضرورت ہے۔ ہمارے رضاکارانہ کردار اور روڈ میپ [یہاں](docs/ROADMAP.md) پوسٹ کیے گئے ہیں — ہم آپ کو شامل کرنے کے منتظر ہیں! + +2026-02-13 🎉 PicoClaw نے 4 دن میں 5000 ستارے حاصل کیے! کمیونٹی کا شکریہ! بہت سے PRs اور مسائل آ رہے ہیں (چینی نئے سال کی تعطیلات کے دوران)، ہم پروجیکٹ روڈ میپ کو حتمی شکل دے رہے ہیں اور PicoClaw کی ترقی کو تیز کرنے کے لیے ڈویلپر گروپ قائم کر رہے ہیں۔ +🚀 ایکشن کے لیے کال: براہ کرم اپنی فیچر کی درخواستیں GitHub Discussions میں جمع کروائیں۔ ہم انہیں اپنی آئندہ ہفتہ وار میٹنگ کے دوران جائزہ لیں گے اور ترجیح دیں گے۔ + +2026-02-09 🎉 PicoClaw لانچ کیا گیا! $10 ہارڈویئر پر <10MB RAM کے ساتھ AI ایجنٹس لانے کے لیے 1 دن میں بنایا گیا۔ 🦐 PicoClaw، چلو چلیں！ + +## ✨ خصوصیات + +🪶 **انتہائی ہلکا پھلکا**: <10MB میموری کا استعمال — Clawdbot کے بنیادی فنکشن سے 99% چھوٹا۔ + +💰 **کم سے کم لاگت**: $10 ہارڈویئر پر چلنے کے لیے کافی مؤثر — Mac mini سے 98% سستا۔ + +⚡️ **بجلی کی رفتار**: 400X تیز اسٹارٹ اپ وقت، 0.6GHz سنگل کور میں بھی 1 سیکنڈ میں بوٹ۔ + +🌍 **حقیقی پورٹیبلٹی**: RISC-V، ARM، اور x86 کے لیے ایک ہی خود مختار بائنری، ایک کلک میں چلائیں! + +🤖 **AI کے ذریعے بوٹ اسٹریپڈ**: خود مختار Go-native عمل درآمد — 95% ایجنٹ کے ذریعہ تیار کردہ بنیادی کوڈ انسانی مداخلت کے ساتھ۔ + +| | OpenClaw | NanoBot | **PicoClaw** | +| ----------------------------- | ------------- | ------------------------ | ----------------------------------------- | +| **زبان** | TypeScript | Python | **Go** | +| **RAM** | >1GB | >100MB | **< 10MB** | +| **اسٹارٹ اپ**
(0.8GHz کور) | >500s | >30s | **<1s** | +| **لاگت** | Mac Mini 599$ | زیادہ تر Linux SBC
~50$ | **کوئی بھی Linux بورڈ**
**صرف $10 جتنا سستا** | + +PicoClaw + +## 🦾 مظاہرہ + +### 🛠️ معیاری معاون ورک فلوز + + + + + + + + + + + + + + + + + +

🧩 مکمل اسٹیک انجینیر

🗂️ لاگنگ اور منصوبہ بندی کا انتظام

🔎 ویب سرچ اور سیکھنا

تیار کریں • تعینات کریں • توسیع دیںشیڈول • خودکار بنائیں • میموریدریافت • بصیرت • رجحانات
+ +### 📱 پرانے Android فونز پر چلائیں + +اپنے دہائی پرانے فون کو دوسری زندگی دیں! اسے PicoClaw کے ساتھ ایک ذہین AI معاون میں تبدیل کریں۔ فوری شروعات: + +1. **Termux انسٹال کریں** (F-Droid یا Google Play پر دستیاب)۔ +2. **کمانڈز چلائیں** + +```bash +# نوٹ: v0.1.1 کو Releases صفحہ سے تازہ ترین ورژن سے بدلیں +wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64 +chmod +x picoclaw-linux-arm64 +pkg install proot +termux-chroot ./picoclaw-linux-arm64 onboard +``` + +اور پھر "فوری شروعات" حصے میں ہدایات پر عمل کریں تاکہ ترتیب مکمل کریں! +PicoClaw + +### 🐜 جدید کم فوٹ پرنٹ تعینات + +PicoClaw تقریباً کسی بھی Linux ڈیوائس پر تعینات کیا جا سکتا ہے! + +- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) E(Ethernet) یا W(WiFi6) ورژن، کم سے کم ہوم معاون کے لیے +- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html)، یا $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) خودکار سرور کی دیکھ بھال کے لیے +- $50 [MaixCAM](https://www.aliexpress.com/item/1005008053333693.html) یا $100 [MaixCAM2](https://www.kickstarter.com/projects/zepan/maixcam2-build-your-next-gen-4k-ai-camera) سمارٹ نگرانی کے لیے + + + +🌟 مزید تعینات کے معاملات انتظار میں ہیں! + +## 📦 انسٹال + +### پرے کمپائل شدہ بائنری کے ساتھ انسٹال کریں + +اپنے پلیٹ فارم کے لیے فرم ویئر [ریلیز](https://github.com/sipeed/picoclaw/releases) صفحہ سے ڈاؤن لوڈ کریں۔ + +### ماخذ سے انسٹال کریں (تازہ ترین خصوصیات، ترقی کے لیے سفارش کی گئی) + +```bash +git clone https://github.com/sipeed/picoclaw.git + +cd picoclaw +make deps + +# تعمیر کریں، انسٹال کرنے کی ضرورت نہیں +make build + +# متعدد پلیٹ فارمز کے لیے تعمیر کریں +make build-all + +# تعمیر اور انسٹال کریں +make install +``` + +## 🐳 Docker Compose + +آپ Docker Compose کا استعمال کرتے ہوئے PicoClaw کو چلا سکتے ہیں بغیر کسی چیز کو مقامی طور پر انسٹال کیے۔ + +```bash +# 1. اس ریپو کو کلون کریں +git clone https://github.com/sipeed/picoclaw.git +cd picoclaw + +# 2. اپنی API کلیدیں سیٹ کریں +cp config/config.example.json config/config.json +vim config/config.json # DISCORD_BOT_TOKEN، API کلیدیں، وغیرہ سیٹ کریں + +# 3. تعمیر اور شروع کریں +docker compose --profile gateway up -d + +> [!TIP] +> **Docker صارفین**: بطور ڈیفالٹ، Gateway `127.0.0.1` پر سنتا ہے جو میزبان سے قابل رسائی نہیں ہے۔ اگر آپ کو ہیلتھ اینڈ پوائنٹس تک رسائی حاصل کرنی ہے یا پورٹس میں نمایاں کرنا ہے، تو اپنی ماحول میں `PICOCLAW_GATEWAY_HOST=0.0.0.0` سیٹ کریں یا `config.json` کو اپ ڈیٹ کریں۔ + +# 4. لاگز چیک کریں +docker compose logs -f picoclaw-gateway + +# 5. رکیں +docker compose --profile gateway down +``` + +### ایجنٹ موڈ (ایک بار کا) + +```bash +# سوال پوچھیں +docker compose run --rm picoclaw-agent -m "2+2 کیا ہے؟" + +# انٹرایکٹو موڈ +docker compose run --rm picoclaw-agent +``` + +### دوبارہ تعمیر کریں + +```bash +docker compose --profile gateway build --no-cache +docker compose --profile gateway up -d +``` + +### 🚀 فوری شروعات + +> [!TIP] +> اپنی API کلید `~/.picoclaw/config.json` میں سیٹ کریں۔ +> API کلیدیں حاصل کریں: [OpenRouter](https://openrouter.ai/keys) (LLM) · [Zhipu](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) (LLM) +> ویب سرچ **اختیاری** ہے - مفت [Tavily API](https://tavily.com) حاصل کریں (1000 مفت سوالات/ماہ) یا [Brave Search API](https://brave.com/search/api) (2000 مفت سوالات/ماہ) یا بلٹ ان خودکار fallback استعمال کریں۔ + +**1. شروع کریں** + +```bash +picoclaw onboard +``` + +**2. ترتیب دیں** (`~/.picoclaw/config.json`) + +```json +{ + "agents": { + "defaults": { + "workspace": "~/.picoclaw/workspace", + "model_name": "gpt4", + "max_tokens": 8192, + "temperature": 0.7, + "max_tool_iterations": 20 + } + }, + "model_list": [ + { + "model_name": "gpt4", + "model": "openai/gpt-5.2", + "api_key": "your-api-key", + "request_timeout": 300 + }, + { + "model_name": "claude-sonnet-4.6", + "model": "anthropic/claude-sonnet-4.6", + "api_key": "your-anthropic-key" + } + ], + "tools": { + "web": { + "brave": { + "enabled": false, + "api_key": "YOUR_BRAVE_API_KEY", + "max_results": 5 + }, + "tavily": { + "enabled": false, + "api_key": "YOUR_TAVILY_API_KEY", + "max_results": 5 + }, + "duckduckgo": { + "enabled": true, + "max_results": 5 + } + } + } +} +``` + +> **نیا**: `model_list` ترتیب کی شکل صفر کوڈ فراہم کنندہ اضافے کی اجازت دیتی ہے۔ تفصیلات کے لیے [ماڈل ترتیب](#model-configuration-model_list) دیکھیں۔ +> `request_timeout` اختیاری ہے اور سیکنڈ میں ہے۔ اگر حذف کیا جائے یا `<= 0` پر سیٹ کیا جائے، تو PicoClaw ڈیفالٹ ٹائم آؤٹ استعمال کرتا ہے (120s)۔ + +**3. API کلیدیں حاصل کریں** + +* **LLM فراہم کنندہ**: [OpenRouter](https://openrouter.ai/keys) · [Zhipu](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) · [Anthropic](https://console.anthropic.com) · [OpenAI](https://platform.openai.com) · [Gemini](https://aistudio.google.com/api-keys) +* **ویب سرچ** (اختیاری): [Tavily](https://tavily.com) - AI ایجنٹس کے لیے بہتری (1000 درخواستیں/ماہ) · [Brave Search](https://brave.com/search/api) - مفت سطح دستیاب (2000 درخواستیں/ماہ) + +> **نوٹ**: مکمل ترتیب ٹیمپلیٹ کے لیے `config.example.json` دیکھیں۔ + +**4. بات چیت کریں** + +```bash +picoclaw agent -m "2+2 کیا ہے؟" +``` + +بس! آپ کے پاس 2 منٹ میں کام کرنے والا AI معاون ہے۔ + +--- + +## 💬 چیٹ ایپس + +اپنے picoclaw سے Telegram، Discord، DingTalk، LINE، یا WeCom کے ذریعے بات کریں + +| چینل | سیٹ اپ | +| ------------ | ---------------------------------- | +| **Telegram** | آسان (صرف ایک ٹوکن) | +| **Discord** | آسان (بوٹ ٹوکن + intents) | +| **QQ** | آسان (AppID + AppSecret) | +| **DingTalk** | درمیانی (ایپ کریڈنشلز) | +| **LINE** | درمیانی (کریڈنشلز + webhook URL) | +| **WeCom** | درمیانی (CorpID + webhook سیٹ اپ) | + +
+Telegram (سفارش کی گئی) + +**1. بوٹ بنائیں** + +* Telegram کھولیں، `@BotFather` تلاش کریں +* `/newbot` بھیجیں، ہدایات پر عمل کریں +* ٹوکن کاپی کریں + +**2. ترتیب دیں** + +```json +{ + "channels": { + "telegram": { + "enabled": true, + "token": "YOUR_BOT_TOKEN", + "allow_from": ["YOUR_USER_ID"] + } + } +} +``` + +> Telegram پر `@userinfobot` سے اپنی صارف ID حاصل کریں۔ + +**3. چلائیں** + +```bash +picoclaw gateway +``` + +
+ +
+Discord + +**1. بوٹ بنائیں** + +* پر جائیں +* ایک ایپلیکیشن بنائیں → بوٹ → بوٹ شامل کریں +* بوٹ ٹوکن کاپی کریں + +**2. intents فعال کریں** + +* بوٹ کی ترتیبات میں، **MESSAGE CONTENT INTENT** فعال کریں +* (اختیاری) **SERVER MEMBERS INTENT** فعال کریں اگر آپ ممبر ڈیٹا کی بنیاد پر اجازت کی فہرستوں کو استعمال کرنا چاہتے ہیں + +**3. اپنی صارف ID حاصل کریں** +* Discord ترتیبات → Advanced → **Developer Mode** فعال کریں +* اپنے اوتار پر دائیں کلک کریں → **Copy User ID** + +**4. ترتیب دیں** + +```json +{ + "channels": { + "discord": { + "enabled": true, + "token": "YOUR_BOT_TOKEN", + "allow_from": ["YOUR_USER_ID"], + "mention_only": false + } + } +} +``` + +**5. بوٹ کو دعوت دیں** + +* OAuth2 → URL Generator +* Scopes: `bot` +* بوٹ اجازتیں: `پیغامات بھیجیں`، `پیغام کی تاریخ پڑھیں` +* تیار کردہ دعوت کے URL کو کھولیں اور بوٹ کو اپنے سرور میں شامل کریں + +**اختیاری: صرف تنبیہ موڈ** + +بوٹ کو صرف @-تنبیہ شدہ صورت میں جواب دینے کے لیے `"mention_only": true` سیٹ کریں۔ مشترکہ سرورز کے لیے مفید جہاں آپ چاہتے ہیں کہ بوٹ صرف واضح طور پر کال کرتے وقت جواب دے۔ + +**6. چلائیں** + +```bash +picoclaw gateway +``` + +
+ +
+QQ + +**1. بوٹ بنائیں** + +- [QQ Open Platform](https://q.qq.com/#) پر جائیں +- ایک ایپلیکیشن بنائیں → **AppID** اور **AppSecret** حاصل کریں + +**2. ترتیب دیں** + +```json +{ + "channels": { + "qq": { + "enabled": true, + "app_id": "YOUR_APP_ID", + "app_secret": "YOUR_APP_SECRET", + "allow_from": [] + } + } +} +``` + +> تمام صارفین کی اجازت دینے کے لیے `allow_from` کو خالی رکھیں، یا رسائی محدود کرنے کے لیے QQ نمبر مخصوص کریں۔ + +**3. چلائیں** + +```bash +picoclaw gateway +``` + +
+ +
+DingTalk + +**1. بوٹ بنائیں** + +* [Open Platform](https://open.dingtalk.com/) پر جائیں +* ایک اندرونی ایپ بنائیں +* کلائنٹ ID اور کلائنٹ خفیہ کاپی کریں + +**2. ترتیب دیں** + +```json +{ + "channels": { + "dingtalk": { + "enabled": true, + "client_id": "YOUR_CLIENT_ID", + "client_secret": "YOUR_CLIENT_SECRET", + "allow_from": [] + } + } +} +``` + +> تمام صارفین کی اجازت دینے کے لیے `allow_from` کو خالی رکھیں، یا رسائی محدود کرنے کے لیے DingTalk صارف IDs مخصوص کریں۔ + +**3. چلائیں** + +```bash +picoclaw gateway +``` +
+ +
+LINE + +**1. ایک LINE آفیشل اکاؤنٹ بنائیں** + +- [LINE Developers Console](https://developers.line.biz/) پر جائیں +- ایک فراہم کنندہ بنائیں → ایک Messaging API چینل بنائیں +- **Channel Secret** اور **Channel Access Token** کاپی کریں + +**2. ترتیب دیں** + +```json +{ + "channels": { + "line": { + "enabled": true, + "channel_secret": "YOUR_CHANNEL_SECRET", + "channel_access_token": "YOUR_CHANNEL_ACCESS_TOKEN", + "webhook_host": "0.0.0.0", + "webhook_port": 18791, + "webhook_path": "/webhook/line", + "allow_from": [] + } + } +} +``` + +**3. Webhook URL سیٹ اپ کریں** + +LINE کو webhooks کے لیے HTTPS کی ضرورت ہے۔ ایک ریورس پروکسی یا ٹنل استعمال کریں: + +```bash +# ngrok کی مثال +ngrok http 18791 +``` + +پھر LINE Developers Console میں Webhook URL کو `https://your-domain/webhook/line` پر سیٹ کریں اور **Use webhook** فعال کریں۔ + +**4. چلائیں** + +```bash +picoclaw gateway +``` + +> گروپ چیٹس میں، بوٹ صرف @تنبیہ شدہ ہونے پر جواب دیتا ہے۔ جوابات اصل پیغام کو حوالہ دیتے ہیں۔ + +> **Docker Compose**: webhook پورٹ کو بے نقاب کرنے کے لیے `picoclaw-gateway` سروس میں `ports: ["18791:18791"]` شامل کریں۔ + +
+ +
+WeCom (企业微信) + +PicoClaw دو قسم کی WeCom کی انضمام کی حمایت کرتا ہے: + +**آپشن 1: WeCom بوٹ (智能机器人)** - آسان سیٹ اپ، گروپ چیٹس کو سپورٹ کرتا ہے +**آپشن 2: WeCom ایپ (自建应用)** - مزید خصوصیات، فعال پیغام رسانی + +تفصیلی سیٹ اپ ہدایات کے لیے [WeCom ایپ ترتیب گائیڈ](docs/wecom-app-configuration.md) دیکھیں۔ + +**فوری سیٹ اپ - WeCom بوٹ:** + +**1. بوٹ بنائیں** + +* WeCom Admin Console → Group Chat → Add Group Bot پر جائیں +* webhook URL کاپی کریں (فارمیٹ: `https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx`) + +**2. ترتیب دیں** + +```json +{ + "channels": { + "wecom": { + "enabled": true, + "token": "YOUR_TOKEN", + "encoding_aes_key": "YOUR_ENCODING_AES_KEY", + "webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY", + "webhook_host": "0.0.0.0", + "webhook_port": 18793, + "webhook_path": "/webhook/wecom", + "allow_from": [] + } + } +} +``` + +**فوری سیٹ اپ - WeCom ایپ:** + +**1. ایک ایپ بنائیں** + +* WeCom Admin Console → ایپ مینجمنٹ → ایپ بنائیں پر جائیں +* **AgentId** اور **Secret** کاپی کریں +* "My Company" صفحہ پر جائیں، **CorpID** کاپی کریں +**2. پیغام وصول کرنے کی ترتیب** + +* ایپ تفصیلات میں، "پیغام وصول کریں" → "API سیٹ کریں" پر کلک کریں +* URL کو `http://your-server:18792/webhook/wecom-app` پر سیٹ کریں +* **Token** اور **EncodingAESKey** تیار کریں + +**3. ترتیب دیں** + +```json +{ + "channels": { + "wecom_app": { + "enabled": true, + "corp_id": "wwxxxxxxxxxxxxxxxx", + "corp_secret": "YOUR_CORP_SECRET", + "agent_id": 1000002, + "token": "YOUR_TOKEN", + "encoding_aes_key": "YOUR_ENCODING_AES_KEY", + "webhook_host": "0.0.0.0", + "webhook_port": 18792, + "webhook_path": "/webhook/wecom-app", + "allow_from": [] + } + } +} +``` + +**4. چلائیں** + +```bash +picoclaw gateway +``` + +> **نوٹ**: WeCom ایپ کو webhook کالبیکس کے لیے پورٹ 18792 کھولنے کی ضرورت ہے۔ HTTPS کے لیے ریورس پروکسی استعمال کریں۔ + +
+ +## ClawdChat ایجنٹ سوشل نیٹ ورک میں شامل ہوں + +CLI یا کسی بھی انضمام شدہ چیٹ ایپس کے ذریعے ایک سادہ پیغام بھیج کر Picoclaw کو ایجنٹ سوشل نیٹ ورک سے منسلک کریں۔ + +**`https://clawdchat.ai/skill.md` پڑھیں اور [ClawdChat.ai](https://clawdchat.ai) میں شامل ہونے کی ہدایات پر عمل کریں** + +## ⚙️ ترتیب + +ترتیب فائل: `~/.picoclaw/config.json` + +### Workspace کا منصوبہ + +PicoClaw آپ کے ترتیب شدہ workspace میں ڈیٹا ذخیرہ کرتا ہے (ڈیفالٹ: `~/.picoclaw/workspace`): + +``` +~/.picoclaw/workspace/ +├── sessions/ # گفتگو کے سیشنز اور تاریخ +├── memory/ # طویل مدتی میموری (MEMORY.md) +├── state/ # مستقل حالت (آخری چینل، وغیرہ) +├── cron/ # شیڈول شدہ کاموں کی ڈیٹا بیس +├── skills/ # کسٹم مہارتیں +├── AGENTS.md # ایجنٹ کے رویے کی گائیڈ +├── HEARTBEAT.md # دورانیہ کام کے اشارے (ہر 30 منٹ چیک کیا جاتا ہے) +├── IDENTITY.md # ایجنٹ کی شناخت +├── SOUL.md # ایجنٹ کی روح +├── TOOLS.md # ٹول کی تفصیلات +└── USER.md # صارف کی ترجیحات +``` + +### 🔒 سیکیورٹی Sandbox + +PicoClaw بطور ڈیفالٹ ایک سینڈ بکس شدہ ماحول میں چلتا ہے۔ ایجنٹ صرف ترتیب شدہ workspace کے اندر فائلوں تک رسائی حاصل کر سکتا ہے اور کمانڈز انجام دے سکتا ہے۔ + +#### ڈیفالٹ ترتیب + +```json +{ + "agents": { + "defaults": { + "workspace": "~/.picoclaw/workspace", + "restrict_to_workspace": true + } + } +} +``` + +| آپشن | ڈیفالٹ | تفصیل | +| ----------------------- | ----------------------- | ----------------------------------------- | +| `workspace` | `~/.picoclaw/workspace` | ایجنٹ کے لیے کام کرنے والی ڈائریکٹری | +| `restrict_to_workspace` | `true` | فائل/کمانڈ رسائی کو workspace تک محدود کریں | + +#### حفاظت سے محفوظ ٹولز + +جب `restrict_to_workspace: true` ہو، تو درج ذیل ٹولز sandbox میں ہوتے ہیں: + +| ٹول | فنکشن | پابندی | +| ------------- | ---------------- | -------------------------------------- | +| `read_file` | فائلیں پڑھیں | صرف workspace کے اندر فائلیں | +| `write_file` | فائلیں لکھیں | صرف workspace کے اندر فائلیں | +| `list_dir` | ڈائریکٹریز درج کریں | صرف workspace کے اندر ڈائریکٹریز | +| `edit_file` | فائلیں ترمیم کریں | صرف workspace کے اندر فائلیں | +| `append_file` | فائلوں میں شامل کریں | صرف workspace کے اندر فائلیں | +| `exec` | کمانڈز انجام دیں | کمانڈ راستے workspace کے اندر ہونے چاہیں | + +#### اضافی Exec حفاظت + +یہاں تک کہ `restrict_to_workspace: false` کے ساتھ، `exec` ٹول ان خطرناک کمانڈز کو روکتا ہے: + +* `rm -rf`، `del /f`، `rmdir /s` — بڑے پیمانے پر حذف +* `format`، `mkfs`، `diskpart` — ڈسک فارمیٹنگ +* `dd if=` — ڈسک امیجنگ +* `/dev/sd[a-z]` میں لکھنا — براہ راست ڈسک لکھنا +* `shutdown`، `reboot`، `poweroff` — سسٹم شٹ ڈاؤن +* Fork bomb `:(){ :|:& };:` + +#### خرابی کی مثالیں + +``` +[ERROR] tool: ٹول کی انجام دہی ناکام ہو گئی +{tool=exec, error=کمانڈ سیفٹی گارڈ کے ذریعے بلاک کیا گیا (کام کری ڈائریکٹری کے باہر راستہ)} +``` + +``` +[ERROR] tool: ٹول کی انجام دہی ناکام ہو گئی +{tool=exec, error=کمانڈ سیفٹی گارڈ کے ذریعے بلاک کیا گیا (خطرناک پیٹرن دریافت کیا گیا)} +``` + +#### پابندیوں کو غیر فعال کریں (سیکیورٹی کا خطرہ) + +اگر آپ کو ایجنٹ کو workspace کے باہر راستوں تک رسائی حاصل کرنے کی ضرورت ہے: + +**طریقہ 1: ترتیب فائل** + +```json +{ + "agents": { + "defaults": { + "restrict_to_workspace": false + } + } +} +``` + +**طریقہ 2: ماحول متغیر** + +```bash +export PICOCLAW_AGENTS_DEFAULTS_RESTRICT_TO_WORKSPACE=false +``` + +> ⚠️ **انتباہ**: اس پابندی کو غیر فعال کرنا ایجنٹ کو آپ کے نظام پر کسی بھی راستے تک رسائی حاصل کرنے کی اجازت دیتا ہے۔ صرف کنٹرول شدہ ماحول میں احتیاط سے استعمال کریں۔ + +#### سیکیورٹی کی حدود میں مطابقت + +`restrict_to_workspace` ترتیب تمام execution راستوں میں مطابقت سے لاگو ہوتی ہے: + +| Execution راستہ | سیکیورٹی کی حدود | +| ---------------- | ---------------------------- | +| مین ایجنٹ | `restrict_to_workspace` ✅ | +| Subagent / Spawn | ایک جیسی پابندی لیتا ہے ✅ | +| Heartbeat کام | ایک جیسی پابندی لیتا ہے ✅ | + +تمام راستے ایک جیسی workspace پابندی کا اشتراک کرتے ہیں — subagents یا شیڈول شدہ کاموں کے ذریعے سیکیورٹی کی حدود کو نقل کرنے کا کوئی طریقہ نہیں ہے۔ + +### Heartbeat (دورانیہ کام) + +PicoClaw خود بخود دورانیہ کام انجام دے سکتا ہے۔ اپنے workspace میں ایک `HEARTBEAT.md` فائل بنائیں: + +```markdown +# دورانیہ کام + +- اہم پیغاموں کے لیے میری ای میل چیک کریں +- آنے والے واقعات کے لیے میرے کیلنڈر کو دیکھیں +- موسم کی پیشن گوئی چیک کریں +``` + +ایجنٹ ہر 30 منٹ میں (ترتیب دینے کے قابل) اس فائل کو پڑھے گا اور دستیاب ٹولز کا استعمال کرتے ہوئے کسی بھی کام کو انجام دے گا۔ + +#### Spawn کے ساتھ Async کام + +طویل مدتی کاموں (ویب سرچ، API کالز) کے لیے، ایک **subagent** بنانے کے لیے `spawn` ٹول استعمال کریں: + +```markdown +# دورانیہ کام + +## تیز کام (براہ راست جواب دیں) + +- موجودہ وقت رپورٹ کریں + +## لمبے کام (async کے لیے spawn استعمال کریں) + +- AI خبروں کے لیے ویب سرچ کریں اور خلاصہ کریں +- ای میل چیک کریں اور اہم پیغاموں کی رپورٹ کریں +``` + +**اہم رویے:** + +| خصوصیت | تفصیل | +| ----------------------- | --------------------------------------------------------- | +| **spawn** | Async subagent بناتا ہے، heartbeat کو بلاک نہیں کرتا | +| **آزاد سیاق** | Subagent کا اپنا سیاق ہے، کوئی سیشن تاریخ نہیں | +| **پیغام ٹول** | Subagent پیغام ٹول کے ذریعے صارف کے ساتھ براہ راست رابطہ کرتا ہے | +| **غیر مسدود** | spawn کرنے کے بعد، heartbeat اگلے کام میں جاتا ہے | + +#### Subagent رابطے کی کارکردگی + +``` +Heartbeat ٹریگر + ↓ +ایجنٹ HEARTBEAT.md پڑھتا ہے + ↓ +طویل کام کے لیے: subagent spawn کریں + ↓ ↓ +اگلے کام پر جائیں Subagent آزادانہ طریقے سے کام کرتا ہے + ↓ ↓ +تمام کاموں کے بعد Subagent "message" ٹول استعمال کرتا ہے + ↓ ↓ +HEARTBEAT_OK کا جواب صارف براہ راست نتیجہ وصول کرتا ہے +``` + +Subagent کے پاس ٹولز (message، web_search، وغیرہ) تک رسائی ہے اور مین ایجنٹ سے گزرے بغیر صارف کے ساتھ آزادانہ طریقے سے رابطہ کر سکتا ہے۔ + +**ترتیب:** + +```json +{ + "heartbeat": { + "enabled": true, + "interval": 30 + } +} +``` + +| آپشن | ڈیفالٹ | تفصیل | +| ---------- | ------- | ---------------------------------- | +| `enabled` | `true` | Heartbeat کو فعال/غیر فعال کریں | +| `interval` | `30` | منٹوں میں چیک وقفہ (کم: 5) | + +**ماحول متغیرات:** + +* Heartbeat کو غیر فعال کرنے کے لیے `PICOCLAW_HEARTBEAT_ENABLED=false` +* وقفہ کو تبدیل کرنے کے لیے `PICOCLAW_HEARTBEAT_INTERVAL=60` + +### فراہم کنندگان + +> [!NOTE] +> Groq Whisper کے ذریعے مفت آواز کی نقل فراہم کرتا ہے۔ اگر ترتیب دی گئی ہو، تو Telegram کے آواز کے پیغامات خودکار طور پر نقل کیے جائیں گے۔ + +| فراہم کنندہ | مقصد | API کلید حاصل کریں | +| -------------------------- | --------------------------------------- | -------------------------------------------------------------------- | +| `gemini` | LLM (Gemini براہ راست) | [aistudio.google.com](https://aistudio.google.com) | +| `zhipu` | LLM (Zhipu براہ راست) | [bigmodel.cn](https://bigmodel.cn) | +| `openrouter(جانچ میں)` | LLM (سفارش کی گئی، تمام ماڈلز تک رسائی) | [openrouter.ai](https://openrouter.ai) | +| `anthropic(جانچ میں)` | LLM (Claude براہ راست) | [console.anthropic.com](https://console.anthropic.com) | +| `openai(جانچ میں)` | LLM (GPT براہ راست) | [platform.openai.com](https://platform.openai.com) | +| `deepseek(جانچ میں)` | LLM (DeepSeek براہ راست) | [platform.deepseek.com](https://platform.deepseek.com) | +| `qwen` | LLM (Qwen براہ راست) | [dashscope.console.aliyun.com](https://dashscope.console.aliyun.com) | +| `groq` | LLM + **آواز کی نقل** (Whisper) | [console.groq.com](https://console.groq.com) | +| `cerebras` | LLM (Cerebras براہ راست) | [cerebras.ai](https://cerebras.ai) | + +### ماڈل ترتیب (model_list) + +> **کیا نیا ہے؟** PicoClaw اب ایک **ماڈل مرکوز** ترتیب کا طریقہ استعمال کرتا ہے۔ صرف `vendor/model` فارمیٹ مخصوص کریں (مثال کے طور پر، `zhipu/glm-4.7`) نئے فراہم کنندگان کو شامل کرنے کے لیے — **صفر کوڈ تبدیلیاں درکار ہیں!** + +یہ ڈیزائن **ملٹی ایجنٹ سپورٹ** کو بھی فعال کرتا ہے لچکدار فراہم کنندہ کے انتخاب کے ساتھ: + +- **مختلف ایجنٹ، مختلف فراہم کنندگان**: ہر ایجنٹ اپنے LLM فراہم کنندہ کو استعمال کر سکتا ہے +- **ماڈل fallbacks**: مضبوطی کے لیے بنیادی اور fallback ماڈلز ترتیب دیں +- **بوجھ میں توازن**: ایک سے زیادہ endpoints میں درخواستوں کو تقسیم کریں +- **متحد ترتیب**: ایک جگہ میں تمام فراہم کنندگان کا انتظام کریں + +#### 📋 تمام سپورٹ شدہ فراہم کنندگان + +| فراہم کنندہ | `model` سابقہ | ڈیفالٹ API بنیاد | پروٹوکول | API کلید | +| ------------------- | ----------------- | --------------------------------------------------- | --------- | ---------------------------------------------------------------- | +| **OpenAI** | `openai/` | `https://api.openai.com/v1` | OpenAI | [کلید حاصل کریں](https://platform.openai.com) | +| **Anthropic** | `anthropic/` | `https://api.anthropic.com/v1` | Anthropic | [کلید حاصل کریں](https://console.anthropic.com) | +| **智谱 AI (GLM)** | `zhipu/` | `https://open.bigmodel.cn/api/paas/v4` | OpenAI | [کلید حاصل کریں](https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys) | +| **DeepSeek** | `deepseek/` | `https://api.deepseek.com/v1` | OpenAI | [کلید حاصل کریں](https://platform.deepseek.com) | +| **Google Gemini** | `gemini/` | `https://generativelanguage.googleapis.com/v1beta` | OpenAI | [کلید حاصل کریں](https://aistudio.google.com/api-keys) | +| **Groq** | `groq/` | `https://api.groq.com/openai/v1` | OpenAI | [کلید حاصل کریں](https://console.groq.com) | +| **Moonshot** | `moonshot/` | `https://api.moonshot.cn/v1` | OpenAI | [کلید حاصل کریں](https://platform.moonshot.cn) | +| **通义千问 (Qwen)** | `qwen/` | `https://dashscope.aliyuncs.com/compatible-mode/v1` | OpenAI | [کلید حاصل کریں](https://dashscope.console.aliyun.com) | +| **NVIDIA** | `nvidia/` | `https://integrate.api.nvidia.com/v1` | OpenAI | [کلید حاصل کریں](https://build.nvidia.com) | +| **Ollama** | `ollama/` | `http://localhost:11434/v1` | OpenAI | مقامی (کلید کی ضرورت نہیں) | +| **OpenRouter** | `openrouter/` | `https://openrouter.ai/api/v1` | OpenAI | [کلید حاصل کریں](https://openrouter.ai/keys) | +| **VLLM** | `vllm/` | `http://localhost:8000/v1` | OpenAI | مقامی | +| **Cerebras** | `cerebras/` | `https://api.cerebras.ai/v1` | OpenAI | [کلید حاصل کریں](https://cerebras.ai) | +| **火山引擎** | `volcengine/` | `https://ark.cn-beijing.volces.com/api/v3` | OpenAI | [کلید حاصل کریں](https://console.volcengine.com) | +| **神算云** | `shengsuanyun/` | `https://router.shengsuanyun.com/api/v1` | OpenAI | - | +| **Antigravity** | `antigravity/` | Google Cloud | Custom | صرف OAuth | +| **GitHub Copilot** | `github-copilot/` | `localhost:4321` | gRPC | - | + +#### بنیادی ترتیب + +```json +{ + "model_list": [ + { + "model_name": "gpt-5.2", + "model": "openai/gpt-5.2", + "api_key": "sk-your-openai-key" + }, + { + "model_name": "claude-sonnet-4.6", + "model": "anthropic/claude-sonnet-4.6", + "api_key": "sk-ant-your-key" + }, + { + "model_name": "glm-4.7", + "model": "zhipu/glm-4.7", + "api_key": "your-zhipu-key" + } + ], + "agents": { + "defaults": { + "model": "gpt-5.2" + } + } +} +``` + +#### فراہم کنندہ کی مخصوص مثالیں + +**OpenAI** + +```json +{ + "model_name": "gpt-5.2", + "model": "openai/gpt-5.2", + "api_key": "sk-..." +} +``` + +**智谱 AI (GLM)** + +```json +{ + "model_name": "glm-4.7", + "model": "zhipu/glm-4.7", + "api_key": "your-key" +} +``` + +**DeepSeek** + +```json +{ + "model_name": "deepseek-chat", + "model": "deepseek/deepseek-chat", + "api_key": "sk-..." +} +``` + +**Anthropic (API کلید کے ساتھ)** + +```json +{ + "model_name": "claude-sonnet-4.6", + "model": "anthropic/claude-sonnet-4.6", + "api_key": "sk-ant-your-key" +} +``` + +> اپنی API ٹوکن پیسٹ کرنے کے لیے `picoclaw auth login --provider anthropic` چلائیں۔ + +**Ollama (مقامی)** + +```json +{ + "model_name": "llama3", + "model": "ollama/llama3" +} +``` + +**کسٹم Proxy/API** + +```json +{ + "model_name": "my-custom-model", + "model": "openai/custom-model", + "api_base": "https://my-proxy.com/v1", + "api_key": "sk-...", + "request_timeout": 300 +} +``` + +#### بوجھ میں توازن + +ایک جیسے ماڈل نام کے لیے متعدد endpoints ترتیب دیں — PicoClaw خود بخود ان میں گول سفر کرے گا: + +```json +{ + "model_list": [ + { + "model_name": "gpt-5.2", + "model": "openai/gpt-5.2", + "api_base": "https://api1.example.com/v1", + "api_key": "sk-key1" + }, + { + "model_name": "gpt-5.2", + "model": "openai/gpt-5.2", + "api_base": "https://api2.example.com/v1", + "api_key": "sk-key2" + } + ] +} +``` + +#### میراث `providers` Config سے منتقلی + +پرانی `providers` ترتیب **براہ-رفتہ** ہے لیکن پیچھے سے مطابقت کے لیے ابھی بھی سپورٹ کی جاتی ہے۔ + +**پرانی ترتیب (براہ-رفتہ):** + +```json +{ + "providers": { + "zhipu": { + "api_key": "your-key", + "api_base": "https://open.bigmodel.cn/api/paas/v4" + } + }, + "agents": { + "defaults": { + "provider": "zhipu", + "model": "glm-4.7" + } + } +} +``` + +**نئی ترتیب (سفارش کی گئی):** + +```json +{ + "model_list": [ + { + "model_name": "glm-4.7", + "model": "zhipu/glm-4.7", + "api_key": "your-key" + } + ], + "agents": { + "defaults": { + "model": "glm-4.7" + } + } +} +``` + +تفصیلی منتقلی گائیڈ کے لیے، [docs/migration/model-list-migration.md](docs/migration/model-list-migration.md) دیکھیں۔ + +### فراہم کنندہ کی تعمیر + +PicoClaw پروٹوکول خاندان کے ذریعے فراہم کنندگان کو روٹ کرتا ہے: + +- OpenAI مطابقت پروٹوکول: OpenRouter، OpenAI مطابقت gateways، Groq، Zhipu، اور vLLM-سٹائل endpoints۔ +- Anthropic پروٹوکول: Claude-native API رویہ۔ +- Codex/OAuth راستہ: OpenAI OAuth/ٹوکن تصدیق راستہ۔ + +یہ runtime کو ہلکا رکھتا ہے جبکہ نئے OpenAI-مطابقت backends کو زیادہ تر ترتیب کے آپریشن (`api_base` + `api_key`) بناتا ہے۔ + +
+Zhipu + +**1. API کلید اور بنیاد URL حاصل کریں** + +* [API کلید](https://bigmodel.cn/usercenter/proj-mgmt/apikeys) حاصل کریں + +**2. ترتیب دیں** + +```json +{ + "agents": { + "defaults": { + "workspace": "~/.picoclaw/workspace", + "model": "glm-4.7", + "max_tokens": 8192, + "temperature": 0.7, + "max_tool_iterations": 20 + } + }, + "providers": { + "zhipu": { + "api_key": "Your API Key", + "api_base": "https://open.bigmodel.cn/api/paas/v4" + } + } +} +``` + +**3. چلائیں** + +```bash +picoclaw agent -m "السلام عليكم" +``` + +
+ +
+مکمل ترتیب کی مثال + +```json +{ + "agents": { + "defaults": { + "model": "anthropic/claude-opus-4-5" + } + }, + "providers": { + "openrouter": { + "api_key": "sk-or-v1-xxx" + }, + "groq": { + "api_key": "gsk_xxx" + } + }, + "channels": { + "telegram": { + "enabled": true, + "token": "123456:ABC...", + "allow_from": ["123456789"] + }, + "discord": { + "enabled": true, + "token": "", + "allow_from": [""] + }, + "whatsapp": { + "enabled": false + }, + "feishu": { + "enabled": false, + "app_id": "cli_xxx", + "app_secret": "xxx", + "encrypt_key": "", + "verification_token": "", + "allow_from": [] + }, + "qq": { + "enabled": false, + "app_id": "", + "app_secret": "", + "allow_from": [] + } + }, + "tools": { + "web": { + "brave": { + "enabled": false, + "api_key": "BSA...", + "max_results": 5 + }, + "duckduckgo": { + "enabled": true, + "max_results": 5 + } + }, + "cron": { + "exec_timeout_minutes": 5 + } + }, + "heartbeat": { + "enabled": true, + "interval": 30 + } +} +``` + +
+ +## CLI حوالہ + +| کمانڈ | تفصیل | +| ------------------------- | ----------------------------- | +| `picoclaw onboard` | ترتیب اور workspace شروع کریں | +| `picoclaw agent -m "..."` | ایجنٹ سے بات کریں | +| `picoclaw agent` | انٹرایکٹو چیٹ موڈ | +| `picoclaw gateway` | Gateway شروع کریں | +| `picoclaw status` | حالت دکھائیں | +| `picoclaw cron list` | تمام شیڈول شدہ کام درج کریں | +| `picoclaw cron add ...` | شیڈول شدہ کام شامل کریں | + +### شیڈول شدہ کام / یادیں + +PicoClaw `cron` ٹول کے ذریعے شیڈول شدہ یادیں اور دہرائے جانے والے کام کو سپورٹ کرتا ہے: + +* **ایک بار کی یادیں**: "مجھے 10 منٹ میں یاد دلائیں" → 10منٹ بعد ایک بار ٹریگر ہو +* **دہرائے جانے والے کام**: "مجھے ہر 2 گھنٹے میں یاد دلائیں" → ہر 2 گھنٹے میں ٹریگر ہو +* **Cron اظہار**: "مجھے روزانہ 9 بجے یاد دلائیں" → cron اظہار استعمال کرتا ہے + +کام `~/.picoclaw/workspace/cron/` میں محفوظ ہیں اور خود بخود پروسیس ہوتے ہیں۔ + +## 🤝 تعاون اور Roadmap + +PRs خوش آمدید! کوڈ بیس قصداً چھوٹا اور قابل فہم ہے۔ 🤗 + +ہمارا مکمل [کمیونٹی Roadmap](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md) دیکھیں۔ + +ڈویلپر گروپ تعمیر، اپنا پہلا PR ضم ہونے کے بعد شامل ہوں! + +صارف کے گروپس: + +discord: + +PicoClaw + +## 🐛 مسائل کا حل + +### ویب سرچ کہتا ہے "API کی ترتیب میں مسئلہ" + +یہ عام ہے اگر آپ نے ابھی سرچ API کلید ترتیب نہیں دی ہے۔ PicoClaw دستی تلاش کے لیے مفید لنکس فراہم کرے گا۔ + +ویب سرچ کو فعال کرنے کے لیے: + +1. **اپشن 1 (سفارش کی گئی)**: [https://brave.com/search/api](https://brave.com/search/api) پر مفت API کلید حاصل کریں (بہترین نتائج کے لیے ماہ میں 2000 مفت سوالات)۔ +2. **اپشن 2 (کریڈٹ کارڈ نہیں)**: اگر آپ کے پاس کوئی کلید نہیں ہے، تو ہم خود بخود **DuckDuckGo** (کوئی کلید درکار نہیں) میں واپس ہو جاتے ہیں۔ + +Brave استعمال کر رہے ہیں تو `~/.picoclaw/config.json` میں کلید شامل کریں: + +```json +{ + "tools": { + "web": { + "brave": { + "enabled": false, + "api_key": "YOUR_BRAVE_API_KEY", + "max_results": 5 + }, + "duckduckgo": { + "enabled": true, + "max_results": 5 + } + } + } +} +``` + +### مواد فلٹرنگ خرابیاں حاصل کریں + +کچھ فراہم کنندگان (جیسے Zhipu) میں مواد فلٹرنگ ہے۔ اپنی سوال کو دوبارہ بیان کرنے کی کوشش کریں یا ایک مختلف ماڈل استعمال کریں۔ + +### Telegram بوٹ کہتا ہے "تنازعہ: دوسرے getUpdates کے ذریعے ختم" + +یہ اس وقت ہوتا ہے جب بوٹ کی دوسری مثال چل رہی ہو۔ یقینی بنائیں کہ ایک بار میں صرف ایک `picoclaw gateway` چل رہا ہے۔ + +--- + +## 📝 API کی موازنہ + +| سروس | مفت سطح | استعمال کی صورت حال | +| ---------------- | ------------------- | ------------------------------------- | +| **OpenRouter** | 200K ٹوکنز/ماہ | متعدد ماڈلز (Claude، GPT-4، وغیرہ) | +| **Zhipu** | 200K ٹوکنز/ماہ | چینی صارفین کے لیے بہترین | +| **Brave Search** | 2000 سوالات/ماہ | ویب سرچ کی فعالیت | +| **Groq** | مفت سطح دستیاب | تیز اندراج (Llama، Mixtral) | +| **Cerebras** | مفت سطح دستیاب | تیز اندراج (Llama، Qwen، وغیرہ) | diff --git a/README.vi.md b/README.vi.md index 0dd4994c2..395691af9 100644 --- a/README.vi.md +++ b/README.vi.md @@ -14,7 +14,7 @@ Twitter

-[中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | **Tiếng Việt** | [Français](README.fr.md) | [English](README.md) +[中文](README.zh.md) | [日本語](README.ja.md) | [Português](README.pt-br.md) | **Tiếng Việt** | [Français](README.fr.md) | [Urdu](README.urdu.md) | [English](README.md) --- diff --git a/README.zh.md b/README.zh.md index 8ce1ad2ee..dc7741807 100644 --- a/README.zh.md +++ b/README.zh.md @@ -14,7 +14,7 @@ Twitter

-**中文** | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md) +**中文** | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [Urdu](README.urdu.md) | [English](README.md)