# claw-harness-api

Integration notes and a **thin local proxy** for the **claw-code** harness (multi-model agent runtime). Upstream sources:

- Mirror listing: [gitlawb — claw-code](https://gitlawb.com/node/repos/z6Mks1jg/claw-code)
- GitHub (often used for clone): [instructkr/claw-code](https://github.com/instructkr/claw-code)

This folder does **not** vendor claw-code. Clone upstream next to this repo or under a path you control, then build and run according to upstream `README.md` (Rust workspace under `rust/` with `cargo build --release`, and/or Python `src/` tooling depending on branch).

## Policy: no Anthropic in templates

The file [`providers.example.yaml`](./providers.example.yaml) lists **Ollama** and optional OpenAI-compatible / Gemini-style placeholders. **Anthropic is set to `enabled: false`.** Operational enforcement (firewall, absent `ANTHROPIC_API_KEY`, etc.) remains your responsibility on the host.

## Upstream build (summary)

```bash
git clone https://github.com/instructkr/claw-code.git
cd claw-code/rust
cargo build --release
```

Exact binaries, subcommands, and HTTP server flags depend on the cloned revision; read upstream `README.md` and `rust/crates/*/README` if present.

## Local proxy (`proxy/`)

To align with other smart_ide services (Bearer token, fixed bind address), a small Node proxy can forward HTTP to the upstream claw HTTP server.

| Variable | Required | Description |
|----------|----------|-------------|
| `CLAW_PROXY_TOKEN` | yes | `Authorization: Bearer <token>` on client calls to the proxy. |
| `CLAW_PROXY_HOST` | no | Bind address (default `127.0.0.1`). |
| `CLAW_PROXY_PORT` | no | Proxy listen port (default `37142`). |
| `CLAW_UPSTREAM_URL` | yes | Base URL of the claw HTTP server (e.g. `http://127.0.0.1:37143`). |

```bash
cd proxy
npm install
npm run build
export CLAW_PROXY_TOKEN='…'
export CLAW_UPSTREAM_URL='http://127.0.0.1:37143'
npm start
```

The proxy forwards method, path, query, and body; it does not modify Anthropic or other provider traffic beyond what the upstream server already does.

## License

Files in this directory (README, YAML example, proxy) are MIT unless noted. claw-code is a third-party project with its own license.