# Send Zettelclaw to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zettelclaw",
    "name": "Zettelclaw",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/maxpetretta/zettelclaw",
    "canonicalUrl": "https://clawhub.ai/maxpetretta/zettelclaw",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/zettelclaw",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zettelclaw",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "package.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "zettelclaw",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T12:10:23.646Z",
      "expiresAt": "2026-05-18T12:10:23.646Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zettelclaw",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zettelclaw",
        "contentDisposition": "attachment; filename=\"zettelclaw-2026.3.11.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "zettelclaw"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/zettelclaw"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zettelclaw",
    "downloadUrl": "https://openagent3.xyz/downloads/zettelclaw",
    "agentUrl": "https://openagent3.xyz/skills/zettelclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zettelclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zettelclaw/agent.md"
  }
}
```
## Documentation

### Zettelclaw

Follow the canonical Zettelclaw vault model: capture externally, write durable notes manually, and use the agent for navigation/synthesis.

This is an instruction-only skill. It does not install software by itself. qmd is optional when it is already available in the environment, and rg is the supported fallback for search.

### Vault structure

<vault>/
├── 00 Inbox/
├── 01 Notes/
├── 02 Journal/
├── 03 Templates/
├── 04 Attachments/
└── README.md

### Note types

Use YAML frontmatter on every note:

Required on all notes:

type
tags
created


Required on doc and content notes:

status (queued | in-progress | done | archived)


Optional content metadata:

author
source

Use these primary types:

note: durable atomic thinking note; no status
doc: non-atomic working/reference note; uses status
journal: daily log note; no status
content types: article, book, movie, tv, youtube, tweet, podcast, paper (and extensible additional content types); uses status

### Templates

Always read the matching template in 03 Templates/ before creating a note:

note.md
journal.md
clipper-capture.json

Use core templates/date syntax. Do not require Templater.

### Inbox workflow

Web captures land in 00 Inbox/ via clipper-capture.json.
Clipper sets type by URL (tweet, youtube, else article) and status: queued.
Process inbox captures by keeping/moving, converting into a type: note, or deleting.
Do not auto-write durable thinking notes from captured content unless explicitly asked.

### Bases workflow

00 Inbox/inbox.base is the canonical queue view.
Grouping is by note.type for scan-by-content-type triage.
Prefer creating/editing .base files over Dataview.

### Titles as APIs

A note's title is its interface. Use complete, declarative phrases: "Spaced Repetition Works Because of Retrieval," not "Spaced Repetition." A well-titled note can be linked and understood without opening it. When creating or renaming notes, always prefer a full declarative statement.

### Tag conventions

Tags live in the frontmatter tags array, not inline in the body.

Lowercase, hyphenated: spaced-repetition, not Spaced Repetition or spacedRepetition.
Topic-oriented, not structural: learning (what it's about), not important (how you feel about it).
Nest only when a hierarchy is genuinely useful: ai/transformers is fine, deep nesting is not.
Suggest tags based on the vault's existing taxonomy rather than inventing new ones.

### Editing rules

Preserve existing prose unless user asks to rewrite.
Do not add or maintain an updated frontmatter field.
Use dense wikilinking ([[Note Title]]) and allow unresolved links as stubs.
Do not create top-level folders unless explicitly requested.
Do not assign/change status, move notes, or delete notes without explicit instruction.
Agent write surface is limited to:

/ask response callouts
optional daily briefing callout in journals

### Search patterns

Default QMD collections:

zettelclaw-inbox
zettelclaw-notes
zettelclaw-journal
zettelclaw-attachments

# qmd (preferred when installed)
qmd query "spaced repetition and retrieval" -c zettelclaw-notes
qmd search "status: queued" -c zettelclaw-inbox
qmd vsearch "what have I been learning about memory" -c zettelclaw-notes

# ripgrep fallback
rg -l 'type: note' "01 Notes/"
rg -l 'type: article' "00 Inbox/" "01 Notes/"
rg -l 'status: queued' "00 Inbox/" "01 Notes/"

### OpenClaw integration

If configuring OpenClaw memory paths, use:

agents.defaults.memorySearch.extraPaths

Do not write legacy top-level memorySearch.
Only change OpenClaw config when the operator explicitly wants this vault wired into an OpenClaw installation.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: maxpetretta
- Version: 2026.3.11
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-11T12:10:23.646Z
- Expires at: 2026-05-18T12:10:23.646Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/zettelclaw)
- [Send to Agent page](https://openagent3.xyz/skills/zettelclaw/agent)
- [JSON manifest](https://openagent3.xyz/skills/zettelclaw/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/zettelclaw/agent.md)
- [Download page](https://openagent3.xyz/downloads/zettelclaw)