openclaw/clawrouter

最近记录的来源活动: 2026年9月19日 01:22

SkillsMP 收录数据更新: 2026年11月9日 14:22

已收集 skills: 1

GitHub 星标: 37
GitHub Forks: 10

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 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

已展示 1 / 1 个已收集 Skill。