Zipsa
Zipsa is a local-first privacy gateway that sits between OpenClaw and cloud LLMs. It ensures that raw private context never leaves the local environment while still allowing the use of powerful frontier models for reasoning.
When to Use
Trigger this skill whenever the user provides or asks to process:
- - PII: Names, SSNs, DOBs, contact info.
- Healthcare Data: Patient records, clinical notes, symptoms.
- Internal Business Context: Pricing floors, negotiation terms, churn warnings, project codenames.
- Secrets: API keys, credentials, internal system details.
Core Workflow
Zipsa operates as an OpenAI-compatible gateway (default: http://localhost:8000/v1).
1. Identify Sensitive Context
When the user's request contains sensitive data, explain that Zipsa will be used to protect their privacy.
2. Route Through Zipsa
Instead of calling the standard cloud providers directly, use the Zipsa endpoint. Zipsa will:
- - Scan locally for high-risk markers.
- Classify the query (Private, Hybrid, or Knowledge).
- Reformulate (rewrite) the query to abstract identity and proprietary details.
- Route the safe version to the cloud.
- Synthesize the final answer back with the local details.
Integration Examples
Using with OpenClaw
OpenClaw can be configured to use Zipsa as its backend:
- - INLINECODE1
- INLINECODE2
- INLINECODE3
Multi-turn Sessions
For conversation continuity, always pass a
session_id.
CODEBLOCK0
Reference
For detailed configuration and advanced examples, see
references/README.md.
Zipsa
Zipsa 是一个本地优先的隐私网关，位于 OpenClaw 与云端大语言模型之间。它确保原始私有上下文永远不会离开本地环境，同时仍能利用强大的前沿模型进行推理。
使用场景
当用户提供或要求处理以下内容时，触发此技能：
- - 个人身份信息：姓名、社会安全号码、出生日期、联系方式。
- 医疗数据：患者记录、临床笔记、症状。
- 内部业务上下文：定价底线、谈判条款、客户流失预警、项目代号。
- 机密信息：API密钥、凭证、内部系统详情。
核心工作流程
Zipsa 作为一个兼容 OpenAI 的网关运行（默认地址：http://localhost:8000/v1）。
1. 识别敏感上下文
当用户的请求包含敏感数据时，说明将使用 Zipsa 来保护其隐私。
2. 通过 Zipsa 路由
不直接调用标准云服务提供商，而是使用 Zipsa 端点。Zipsa 将：
- - 本地扫描高风险标记。
- 分类查询（私有、混合或知识类）。
- 重构（重写）查询，以抽象化身份和专有细节。
- 路由安全版本至云端。
- 合成最终答案并回填本地细节。
集成示例
与 OpenClaw 配合使用
OpenClaw 可配置为使用 Zipsa 作为其后端：
- - OPENAIBASEURL=http://localhost:8000/v1
- OPENAIAPIKEY=zipsa-key
- OPENAI_MODEL=zipsa
多轮会话
为保持对话连续性，始终传递 session_id。
json
{
model: zipsa,
messages: [...],
extra
body: { sessionid: 唯一会话ID }
}
参考
详细配置和高级示例，请参见
references/README.md。
