# Send Agent Wal 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": "agent-wal",
    "name": "Agent Wal",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/bowen31337/agent-wal",
    "canonicalUrl": "https://clawhub.ai/bowen31337/agent-wal",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agent-wal",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-wal",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/wal.py",
      "skill.toml"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "agent-wal",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T13:50:14.551Z",
      "expiresAt": "2026-05-06T13:50:14.551Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-wal",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-wal",
        "contentDisposition": "attachment; filename=\"agent-wal-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agent-wal"
      },
      "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/agent-wal"
    },
    "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/agent-wal",
    "downloadUrl": "https://openagent3.xyz/downloads/agent-wal",
    "agentUrl": "https://openagent3.xyz/skills/agent-wal/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agent-wal/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agent-wal/agent.md"
  }
}
```
## Documentation

### Agent WAL (Write-Ahead Log)

Write important state to disk before responding. Prevents the #1 agent failure mode: losing corrections and context during compaction.

### Core Rule

Write before you respond. If something is worth remembering, WAL it first.

### When to WAL

TriggerAction TypeExampleUser corrects youcorrection"No, use Podman not Docker"You make a key decisiondecision"Using CogVideoX-2B for text-to-video"Important analysis/conclusionanalysis"WAL/VFM patterns should be core infra not skills"State changestate_change"GPU server SSH key auth configured"User says "remember this"correctionWhatever they said

### Commands

All commands via scripts/wal.py (relative to this skill directory):

# Write before responding
python3 scripts/wal.py append agent1 correction "Use Podman not Docker for all EvoClaw tooling"
python3 scripts/wal.py append agent1 decision "CogVideoX-5B with multi-GPU via accelerate"
python3 scripts/wal.py append agent1 analysis "Signed constraints prevent genome tampering"

# Working buffer (batch writes during conversation, flush before compaction)
python3 scripts/wal.py buffer-add agent1 decision "Some decision"
python3 scripts/wal.py flush-buffer agent1

# Session start: replay lost context
python3 scripts/wal.py replay agent1

# After applying a replayed entry
python3 scripts/wal.py mark-applied agent1 <entry_id>

# Maintenance
python3 scripts/wal.py status agent1
python3 scripts/wal.py prune agent1 --keep 50

### On Session Start

Run replay to get unapplied entries
Read the summary into your context
Mark entries as applied after incorporating them

### On User Correction

Run append with action_type correction BEFORE responding
Then respond with the corrected behavior

### On Pre-Compaction Flush

Run flush-buffer to persist any buffered entries
Then write to daily memory files as usual

### During Conversation

For less critical items, use buffer-add to batch writes. Buffer is flushed to WAL on flush-buffer (called during pre-compaction) or manually.

### Storage

WAL files: ~/clawd/memory/wal/<agent_id>.wal.jsonl
Buffer files: ~/clawd/memory/wal/<agent_id>.buffer.jsonl

Entries are append-only JSONL. Each entry:

{"id": "abc123", "timestamp": "ISO8601", "agent_id": "agent1", "action_type": "correction", "payload": "Use Podman not Docker", "applied": false}
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: bowen31337
- Version: 1.0.1
## 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-04-29T13:50:14.551Z
- Expires at: 2026-05-06T13:50:14.551Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agent-wal)
- [Send to Agent page](https://openagent3.xyz/skills/agent-wal/agent)
- [JSON manifest](https://openagent3.xyz/skills/agent-wal/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agent-wal/agent.md)
- [Download page](https://openagent3.xyz/downloads/agent-wal)