chore(sync): mirror docs from openclaw/openclaw@3312ce5acb

.openclaw-sync/source.json

@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "fd83c49cffc05af5f3722c2fb7df85a57cf4bcca",
-  "syncedAt": "2026-05-02T21:01:53.110Z"
+  "sha": "3312ce5acba9175e45d19b091c3d456ceea648f2",
+  "syncedAt": "2026-05-02T21:25:09.326Z"
 }

docs/ar/tools/skills.md

@@ -74,6 +74,7 @@ x-i18n:
     - عيّن `agents.list[].skills: []` لعدم إتاحة أي Skills.
     - قائمة `agents.list[].skills` غير الفارغة هي المجموعة **النهائية** لذلك الوكيل — ولا تُدمج مع الإعدادات الافتراضية.
     - تُطبق قائمة السماح الفعلية عبر بناء المطالبات، واكتشاف أوامر slash الخاصة بـ Skills، ومزامنة sandbox، ولقطات Skills.
+
   </Accordion>
 </AccordionGroup>
 

docs/de/tools/skills.md

@@ -74,6 +74,7 @@ Skill-**Speicherort** und Skill-**Sichtbarkeit** sind getrennte Steuerungen. Spe
     - Setzen Sie `agents.list[].skills: []`, um keine Skills zu erlauben.
     - Eine nicht leere `agents.list[].skills`-Liste ist die **abschließende** Menge für diesen Agenten — sie wird nicht mit den Standardwerten zusammengeführt.
     - Die effektive Allowlist gilt über Prompt-Erstellung, Skill-Slash-Command-Erkennung, Sandbox-Synchronisierung und Skill-Snapshots hinweg.
+
   </Accordion>
 </AccordionGroup>
 

docs/es/concepts/active-memory.md

@@ -670,6 +670,7 @@ Active Memory se apoya en la canalización de recuperación del Plugin de memori
     - Observa los registros del Gateway para detectar `active-memory: ... start|done`, `memory sync failed (search-bootstrap)` o errores de embeddings del proveedor.
     - Ejecuta `openclaw memory status --deep` para inspeccionar el backend de búsqueda de memoria y el estado del índice.
     - Si usas `ollama`, confirma que el modelo de embeddings esté instalado (`ollama list`).
+
   </Accordion>
 </AccordionGroup>
 

docs/es/tools/skills.md

@@ -74,6 +74,7 @@ La **ubicación** de la Skill y la **visibilidad** de la Skill son controles sep
     - Define `agents.list[].skills: []` para no permitir ninguna Skill.
     - Una lista no vacía `agents.list[].skills` es el conjunto **final** para ese agente; no se fusiona con los valores predeterminados.
     - La lista de permitidos efectiva se aplica a la construcción de prompts, el descubrimiento de comandos de barra de Skills, la sincronización del sandbox y las instantáneas de Skills.
+
   </Accordion>
 </AccordionGroup>
 

docs/fa/tools/skills.md

@@ -74,6 +74,7 @@ directory بومی `$CODEX_HOME/skills` در Codex CLI یکی از ریشه‌ه
     - برای نداشتن هیچ skill، `agents.list[].skills: []` را تنظیم کنید.
     - یک list غیرخالی `agents.list[].skills` مجموعه **نهایی** برای آن agent است — با defaults ادغام نمی‌شود.
     - allowlist موثر در سراسر ساخت prompt، کشف slash-command مربوط به skill، sync sandbox و snapshotهای skill اعمال می‌شود.
+
   </Accordion>
 </AccordionGroup>
 

docs/fr/tools/skills.md

@@ -74,6 +74,7 @@ L’**emplacement** des Skills et leur **visibilité** sont des contrôles disti
     - Définissez `agents.list[].skills: []` pour n’autoriser aucune Skill.
     - Une liste `agents.list[].skills` non vide est l’ensemble **final** pour cet agent — elle ne fusionne pas avec les valeurs par défaut.
     - La liste d’autorisation effective s’applique à la construction des prompts, à la découverte des slash commands de Skills, à la synchronisation de la sandbox et aux instantanés de Skills.
+
   </Accordion>
 </AccordionGroup>
 

docs/id/tools/skills.md

@@ -74,6 +74,7 @@ Nama yang sama di beberapa tempat → sumber tertinggi menang. Workspace mengala
     - Tetapkan `agents.list[].skills: []` agar tidak ada skill.
     - Daftar `agents.list[].skills` yang tidak kosong adalah set **final** untuk agen tersebut — tidak digabung dengan default.
     - Daftar izin efektif berlaku di seluruh pembuatan prompt, penemuan slash-command skill, sinkronisasi sandbox, dan snapshot skill.
+
   </Accordion>
 </AccordionGroup>
 

docs/it/tools/skills.md

@@ -74,6 +74,7 @@ La **posizione** della skill e la **visibilità** della skill sono controlli sep
     - Imposta `agents.list[].skills: []` per nessuna skill.
     - Un elenco non vuoto `agents.list[].skills` è l'insieme **finale** per quell'agente — non viene unito ai valori predefiniti.
     - L'allowlist effettiva si applica alla costruzione del prompt, alla scoperta dei comandi slash delle skill, alla sincronizzazione della sandbox e agli snapshot delle skill.
+
   </Accordion>
 </AccordionGroup>
 

docs/ja-JP/tools/skills.md

@@ -88,6 +88,7 @@ Codex CLI のネイティブな `$CODEX_HOME/skills` ディレクトリは、こ
     - スキルなしにするには、`agents.list[].skills: []` を設定します。
     - 空でない `agents.list[].skills` リストは、そのエージェントの**最終的な**セットです。デフォルトとはマージされません。
     - 有効な許可リストは、プロンプト構築、スキル slash-command 検出、サンドボックス同期、スキルスナップショット全体に適用されます。
+
   </Accordion>
 </AccordionGroup>
 

docs/ko/providers/xai.md

@@ -412,6 +412,7 @@ OpenClaw는 미디어 생성, 음성, 배치 전사에는 xAI의 REST 이미지/
     - `grok-4.20-multi-agent-experimental-beta-0304`는 표준 OpenClaw xAI 전송과 다른 업스트림 API 표면이 필요하므로 일반 xAI Provider 경로에서 지원되지 않습니다.
     - xAI Realtime 음성은 아직 OpenClaw Provider로 등록되지 않았습니다. 배치 STT 또는 스트리밍 전사와는 다른 양방향 음성 세션 계약이 필요합니다.
     - xAI 이미지 `quality`, 이미지 `mask`, 추가 네이티브 전용 종횡비는 공유 `image_generate` 도구에 해당하는 Provider 간 제어가 추가될 때까지 노출되지 않습니다.
+
   </Accordion>
 
   <Accordion title="고급 참고 사항">
@@ -422,6 +423,7 @@ OpenClaw는 미디어 생성, 음성, 배치 전사에는 xAI의 REST 이미지/
     - Grok `web_search`는 `plugins.entries.xai.config.webSearch.baseUrl`을 읽습니다. `x_search`는 `plugins.entries.xai.config.xSearch.baseUrl`을 읽은 다음, Grok 웹 검색 기본 URL로 대체합니다.
     - `x_search`와 `code_execution`은 핵심 모델 런타임에 하드코딩된 것이 아니라 번들 xAI Plugin이 소유합니다.
     - `code_execution`은 원격 xAI 샌드박스 실행이며, 로컬 [`exec`](/ko/tools/exec)가 아닙니다.
+
   </Accordion>
 </AccordionGroup>
 

docs/ko/tools/skills.md

@@ -74,6 +74,7 @@ Codex CLI의 기본 `$CODEX_HOME/skills` 디렉터리는 이러한 OpenClaw 스
     - 스킬을 사용하지 않으려면 `agents.list[].skills: []`로 설정하세요.
     - 비어 있지 않은 `agents.list[].skills` 목록은 해당 에이전트의 **최종** 집합입니다. defaults와 병합되지 않습니다.
     - 유효 허용 목록은 프롬프트 빌드, 스킬 슬래시 명령 검색, 샌드박스 동기화, 스킬 스냅샷 전반에 적용됩니다.
+
   </Accordion>
 </AccordionGroup>
 

docs/pt-BR/concepts/active-memory.md

@@ -670,6 +670,7 @@ Active Memory opera sobre o pipeline de recuperação do Plugin de memória conf
     - Monitore os logs do Gateway para `active-memory: ... start|done`, `memory sync failed (search-bootstrap)` ou erros de embeddings do provedor.
     - Execute `openclaw memory status --deep` para inspecionar o backend de busca de memória e a integridade do índice.
     - Se você usa `ollama`, confirme que o modelo de embeddings está instalado (`ollama list`).
+
   </Accordion>
 </AccordionGroup>
 

docs/pt-BR/tools/skills.md

@@ -74,6 +74,7 @@ A **localização** da Skill e a **visibilidade** da Skill são controles separa
     - Defina `agents.list[].skills: []` para nenhuma Skill.
     - Uma lista `agents.list[].skills` não vazia é o conjunto **final** para esse agente — ela não é mesclada com os padrões.
     - A lista de permissões efetiva se aplica à construção de prompts, descoberta de comandos slash de Skills, sincronização de sandbox e snapshots de Skills.
+
   </Accordion>
 </AccordionGroup>
 

docs/reference/rich-output-protocol.md

@@ -17,6 +17,10 @@ Remote `MEDIA:` attachments must be public `https:` URLs. Plain `http:`,
 loopback, link-local, private, and internal hostnames are ignored as attachment
 directives; server-side media fetchers still enforce their own network guards.
 
+Local `MEDIA:` attachments can use absolute paths, workspace-relative paths, or
+home-relative `~/` paths. They still pass through the agent file-read policy and
+media type checks before delivery.
+
 Plain Markdown image syntax stays text by default. Channels that intentionally
 map Markdown image replies to media attachments opt in at their outbound
 adapter; Telegram does this so `![alt](url)` can still become a media reply.

docs/start/openclaw.md

@@ -203,6 +203,7 @@ Local-path behavior follows the same file-read trust model as the agent:
 
 - If `tools.fs.workspaceOnly` is `true`, outbound `MEDIA:` local paths stay restricted to the OpenClaw temp root, the media cache, agent workspace paths, and sandbox-generated files.
 - If `tools.fs.workspaceOnly` is `false`, outbound `MEDIA:` can use host-local files the agent is already allowed to read.
+- Local paths can be absolute, workspace-relative, or home-relative with `~/`.
 - Host-local sends still only allow media and safe document types (images, audio, video, PDF, and Office documents). Plain text and secret-like files are not treated as sendable media.
 
 That means generated images/files outside the workspace can now send when your fs policy already allows those reads, without reopening arbitrary host-text attachment exfiltration.

docs/th/tools/skills.md

@@ -74,6 +74,7 @@ OpenClaw โหลด Skills จากแหล่งเหล่านี้
     - ตั้ง `agents.list[].skills: []` เพื่อไม่ให้มี Skills
     - รายการ `agents.list[].skills` ที่ไม่ว่างคือชุด **สุดท้าย** สำหรับ agent นั้น โดยจะไม่รวมกับค่าเริ่มต้น
     - allowlist ที่มีผลบังคับใช้จะถูกใช้กับการสร้าง prompt, การค้นหา slash-command ของ skill, การ sync sandbox และ snapshots ของ skill
+
   </Accordion>
 </AccordionGroup>
 

docs/tr/tools/skills.md

@@ -91,6 +91,7 @@ belirler.
     - Beceri olmaması için `agents.list[].skills: []` ayarlayın.
     - Boş olmayan bir `agents.list[].skills` listesi, o ajan için **nihai** kümedir — varsayılanlarla birleştirilmez.
     - Etkin izin listesi istem oluşturma, beceri slash-komutu keşfi, sandbox eşitlemesi ve beceri anlık görüntüleri genelinde uygulanır.
+
   </Accordion>
 </AccordionGroup>
 

docs/zh-TW/providers/xai.md

@@ -420,6 +420,7 @@ OpenClaw 使用 xAI 的 REST 影像/影片/TTS/STT API 進行媒體生成、
     - 一般 xAI 供應器路徑不支援 `grok-4.20-multi-agent-experimental-beta-0304`，因為它需要與標準 OpenClaw xAI 傳輸不同的上游 API 介面。
     - xAI Realtime 語音尚未註冊為 OpenClaw 供應器。它需要與批次 STT 或串流轉錄不同的雙向語音工作階段合約。
     - xAI 圖片 `quality`、圖片 `mask`，以及額外僅限原生的長寬比，在共用 `image_generate` 工具具備對應的跨供應器控制之前，不會公開。
+
   </Accordion>
 
   <Accordion title="進階備註">

docs/zh-TW/tools/skills.md

@@ -74,6 +74,7 @@ Codex CLI 的原生 `$CODEX_HOME/skills` 目錄不是這些 OpenClaw 技能根
     - 設定 `agents.list[].skills: []` 表示沒有技能。
     - 非空的 `agents.list[].skills` 清單是該代理的**最終**集合，不會與預設值合併。
     - 有效的允許清單會套用於提示建構、技能斜線命令探索、sandbox 同步，以及技能快照。
+
   </Accordion>
 </AccordionGroup>