openclaw/clawrouter

최근 기록된 소스 활동: 2026년 9월 19일 01:22

SkillsMP 카탈로그 업데이트: 2026년 11월 5일 19:57

수집된 skills: 1

GitHub 스타: 37
GitHub 포크: 10

AI 어시스턴트로 설치

이 프롬프트를 복사해 사용 중인 AI 어시스턴트에 입력하세요.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/openclaw/clawrouter.

저장소 README

README 원본 파일: README.md

README 원본 보기

README 전체 펼치기

# ClawRouter 🦞 — One key, many upstreams. [![CI](https://img.shields.io/github/actions/workflow/status/openclaw/clawrouter/ci.yml?branch=main&style=flat-square&label=ci)](https://github.com/openclaw/clawrouter/actions/workflows/ci.yml) [![GitHub release](https://img.shields.io/github/v/release/openclaw/clawrouter?style=flat-square)](https://github.com/openclaw/clawrouter/releases/latest) [![Node.js](https://img.shields.io/badge/node-%3E%3D24-339933?style=flat-square&logo=nodedotjs)](https://nodejs.org/) [![License](https://img.shields.io/github/license/openclaw/clawrouter?style=flat-square)](LICENSE) ClawRouter is a provider-neutral API gateway for OpenClaw deployments. It routes policy-scoped credentials across model and tool providers while enforcing access, revocation, budgets, request retention, and metered usage. ## Install ClawRouter is distributed from source. Local development requires Node.js 24 or newer and the pnpm version declared in `package.json`. ```sh git clone https://github.com/openclaw/clawrouter.git cd clawrouter corepack enable pnpm install --frozen-lockfile ``` For a complete service without a Cloudflare account, use the [Docker self-hosting profile](docs/self-hosting.md). It requires Docker with Compose and OpenSSL. ## Quick start Run the local end-to-end Worker smoke: ```sh pnpm worker:e2e ``` The smoke starts a local Worker and fixture upstream, exercises discovery, authentication, routing, budgets, failover, retention, usage, and admin paths, then removes its temporary state. ## Routing Clients authenticate with one policy-scoped `clawrouter-` credential. The selected policy controls which providers and models are visible, how upstream grants are chosen, what budget applies, and whether request content is retained. | Surface | Path | | --- | --- | | OpenAI-compatible chat, responses, decisions, and embeddings | `/v1/chat/completions`, `/v1/responses`, `/v1/decisions`, `/v1/embeddings` | | Anthropic messages | `/v1/messages`, `/v1/messages/count_tokens` | | Manifest-defined APIs | `/v1/proxy/<provider>/<endpoint>` | | Provider-native APIs | `/v1/native/<provider>/<provider-native-path>` | | Credential-scoped discovery | `/v1/models`, `/v1/catalog` | | Usage and key status | `/v1/usage`, `/v1/key/inspect` | Models use provider-qualified IDs such as `openai/gpt-4.1-mini`. `GET /v1/catalog` reports only the providers, models, and transports the caller can execute. See the [API reference](docs/api-reference.md) for the complete route inventory and authentication boundaries. For Codex, use the [native catalog export and provider setup](docs/codex.md), including Fast tier accounting, qualified Responses WebSockets, and desktop account boundaries. The opt-in [private alias facade](docs/private-codex.md) is a separate, Responses-only contract for an isolated owner-only runtime, not a model in the shared catalog or per-user protection for a shared Gateway. It requires separately provisioned secret-store bindings and has no generic billing or retention. ## Provider catalog For OpenAI, use a Platform API key. Subscription browser Connect is unavailable in the bundled provider; see [OpenAI setup and subscription limits](docs/openai-subscriptions.md) for the supported path and the private facade's separate requirements. Provider support starts with one manifest: ```text providers/<service>.provider.yaml ``` The compiler validates auth schemes, routes, request and response formats, capabilities, models, pricing, and billing meters, then emits the snapshot shared by the Worker and admin console. Add a focused TypeScript adapter only when a manifest cannot express the provider safely. See [Service providers](providers/README.md) for the schema and mapping rules. Amazon Bedrock uses native SigV4-signed `InvokeModel` routes rather than OpenAI normalization; its IAM and request contract are documented separately in [Amazon Bedrock](docs/aws-bedrock.md). The optional `clawrouter/fusion` model combines several adviser calls with one synthesizer through the normal policy and accounting path; see [Fusion routing](docs/fusion-router.md). ## Policy and accounting Revocation-critical policy and credential state lives in serialized Durable Object authority. Budget reservations happen before upstream work, successful responses settle to actual metered cost, and failed settlement or audit delivery retries independently without hiding the provider response. Usage ledgers retain bounded request metadata, not prompts or completions. Policies can enable request-content retention in a separate R2 archive. The [architecture](docs/architecture.md), [content-retention contract](docs/content-retention.md), and [agent spend-control guide](docs/agent-spend-control.md) describe those boundaries. ## Deployment | Target | Guide | | --- | --- | | Docker and local workerd persistence | [Self-hosting](docs/self-hosting.md) | | Cloudflare Workers, Durable Objects, KV, queues, R2, and Access | [Deploy on Cloudflare](docs/deploy-cloudflare.md) | | OpenClaw client configuration and quota checks | [Use with OpenClaw](docs/openclaw.md) | | Isolated non-production Cloudflare profile | [FakeCo staging](docs/fakeco.md) | The Docker profile exposes port 8787 on host loopback and persists Durable Objects, KV, and R2 under a named volume. The Cloudflare profile adds distributed queues, managed storage, and an Access-protected browser console. ## Development ```sh pnpm build pnpm check ``` `pnpm build` compiles the provider snapshot and admin UI, then typechecks the Worker. `pnpm check` runs Worker, admin, and script tests. Numbered GitHub source releases use the [release workflow](RELEASING.md), independently of service deployments. ## License MIT. See [LICENSE](LICENSE). OpenAI [image generation](docs/openai-images.md) is available through the standard Images API, native and manifest proxy routes with modality-specific accounting.

저장소 README를 불러오는 중…

이 저장소의 skills

소프트웨어 품질 보증 분석가·테스터

직업 카테고리 1개 · 100% 분류됨

skill

직업 분류

설명

업데이트

autoreview

소프트웨어 품질 보증 분석가·테스터

Structured Codex, Claude, Amp, Pi, or Kimi code review when explicitly requested.

원문 언어: 영어

2026-09-19

수집된 skill 1개 중 1개를 표시합니다.