
Memory Proxy Setup
Walks you through connecting an agent to the Memory Proxy, step by step.
Install
npx skills add TencentCloud/TencentDB-Agent-Memory --skill setup-proxy -g -a claude-code -y- Repository
- TencentCloud/TencentDB-Agent-Memory30.3k
- Category
- DevOps
- Updated
- 7d ago
- License
- See repository
- Context cost
- Mediumabout 1,846 tokens
- Runs scripts
- Yes, review before use
What it does
交互式引导用户配置 AI Agent 接入 Memory Proxy(逐步探测、逐步验证)
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 配置,避免重复填写:
# 检查 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: 收集基础信息
依次向用户获取:
- Proxy 地址(含协议+端口,如
http://127.0.0.1:8096) - Instance ID(默认
default,本地部署一般不用改) - User Key(从面板 API Key 页获取,不限格式)
每个信息获取后确认,不要一次问三个。
Step 3: 选择 Agent
展示 7 个可选 agent 让用户选择一个:
- Claude Code
- CodeBuddy
- Codex
- WorkBuddy
- dsh (DeepSeek Harness)
- Hermes
- OpenClaw

