openclaw-agent-compute

# openclaw-agent-compute

Public, agent-friendly skill that exposes `compute.*` tools by calling a **private** Compute Gateway over **HTTPS**.

## Environment

- `MCP_COMPUTE_URL` (e.g. `https://compute.example.com`)
- `MCP_COMPUTE_API_KEY`

Copy `skills/openclaw-agent-compute/.env.example`.

## Tools / API expectation

This client expects the private gateway to implement:
- `POST /v1/sessions` (create)
- `GET /v1/sessions/{session_id}` (get status)
- `POST /v1/exec` (run command)
- `GET /v1/usage/{session_id}` (usage/cost)
- Artifacts:
  - `GET /v1/artifacts/{session_id}` (list)
  - `PUT /v1/artifacts/{session_id}/{path}` (upload bytes; `{path}` must be URL-encoded and may include slashes)
  - `GET /v1/artifacts/{session_id}/{path}` (download bytes; `{path}` must be URL-encoded)
  - `DELETE /v1/artifacts/{session_id}/{path}` (delete; `{path}` must be URL-encoded)
- `DELETE /v1/sessions/{session_id}` (destroy)

## Scripts

- HTTP client: `skills/openclaw-agent-compute/scripts/client.js`
- Example: `skills/openclaw-agent-compute/scripts/example_exec.js`

### Local smoke test

```bash
cp skills/openclaw-agent-compute/.env.example .env
# edit .env
npm i
npm run example:exec
```

## Starter kit

See `skills/openclaw-agent-compute/starter-kit/`.

It keeps the OpenClaw image overrideable via `OPENCLAW_IMAGE` until an official image/tag is confirmed.

## Publishing

- Checklist: `PUBLISHING.md`
- Runbook (local publish + GitHub Actions tag-based publish): `CLAWDHUB_RUNBOOK.md`

# openclaw-agent-compute

Public Clawdbot/OpenClaw skill that exposes `compute.*` tools by calling a **private** Compute Gateway over **HTTPS**.

## Install

### Option A — ClawdHub

```bash
clawdhub install openclaw-agent-compute
```

### Option B — from GitHub (dev)

```bash
git clone https://github.com/aleksandrkrivolap/openclaw-agent-compute-skill
cd openclaw-agent-compute-skill
npm i
```

## Configuration

Copy the example env file and set:

- `MCP_COMPUTE_URL` — base URL of your Compute Gateway (e.g. `https://compute.example.com`)
- `MCP_COMPUTE_API_KEY` — Bearer token

```bash
cp .env.example .env
# edit .env
```

## Smoke test

From this folder:

```bash
npm i
npm run lint
npm run example:exec
```

## Artifacts (planned)

The private gateway contract also includes artifact upload/download/list endpoints. The client exports helper functions:

- `computeArtifactsList({ session_id })`
- `computeArtifactPut({ session_id, path, bytes })`
- `computeArtifactGet({ session_id, path })`
- `computeArtifactDelete({ session_id, path })`

## Repository

https://github.com/aleksandrkrivolap/openclaw-agent-compute-skill