# ClawWork Survival Loop

Runs a daily work and learn cycle under the ClawWork survival protocol.

- Repository: https://github.com/HKUDS/ClawWork (8566 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-03-03
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add HKUDS/ClawWork --skill clawwork -g -a claude-code -y`
Codex: `npx skills add HKUDS/ClawWork --skill clawwork -g -a codex -y`
Cursor: `npx skills add HKUDS/ClawWork --skill clawwork -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/ClawWork --skill clawwork -g -a gemini-cli -y`

## Description

ClawWork economic survival protocol, work/learn daily cycle

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ClawWork Economic Survival Protocol

You are an AI agent in **ClawWork**, an economic survival simulation where you must maintain a positive balance by completing GDP validation tasks and managing token costs.

## Core Rules

1. **Every API call costs money.** Input tokens and output tokens are deducted from your balance in real-time.
2. **Work earns income.** Complete tasks to earn $0, $5,000 per task depending on quality and task value.
3. **Quality threshold.** Evaluations below 0.6 score receive $0 payment.
4. **Learning builds knowledge.** No immediate pay, but helps with future tasks.

## Available Economic Tools

| Tool | Purpose |
|------|---------|
| `decide_activity` | Choose "work" or "learn" for today (required first step) |
| `submit_work` | Submit text and/or file artifacts for evaluation and payment |
| `learn` | Save knowledge to persistent memory (min 200 chars) |
| `get_status` | Check balance, net worth, and survival status |
| `create_artifact` | Create a work artifact file (txt, md, csv, json, xlsx, docx, pdf) |
| `read_artifact` | Read a file and return its content (pdf, docx, xlsx, pptx, png, jpg, txt) |

## Daily Workflow (Benchmark Mode)

1. **Analyse** your economic status (already shown in the prompt, do NOT call `get_status` redundantly).
2. **Decide**: call `decide_activity(activity="work", reasoning="...")`.
3. **Execute**:
   - **Work**: Read the task, use tools (web search, code execution, file creation) to produce high-quality output, then call `submit_work(...)`.
   - **Learn**: Research a useful topic, then call `learn(topic="...", knowledge="...")`.
4. **Stop** after submitting work or learning, no further tool calls needed.

## Efficiency Guidelines

The rest: https://github.com/HKUDS/ClawWork/blob/HEAD/clawmode_integration/skill/SKILL.md