# Memory Proxy Setup

Walks you through connecting an agent to the Memory Proxy, step by step.

- Repository: https://github.com/TencentCloud/TencentDB-Agent-Memory (30326 stars)
- Category: DevOps
- License: see repository
- Last updated: 2026-10-28
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add TencentCloud/TencentDB-Agent-Memory --skill setup-proxy -g -a claude-code -y`
Codex: `npx skills add TencentCloud/TencentDB-Agent-Memory --skill setup-proxy -g -a codex -y`
Cursor: `npx skills add TencentCloud/TencentDB-Agent-Memory --skill setup-proxy -g -a cursor -y`
Gemini CLI: `npx skills add TencentCloud/TencentDB-Agent-Memory --skill setup-proxy -g -a gemini-cli -y`

## Description

交互式引导用户配置 AI Agent 接入 Memory Proxy（逐步探测、逐步验证）

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Setup Proxy, Agent 接入配置向导

你正在帮助用户将一个 AI Agent 客户端（Claude Code / CodeBuddy / Codex / WorkBuddy / dsh / Hermes / OpenClaw）接入 Memory Proxy。

## 背景知识

Memory Proxy 是一个 LLM 请求代理，在请求转发到上游 LLM 之前注入团队记忆/技能/知识。每个 agent 客户端有不同的配置文件格式和协议：

| Agent | 配置文件 | 协议 | 特殊要求 |
|-------|----------|------|----------|
| claude-code | `~/.claude/settings.json` | Anthropic Messages | env 字段里写 5 个模型变量 |
| codebuddy | `~/.codebuddy/models.json` | OpenAI Chat | models 数组追加条目 |
| codex | `~/.codex/config.toml` | OpenAI Responses | TOML 格式，必须 `wire_api = "responses"` |
| workbuddy | `~/.workbuddy/models.json` | OpenAI Chat / Responses | 顶层数组 |
| dsh | `~/.dsh/settings.yaml` + `~/.dsh/.credentials.yaml` | OpenAI Chat (无 /v1) | 两个文件 + chmod 700/600 |
| hermes | `~/.hermes/config.yaml` | OpenAI Chat | 需 header 预选 (x-team-id/agent-id/task-id) |
| openclaw | `~/.openclaw/openclaw.json` | OpenAI Chat | 需 header 预选 + allowPrivateNetwork |

## 脚本位置

配置写入脚本：`agents/skills/setup-proxy/setup-proxy.sh`（相对于仓库根目录）

## 执行流程

**严格按以下顺序，每一步必须验证通过后再进入下一步。**

### Step 1: 扫描现有配置

先检查用户是否已有 proxy 配置，避免重复填写：

```bash
# 检查 Claude Code
cat ~/.claude/settings.json 2>/dev/null | jq -r '.env.ANTHROPIC_BASE_URL // empty'

# 检查 CodeBuddy
cat ~/.codebuddy/models.json 2>/dev/null | jq -r '.models[]? | select(.url | contains("/codebuddy/")) | .url' 2>/dev/null | head -1

# 检查其他 agent 类似...
```

如果扫描到含 proxy 路径的 URL（包含 `/claude-code/`、`/codebuddy/`、`/codex/` 等片段），**提取并展示**：
- Proxy 地址（URL 中 `/<agent>/` 之前的部分）
- Instance ID（URL 中 `/<agent>/` 之后的那段）
- User Key（对应字段的值，脱敏显示首尾 4 字符）
- Model ID

询问用户："检测到现有配置，是否复用？"
- 是 → 跳到 Step 3
- 否 → 继续 Step 2 手动输入

### Step 2: 收集基础信息

依次向用户获取：
1. **Proxy 地址**（含协议+端口，如 `http://127.0.0.1:8096`）
2. **Instance ID**（默认 `default`，本地部署一般不用改）
3. **User Key**（从面板 API Key 页获取，不限格式）

每个信息获取后确认，不要一次问三个。

### Step 3: 选择 Agent

展示 7 个可选 agent 让用户选择**一个**：
1. Claude Code
2. CodeBuddy
3. Codex
4. WorkBuddy
5. dsh (DeepSeek Harness)
6. Hermes
7. OpenClaw

### Step 4: 填写模型 ID

The rest: https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/HEAD/agents/skills/setup-proxy/SKILL.md