OpenClaw дээр шинэ чадвар нэмэх: AgentSkills гарын авлага

🏷️ OpenClaw AgentSkills Ubuntu Claude Code 📅 2026-05-18 · dell-server (Ubuntu 24.04 LTS) · OpenClaw v2026.4.21

Үндсэн зарчим

OpenClaw нь Claude Code-д суурилсан бөгөөд AgentSkills системийг ашигладаг. Шинэ чадвар нэмнэ гэдэг нь шинэ skill файл үүсгэнэ гэсэн үг:

/usr/lib/node_modules/openclaw/skills/<name>/SKILL.md

💡 AGENTS.md-д харин зөвхөн skill-үүдийн нэрсийг жагсаалтаар бичнэ. Тухайн tool-ын дэлгэрэнгүй команд бичих шаардлагагүй — тэр нь SKILL.md-д байна.

Яагаад AgentSkills вэ?

Шинж чанар AgentSkills AGENTS.md дотор Token зарцуулалт ✅ Бага (lazy load) ❌ Их (бүгд) Скайл ✅ Хязгааргүй ⚠️ 10+ tool хүнд Version control ✅ Тусдаа git ⚠️ Холимог Олон агент хуваалцах ✅ Амархан ❌ Хэцүү Anthropic албан ёсны ✅ Тийм ❌ Үгүй

Файлын бүтэц

/usr/lib/node_modules/openclaw/skills/   ← Бүх чадвар энд (ГОЛ ГАЗАР)
├── erp-phonelist/SKILL.md
├── zimbra-email/SKILL.md
├── zimbra-user-management/SKILL.md
└── ad-user-management/SKILL.md

/opt/openclaw/
├── .env                    ← Credential
└── tools/                  ← Бүх script
    ├── erp_phonelist.py
    ├── zimbra_send.sh
    ├── zimbra_create_user.sh
    └── ad_create_user.sh

~/.openclaw/workspace/
├── AGENTS.md               ← Skill нэрийг жагсаасан
├── SOUL.md                 ← Хувийн шинж
└── memory/

/home/rdn/.openclaw/agents/main/sessions/
└── sessions.json           ← Cache (skill нэмэхэд УСТГАХ)

Шинэ чадвар нэмэх 6 алхам

# Үйлдэл Зорилго Заавал 1 /opt/openclaw/tools/*.sh эсвэл .py Үндсэн логик ✅ 2 /opt/openclaw/.env Credential ⚡ шаардлагатай бол 3 skills/<name>/SKILL.md Skill үүсгэх ✅ 4 ~/.openclaw/workspace/AGENTS.md Skill нэр жагсаалт ✅ 5 rm sessions.json + restart Cache reset ✅ 6 Telegram шинэ чат Туршилт ✅

Алхам 1 — Script үүсгэх

sudo nano /opt/openclaw/tools/my_tool.sh
sudo chmod +x /opt/openclaw/tools/my_tool.sh

# Гараар туршилт
bash /opt/openclaw/tools/my_tool.sh "тест"

Shell script-ийн үндсэн загвар (.sh):

#!/bin/bash
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SCRIPT_DIR/../.env"

PARAM1=$1
PARAM2=$2

# Үндсэн логик
echo "Амжилттай: $PARAM1"

Алхам 2 — .env-д Credential нэмэх

Шаардлагатай тохиолдолд л нэмнэ:

sudo tee -a /opt/openclaw/.env << 'EOF'
MY_SERVICE_USER="хэрэглэгч"
MY_SERVICE_PASS="нууц_үг"
EOF

Алхам 3 — SKILL.md үүсгэх (хамгийн чухал)

sudo mkdir -p /usr/lib/node_modules/openclaw/skills/my-skill
sudo tee /usr/lib/node_modules/openclaw/skills/my-skill/SKILL.md > /dev/null << 'EOF'
---
name: my-skill
description: One sentence what it does. Use when user asks for X, Y, Z.
  Examples - "phrase 1", "phrase 2". This is for [scope] only,
  NOT for [adjacent].
---

# My Skill

When the user asks for X, run:
/opt/openclaw/tools/my_tool.sh "<param>"

## Examples
/opt/openclaw/tools/my_tool.sh "example1"

## Rules
- ALWAYS get confirmation BEFORE destructive action
- NEVER suggest alternative methods
- Use only /opt/openclaw/tools/my_tool.sh
- Report actual errors
EOF

SKILL.md бичих зөвлөмж

⚠️ Frontmatter-д зөвхөн name болон description гэсэн 2 талбар л байх ёстой. metadata, homepage нэмбэл parse алдаа гарч skill ачаалагдахгүй болно.

Description бичих загвар:

[Юу хийдэг]. Use when user asks for [сценари].
Examples - "[жишээ 1]", "[жишээ 2]".
This is for [хамрах хүрээ] only, NOT for [төстэй өөр зүйл].

Алхам 4 — AGENTS.md-д skill жагсаалт нэмэх

AGENTS.md файлын ## Tools хэсэгт нэг мөр нэмнэ:

- `my-skill` — Brief one-line description

💡 Дэлгэрэнгүй команд бичих шаардлагагүй — тэр нь SKILL.md-д байна. Энэ нь ERP-г 2 удаа алдаа гаргасны гол шалтгаан байсан.

Алхам 5 — Session cache reset (заавал)

⚠️ systemctl restart хангалтгүй! Session-д available skills-ийн snapshot cache хийгддэг. sessions.json файлыг заавал устгах шаардлагатай.

systemctl --user stop openclaw-gateway

cp /home/rdn/.openclaw/agents/main/sessions/sessions.json \
   /home/rdn/.openclaw/agents/main/sessions/sessions.json.bak

rm /home/rdn/.openclaw/agents/main/sessions/sessions.json

systemctl --user start openclaw-gateway
systemctl --user status openclaw-gateway

Алхам 6 — Telegram-д шинэ чат туршилт

⚠️ Заавал шинэ чат нээнэ. Хуучин чат хуучин skill snapshot ашиглах тул шинэ skill харагдахгүй байж болно.

Skill-ийн description-д бичсэн жишээ хэллэгүүдийг туршиж үзнэ.

Алдааг засах

🐛 Agent шинэ skill танихгүй байна

# 1. Skill үүсгэгдсэн эсэх
ls /usr/lib/node_modules/openclaw/skills/my-skill/SKILL.md

# 2. Frontmatter цэвэр эсэх
head -5 /usr/lib/node_modules/openclaw/skills/my-skill/SKILL.md

# 3. Skill snapshot-д орсон эсэх
grep "my-skill" /home/rdn/.openclaw/agents/main/sessions/sessions.json

Хариу 0 бол Алхам 5-г дахин ажиллуул.

🐛 SKILL.md YAML алдаа

Зөвхөн 2 талбартай байх: name, description. metadata, homepage нэмбэл parse алдаа гарна.

🐛 Playwright Кирилл алдаа

JS код дотор Кирилл байвал SyntaxError гарна. JS-г ASCII-аар бичиж, утгыг parameter-ээр дамжуулна:

js = "(query) => { /* ASCII only */ }"
results = page.evaluate(js, query_value)

🐛 npm ажиллахгүй (интернэт хязгаарлагдмал)

sudo apt install python3-pip -y
pip3 install playwright --break-system-packages
python3 -m playwright install chromium --with-deps

Туршлагаас сурсан 4 чухал зүйл

OpenClaw system_prompt.txt-г уншдаггүй. Тэр файл OpenClaw-н өөрийн файл биш — бид нэмж бичсэн. Тиймээс тэнд бичсэн зүйл ажиллахгүй.
TOOLS.md автоматаар уншигддаггүй. ERP-г 2 удаа алдаа гаргасан гол шалтгаан энэ байсан. AgentSkills-с өмнөх арга нь хоёр удаа хуурсан.
Session-д snapshot хийгддэг. sessions.json устгахгүй бол шинэ skill харагдахгүй. restart хангалтгүй — файлыг заавал устгах хэрэгтэй.
AgentSkills нь scalable. AGENTS.md-д бүх tool бичих нь 4–5 tool болоход хүнд болж эхэлдэг. AgentSkills-д шилжсэнээр энэ асуудал шийдэгдсэн.

Хувилбаруудын хооронд

Хувилбар Арга Үнэлгээ v1 system_prompt.txt ❌ Алдаа: файл уншигддаггүй v2 TOOLS.md ❌ Алдаа: автоматаар уншигддаггүй v3 AGENTS.md дотор бүх tool ⚠️ Ажилладаг ч скайл хийгдэхгүй v4 AgentSkills ✅ Зөв, Anthropic албан ёсны

✅ v4 Final — Zimbra, Active Directory, ERP-г AgentSkills болгож амжилттай шилжүүлсэн.

OpenClaw v2026.4.21 · dell-server (Ubuntu 24.04 LTS) · Шинэчилсэн: 2026-05-18