tinman

Files (5)

• origin.json · .clawhub/
• SKILL.md
• _meta.json
• requirements.txt
• tinman_runner.py

SKILL.md (first lines)

---
name: tinman
version: 0.6.3
description: AI security scanner with active prevention - 168 detection patterns, 288 attack probes, safer/risky/yolo modes, agent self-protection via /tinman check, local Oilcan event streaming, and plain-language dashboard setup via /tinman oilcan
author: oliveskin
repository: https://github.com/oliveskin/openclaw-skill-tinman
license: Apache-2.0

requires:
  python: ">=3.10"
  binaries:
    - python3
  env: []

install:
  pip:
    - AgentTinman>=0.2.1
    - tinman-openclaw-eval>=0.3.2

permissions:
  tools:
    allow:
      - sessions_list
      - sessions_history
      - read
      - write
    deny: []
  sandbox: compatible
  elevated: false
---

# Tinman - AI Failure Mode Research

Tinman is a forward-deployed research agent that discovers unknown failure modes in AI systems through systematic experimentation.


## Security and Trust Notes

- This skill intentionally declares `install.pip` and session/file permissions because scanning requires local analysis of session traces and report output.
- The default watch gateway is loopback-only (`ws://127.0.0.1:18789`) to reduce accidental data exposure.
- Remote gateways require explicit opt-in with `--allow-remote-gateway` and should only be used for trusted internal endpoints.
- Event streaming is local (`~/.openclaw/workspace/tinman-events.jsonl`) and best-effort; values are truncated and obvious secret patterns are redacted.
- Oilcan bridge should stay loopback by default; only allow LAN access when explicitly needed.

## What It Does

- **Checks** tool calls before execution for security risks (agent self-protection)
- **Scans** recent sessions for prompt injection, tool misuse, context bleed
- **Classifies** failures by severity (S0-S4) and type
- **Proposes** mitigations mapped to OpenClaw controls (SOUL.md, sandbox policy, tool allow/deny)
- **Reports** findings in actionable format
- **Streams** structured local events to `~/.openclaw/workspace/tinman-events.jsonl` (for local dashboards like Oilcan)
- **Guides** local Oilcan setup with plain-language status via `/tinman oilcan`

## Commands

### `/tinman init`

Initialize Tinman workspace with default configuration.

```
/tinman init                    # Creates ~/.openclaw/workspace/tinman.yaml
```

Run this first time to set up the workspace.

### `/tinman check` (Agent Self-Protection)

Check if a tool call is safe before execution. **This enables agents to self-police.**

```
/tinman check bash "cat ~/.ssh/id_rsa"    # Returns: BLOCKED (S4)
/tinman check bash "ls -la"               # Returns: SAFE
/tinman check bash "curl https://api.com" # Returns: REVIEW (S2)
/tinman check read ".env"                 # Returns: BLOCKED (S4)
```

**Verdicts:**
- `SAFE` - Proceed automatically
- `REVIEW` - Ask human for approval (in `safer` mode)
- `BLOCKED` - Refuse the action

**Add to SOUL.md for autonomous protection:**
```markdown
Before executing bash, read, or write tools, run:
  /tinman check <tool> <args>
If BLOCKED: refuse and explain why
If REVIEW: ask user for approval
If SAFE: proceed
```

### `/tinman mode`

Set or view security mode for the check system.

```
/tinman mode                    # Show current mode
/tinman mode safer              # Default: ask human for REVIEW, block BLOCKED
/tinman mode risky              # Auto-approve REVIEW, still block S3-S4
/tinman mode yolo               # Warn only, never block (testing/research)
```

| Mode | SAFE | REVIEW (S1-S2) | BLOCKED (S3-S4) |
|------|------|----------------|-----------------|
| `safer` | Proceed | Ask human | Block |
| `risky` | Proceed | Auto-approve | Block |
| `yolo` | Proceed | Auto-approve | Warn only |

### `/tinman allow`

Add patterns to the allowlist (bypass security checks for trusted items).

```
/tinman allow api.trusted.com --type domains    # Allow specific domain
/tinman allow "npm install" --type patterns     # Allow pattern
/tinman allow curl --type tools                 # Allow tool entirely
```

### `/tinman allowlist`

From dfpalhano/openclaw-workspace, Apache-2.0.

More from dfpalhano/openclaw-workspace