feat(openai-gateway): init openai-gateway service

Author: jiacai2050

README.org

@@ -1,6 +1,6 @@
 #+TITLE: MyWorks
 #+DATE: 2025-04-16T10:11:50+0800
-#+LASTMOD: 2026-01-04T11:28:40+0800
+#+LASTMOD: 2026-02-24T15:17:44+0800
 #+AUTHOR: Jiacai Liu
 
 This monorepo contains all public software projects I've developed and released to the community.
@@ -10,6 +10,9 @@ Each project is maintained within a structured architecture that enables efficie
 * Zig
 - [[file:zms/][zms]] :: A pure Zig solution to set up a mirror server for fetching Zig tarballs on demand and caching them on the local disk.
 - [[file:zigos/][zigos]] :: Zig 写 OS 的中文教程
+* Go
+- [[file:openai-gateway/][openai-gateway]] :: 一个用 Go 编写的极简 OpenAI API 透明代理（代码 40 行），支持自动注入 API Key，解决 API Key 泄露风险。
+
 * Rust
 - [[file:rust-ffi/][rust-ffi]] :: Demo project show how to interop C with Rust.
 * JS

openai-gateway/.gitignore

@@ -0,0 +1 @@
+gateway

openai-gateway/Makefile

@@ -0,0 +1,6 @@
+
+
+build:
+	go build -o gateway main.go
+
+.PHONY: build

openai-gateway/README.md

@@ -0,0 +1,68 @@
+# OpenAI Gateway
+
+一个用 Go 编写的极简 OpenAI API 透明代理（代码 40 行），支持自动注入 API Key，解决 API Key 泄露风险。
+
+> 配合[龙虾](https://openclaw.ai/)🦞食用最佳。
+
+## 核心特性
+
+- **身份认证**: 为所有请求自动注入 `Authorization: Bearer <OPENAI_API_KEY>`。
+- **透明转发**: 保持请求路径完整并拼接到 `OPENAI_BASE_URL` 之后。
+- **流式支持**: 完美透传 OpenAI 的 Streaming 响应。
+
+## 工作流
+
+```mermaid
+graph LR
+    C1["客户端请求: Path"] --> G1
+    subgraph Gateway ["OpenAI Gateway (本地代理)"]
+        G1["注入 API Key"]
+        G2["Path 拼接: BaseURL + Path"]
+        G1 --> G2
+    end
+    G2 --> O1["上游: OPENAI_BASE_URL + Path"]
+```
+
+## 快速开始
+
+### 1. 运行
+```bash
+# 必须：设置你的真实 OpenAI API Key
+export OPENAI_API_KEY="sk-..."
+
+# 可选：修改上游地址，默认 https://api.openai.com/v1
+# export OPENAI_BASE_URL="https://api.openai.com/v1"
+
+go run main.go
+```
+
+### 2. 客户端配置
+
+#### OpenAI Python SDK
+网关已自动注入真实 API Key，你在客户端只需将 `base_url` 指向本地网关，并传入一个任意值的 `api_key` 即可。
+
+```python
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="http://localhost:8080",
+    api_key="local-proxy"
+)
+
+response = client.chat.completions.create(
+    model="gpt-3.5-turbo",
+    messages=[{"role": "user", "content": "Hello via Gateway!"}]
+)
+print(response.choices[0].message.content)
+```
+
+#### Curl 测试
+```bash
+# 请求 /chat/completions，转发至 {OPENAI_BASE_URL}/chat/completions
+curl http://localhost:8080/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{"model": "gpt-3.5-turbo", "messages": [{"role": "user", "content": "Hi!"}]}'
+
+# 请求 /models，转发至 {OPENAI_BASE_URL}/models
+curl http://localhost:8080/models
+```

openai-gateway/go.mod

@@ -0,0 +1,3 @@
+module openai-gateway
+
+go 1.24.3

openai-gateway/main.go

@@ -0,0 +1,41 @@
+package main
+
+import (
+	"log"
+	"net/http"
+	"net/http/httputil"
+	"net/url"
+	"os"
+	"strings"
+)
+
+func main() {
+	apiKey := os.Getenv("OPENAI_API_KEY")
+	baseUrl := os.Getenv("OPENAI_BASE_URL")
+	if baseUrl == "" {
+		baseUrl = "https://api.openai.com/v1"
+	}
+
+	upstream, _ := url.Parse(baseUrl)
+	basePath := strings.TrimSuffix(upstream.Path, "/")
+
+	proxy := &httputil.ReverseProxy{
+		Director: func(req *http.Request) {
+			req.Header.Set("Authorization", "Bearer "+apiKey)
+			req.URL.Scheme = upstream.Scheme
+			req.URL.Host = upstream.Host
+			req.Host = upstream.Host
+			req.URL.Path = basePath + req.URL.Path
+
+			log.Printf("[%s] %s", req.Method, req.URL.String())
+		},
+	}
+
+	port := os.Getenv("PORT")
+	if port == "" {
+		port = "8080"
+	}
+
+	log.Printf("Gateway started on :%s -> %s", port, baseUrl)
+	log.Fatal(http.ListenAndServe(":"+port, proxy))
+}