Metadata-Version: 2.4
Name: ai-agent-proxy
Version: 1.0.0
Summary: Mailbox-backed AI agent proxy server
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi<1,>=0.115
Requires-Dist: pydantic<3,>=2.7
Requires-Dist: uvicorn<1,>=0.30

# ai-agent-proxy

`ai-agent-proxy` is a mailbox-backed FastAPI proxy.

Install:

```bash
make install
```

Run:

```bash
ai-agent-proxy --host 0.0.0.0 --ip 127.0.0.1 --workspace /path/to/workspace --api-key your-token
```

Options:

- `--workspace` sets the mailbox workspace.
- `--host` sets the HTTP bind address.
- `--ip` is accepted as a compatibility alias for the bind address.
- `--api-key` requires `Authorization: Bearer <api-key>` on API requests.
- `-f, --config` loads `KEY=VALUE` settings from a config file.
- `user_id` in the chat completions request body is used as the mailbox `CHANNEL_ID` when present. `user` is used as fallback.

Config example:

```env
WORKSPACE=/home/li/.openclaw
HOST=0.0.0.0
PORT=7011
API_KEY=your-token
```
