Package Exports

clawd-proxy
clawd-proxy/bin/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (clawd-proxy) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Clawd Proxy

English | 中文

English

A lightweight LLM API proxy server with web console. API keys and models are configured on the server side - clients only need an access token.

Features

Server-side API Key storage - Real API keys are stored on the proxy server, not exposed to clients
Simplified client config - Clients only need to specify provider name (e.g., openrouter), no need for full model path
Access Token authentication - Clients use a simple access token instead of real API keys
Provider switching commands - /proxy/providers and /proxy/provider/<name> endpoints
Per-provider default models - Each provider can have a default model configured
SSL/HTTPS support - Upload certificates or specify local paths
Bilingual Web UI - English and Chinese interface

Installation

# Install globally
npm install -g clawd-proxy

# Start server
clawd-proxy

Client Configuration (Clawdbot)

{
  "models": {
    "providers": {
      "vps": {
        "baseUrl": "http://YOUR_VPS_IP:1180/v1",
        "apiKey": "your-access-token",
        "api": "openai-completions",
        "models": [
          { "id": "openrouter", "name": "openrouter" }
        ]
      }
    }
  },
  "agents": {
    "model": {
      "primary": "vps/openrouter"
    }
  }
}

That's it! The real API key and default model are configured in the proxy's web console.

Command Endpoints

Endpoint	Description
`GET /proxy/providers`	List all available providers
`GET /proxy/provider/<name>`	Switch to a provider
`GET /proxy/status`	Current status with details
`GET /health`	Health check

Web Console

Access at http://YOUR_IP:1180

Features:

Configure API keys for each provider (stored server-side)
Set default models for each provider
Enable/disable providers
Set access token for client authentication
View request logs
Add custom providers
SSL/HTTPS configuration
Change server port

中文

轻量级 LLM API 代理服务器，带 Web 控制台。API Key 和模型在服务端配置，客户端只需访问令牌。

特性

服务端存储 API Key - 真实的 API Key 保存在代理服务器，不暴露给客户端
简化客户端配置 - 客户端只需指定 provider 名称（如 openrouter），无需完整 model 路径
Access Token 认证 - 客户端使用简单的访问令牌代替真实 API Key
Provider 切换命令 - /proxy/providers 和 /proxy/provider/<name> 接口
Provider 默认模型 - 每个 provider 可以配置默认使用的模型
SSL/HTTPS 支持 - 上传证书或指定本地路径
中英文双语界面

安装

# 全局安装
npm install -g clawd-proxy

# 启动服务器
clawd-proxy

客户端配置 (Clawdbot)

{
  "models": {
    "providers": {
      "vps": {
        "baseUrl": "http://你的VPS_IP:1180/v1",
        "apiKey": "你的访问令牌",
        "api": "openai-completions",
        "models": [
          { "id": "openrouter", "name": "openrouter" }
        ]
      }
    }
  },
  "agents": {
    "model": {
      "primary": "vps/openrouter"
    }
  }
}

就这么简单！真实的 API Key 和默认模型在代理服务器的 Web 控制台配置。

命令接口

端点	说明
`GET /proxy/providers`	列出所有可用的 providers
`GET /proxy/provider/<name>`	切换到指定 provider
`GET /proxy/status`	当前状态详情
`GET /health`	健康检查

Web 控制台

访问 http://你的IP:1180

功能：

为每个 provider 配置 API Key（服务端存储）
为每个 provider 设置默认模型
启用/禁用 providers
设置客户端访问令牌
查看请求日志
添加自定义 providers
SSL/HTTPS 配置
修改服务器端口

License

MIT