Nicolas Cantu
088eab84b7
- Add ia_dev submodule (projects/smart_ide on forge 4nk) - Document APIs, orchestrator, gateway, local-office, rollout - Add systemd/scripts layout; relocate setup scripts - Remove obsolete nginx/enso-only docs from this repo scope
49 lines
2.2 KiB
Markdown
49 lines
2.2 KiB
Markdown
# 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.
|