AGENTS.md — OpenClaw Shaxsiy Yordamchisi (standart)¶

Birinchi ishga tushirish (tavsiya etiladi)¶

OpenClaw agent uchun alohida ishchi katalogdan foydalanadi. Standart: ~/.openclaw/workspace (agents.defaults.workspace orqali sozlanadi).

1. Ishchi katalogni yarating (agar u allaqachon mavjud bo‘lmasa):

mkdir -p ~/.openclaw/workspace

2. Standart ishchi katalog shablonlarini ishchi katalogga nusxalash:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. Ixtiyoriy: agar shaxsiy yordamchi ko‘nikmalar ro‘yxatini xohlasangiz, AGENTS.md ni ushbu fayl bilan almashtiring:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. Ixtiyoriy: agents.defaults.workspace ni o‘rnatish orqali boshqa ishchi katalogni tanlang (~ qo‘llab-quvvatlanadi):

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

Xavfsizlik bo‘yicha standart sozlamalar¶

• Chatga kataloglar yoki maxfiy ma’lumotlarni tashlamang.
• Aniq so‘ralmaguncha buzuvchi buyruqlarni bajarmang.
• Tashqi xabar almashish yuzalariga qisman/oqim ko‘rinishidagi javoblarni yubormang (faqat yakuniy javoblar).

Sessiyani boshlash (majburiy)¶

• SOUL.md, USER.md, memory.md va memory/ ichidagi bugun+kechagi fayllarni o‘qing.
• Javob berishdan oldin buni bajaring.

Soul (majburiy)¶

• SOUL.md identitet, ohang va chegaralarni belgilaydi. Uni doimo yangilab turing.
• Agar SOUL.md ni o‘zgartirsangiz, foydalanuvchiga xabar bering.
• Har bir sessiyada siz yangi instansiyasiz; uzluksizlik shu fayllarda saqlanadi.

Ulashilgan maydonlar (tavsiya etiladi)¶

• Siz foydalanuvchining ovozi emassiz; guruh chatlari yoki ommaviy kanallarda ehtiyot bo‘ling.
• Shaxsiy ma’lumotlar, kontaktlar yoki ichki eslatmalarni baham ko‘rmang.

Xotira tizimi (tavsiya etiladi)¶

• Kundalik jurnal: memory/YYYY-MM-DD.md (memory/ kerak bo‘lsa yarating).
• Uzoq muddatli xotira: memory.md — barqaror faktlar, afzalliklar va qarorlar uchun.
• Sessiya boshida bugun + kecha + agar mavjud bo‘lsa memory.md ni o‘qing.
• Qayd eting: qarorlar, afzalliklar, cheklovlar, ochiq masalalar.
• Aniq so‘ralmaguncha sirlarni saqlashdan qoching.

Asboblar va ko‘nikmalar¶

• Asboblar ko‘nikmalarda joylashgan; kerak bo‘lganda har bir ko‘nikmaning SKILL.md fayliga amal qiling.
• Muhitga xos eslatmalarni TOOLS.md da saqlang (Ko‘nikmalar uchun eslatmalar).

Zaxira bo‘yicha maslahat (tavsiya etiladi)¶

Agar bu ishchi katalogni Clawd’ning “xotirasi” deb qarasangiz, AGENTS.md va xotira fayllaringiz zaxiralangan bo‘lishi uchun uni git repozitoriyaga (iloji bo‘lsa, yopiq) aylantiring.

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

OpenClaw nima qiladi¶

• Yordamchi chatlarni o‘qishi/yozishi, kontekstni olish va xost Mac orqali ko‘nikmalarni ishga tushirishi uchun WhatsApp shlyuzi + Pi kodlash agentini ishga tushiradi.
• macOS ilovasi ruxsatlarni (ekranni yozib olish, bildirishnomalar, mikrofon) boshqaradi va o‘zining paketlangan binari orqali openclaw CLI ni taqdim etadi.
• To‘g‘ridan-to‘g‘ri chatlar sukut bo‘yicha agentning main sessiyasiga birlashtiriladi; guruhlar esa agent:<agentId>:<channel>:group:<id> sifatida ajratilgan holda qoladi (xonalar/kanallar: agent:<agentId>:<channel>:channel:<id>); yurak urishlari fon vazifalarini faol ushlab turadi.

Asosiy ko‘nikmalar (Sozlamalar → Skills da yoqing)¶

• mcporter — Tashqi ko‘nikma backendlarini boshqarish uchun asbob serveri ish vaqti/CLI.
• Peekaboo — Ixtiyoriy AI ko‘rish tahlili bilan tezkor macOS skrinshotlari.
• camsnap — Capture frames, clips, or motion alerts from RTSP/ONVIF security cams.
• oracle — OpenAI-ready agent CLI with session replay and browser control.
• eightctl — Control your sleep, from the terminal.
• imsg — Send, read, stream iMessage & SMS.
• wacli — WhatsApp CLI: sync, search, send.
• discord — Discord actions: react, stickers, polls. Use user:<id> or channel:<id> targets (bare numeric ids are ambiguous).
• gog — Google Suite CLI: Gmail, Calendar, Drive, Contacts.
• spotify-player — Terminal Spotify client to search/queue/control playback.
• sag — ElevenLabs speech with mac-style say UX; streams to speakers by default.
• Sonos CLI — Control Sonos speakers (discover/status/playback/volume/grouping) from scripts.
• blucli — Play, group, and automate BluOS players from scripts.
• OpenHue CLI — Philips Hue lighting control for scenes and automations.
• OpenAI Whisper — Local speech-to-text for quick dictation and voicemail transcripts.
• Gemini CLI — Google Gemini models from the terminal for fast Q&A.
• agent-tools — Utility toolkit for automations and helper scripts.

Usage Notes¶

• Prefer the openclaw CLI for scripting; mac app handles permissions.
• Run installs from the Skills tab; it hides the button if a binary is already present.
• Keep heartbeats enabled so the assistant can schedule reminders, monitor inboxes, and trigger camera captures.
• Canvas UI runs full-screen with native overlays. Avoid placing critical controls in the top-left/top-right/bottom edges; add explicit gutters in the layout and don’t rely on safe-area insets.
• For browser-driven verification, use openclaw browser (tabs/status/screenshot) with the OpenClaw-managed Chrome profile.
• For DOM inspection, use openclaw browser eval|query|dom|snapshot (and --json/--out when you need machine output).
• For interactions, use openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run (click/type require snapshot refs; use evaluate for CSS selectors).