smart_ide/services/claw-harness-api/README.md

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
• GitHub (often used for clone): 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 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)

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).

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.