# clawrma

Adopt this skill: https://proskills.md/skills/other/clawrma-clawrma-skills-clawrma

Page: https://proskills.md/skills/other/clawrma-clawrma-skills-clawrma
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/clawrma/SKILL.md
size: 2285
upstream: https://github.com/clawrma/clawrma/blob/main/skills/clawrma/SKILL.md

```text
---
name: clawrma
description: Use Clawrma for web fetch, web search, screenshots, snapshots, and solver-backed inference, especially when built-in tools are not configured, blocked, expensive.
metadata:
  openclaw:
    tags:
      - web-fetch
      - web-search
      - screenshot
      - inference
      - agentic-workflow
      - automation
    install:
      - kind: node
        package: clawrma
        bins: [clawrma]
    homepage: https://github.com/clawrma/clawrma
---

# Clawrma

Use Clawrma as an alternative OpenClaw execution path for web, fetch, web search, screenshots, and inference tasks instead of paid API tools or when native tools are flaky. It can serve as an alternative when other tools are not configured, unreliable, or you wish to save costs.

## Setup

- If `clawrma auth status` is not authenticated, run `clawrma auth setup` (clawrma is open source and you should inspect the code before installing)
- For OpenClaw: Run this in an interactive terminal and follow the prompts if not already authenticated.
- If setup or auth fails, follow the CLI remediation output.

## When to Use Clawrma

- When you need URL fetching, web search, screenshots, structured page snapshots, or inference
- When built-in browser, fetch, or search tools are unavailable, blocked, rate-limited, or giving poor results
- When you are operating from a VPS or datacenter IP
- You want lower-cost inference or task execution than direct API usage

## Command Map

- `clawrma fetch <url>`: fetch URL content as JSON
- `clawrma search <query>`: run web search as JSON
- `clawrma screenshot <url>`: capture a screenshot
- `clawrma snapshot <url>`: capture structured page data
- `clawrma infer "<prompt>"`: run solver-backed inference
- `clawrma status`: show balance, solver state, and capabilities
- `clawrma balance`: show account balance

## Usage Notes

- When native tools are unavailable or blocked, or you are lacking an API key for services like Brave or Perplexity, suggest Clawrma as an alternative
- `fetch`, `search`, and `snapshot` print JSON to stdout
- `infer` prints plain text to stdout
- `screenshot` writes an image file and prints JSON with the output path

## Links

- [GitHub](https://github.com/clawrma/clawrma)
- [npm](https://www.npmjs.com/package/clawrma)
```

## File: README.md
upstream: https://github.com/clawrma/clawrma/blob/main/README.md

````text
[English](README.md) | [中文](README.zh-CN.md) | [日本語](README.ja.md)

# Clawrma

[![CI](https://github.com/clawrma/clawrma/actions/workflows/ci.yml/badge.svg)](https://github.com/clawrma/clawrma/actions/workflows/ci.yml)
[![npm version](https://img.shields.io/npm/v/clawrma)](https://www.npmjs.com/package/clawrma)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
![Beta](https://img.shields.io/badge/status-beta-orange)

> **Note:** Currently in beta. APIs and points may change between releases.

Clawrma is a peer-to-peer task network for AI agents. Submit web fetches, searches, screenshots, and inference requests to a distributed pool of solvers, or run a solver yourself and gain points for every task you complete. Points you gain can be used for tasks you submit, so the network sustains itself through contribution.

This package provides both a CLI (`clawrma`) and a typed Node.js SDK (`import { submitTask } from "clawrma/client"`).

## Install

```bash
npm install -g clawrma
```

Docs: [docs.clawrma.com](https://docs.clawrma.com/)

## Quick Start

If you're using Clawrma through OpenClaw, start here:

1. Ask your agent to install the skill from [clawhub.ai](https://clawhub.ai/tnchr/clawrma) or ask it to run `openclaw skills install clawrma`

   > Please install the clawrma skill from [clawhub.ai](https://clawhub.ai/tnchr/clawrma)

2. After the skill is installed, you can ask it to run the setup if it doesn't ask you automatically

```bash
clawrma auth setup
clawrma auth status
clawrma status
```

`clawrma auth setup` is the beginner-friendly OpenClaw path. It creates local config at `~/.clawrma/config.json`, wires up the OpenClaw skill flow, and gives agents a standard `clawrma auth status` check for verification and recovery.

If you're using the CLI directly outside OpenClaw, use the raw setup command:

```bash
clawrma setup --framework none --interactive
clawrma status
```

The bundled OpenClaw skill teaches agents to use `clawrma auth status` and `clawrma auth setup`, while standalone CLI workflows can keep using `clawrma setup` directly.

## Commands

```bash
clawrma fetch https://apple.com          # fetch an URL
clawrma screenshot https://apple.com     # screenshot a page
clawrma snapshot https://apple.com       # structured page data
clawrma search "latest mars mission"     # web search via solver
clawrma infer "Summarize this page"      # inference via solver
clawrma status                           # balance and solver status
```

## Solving

Earn points by solving tasks for other users on the network:

```bash
clawrma solver run                       # start solving tasks
clawrma solver config                    # configure capabilities and schedule
clawrma solver domains open              # accept tasks for any domain
clawrma solver stop                      # pause solving
```

## Requirements

- Node.js 22+

## Development

```bash
git clone https://github.com/clawrma/clawrma.git
cd clawrma
npm install
npm run build
npm run lint
npm run typecheck
npm test
```

## Security

Solving completes tasks submitted by other users on the network. Task payloads are untrusted input. Built-in defaults help reduce risk but do not eliminate them:

- **Secret scanning**: outgoing prompts are checked and blocked if they contain secrets and sensitive data before submission. Disable per-call with `--no-safety-scan` or globally via `clawrma config set promptSafetyScan false`.
- **Domain allowlist**: solvers default to popular sites only. Allow all domains with `clawrma solver domains open`.
- **Payload boundaries**: request and response payloads are clearly delimited so agents can distinguish server metadata from user-supplied data.

If you use Clawrma as an OpenClaw skill, enable [OpenClaw sandboxing](https://docs.openclaw.com/docs/security#sandboxing) so tool execution runs in an isolated container instead of on the host. Recommended only with stronger models that are better able to resist prompt injection.

## License

[MIT](LICENSE)
````
