القائمة
DBay 知识库 + 记忆 MCP，让 AI Agent 拥有跨会话长期记忆和知识检索能力。触发场景：用户要求记住某事、回忆之前的对话、搜索项目知识库、或需要跨会话保持上下文。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | dbay |
| description | DBay 知识库 + 记忆 MCP，让 AI Agent 拥有跨会话长期记忆和知识检索能力。触发场景：用户要求记住某事、回忆之前的对话、搜索项目知识库、或需要跨会话保持上下文。 |
| metadata | {"version":"1.0.0","author":"DBay","homepage":"https://dbay.cloud","repository":"https://github.com/MatrixDriver/dbay-cc"} |
DBay 为 AI Agent 提供两大能力：
检查 Python 3.10+ 和 pip 是否可用：
python3 --version && pip --version
pip install dbay-cli
dbay login
dbay login 会打开浏览器完成认证，API Key 存在 ~/.dbay/config.json，不会进入 Agent 配置文件。
没有桌面浏览器（远程服务器、容器、SSH 会话）？ 在本地浏览器登录 console.dbay.cloud → "API Keys" 复制一个 key，然后在远端手写：
mkdir -p ~/.dbay
cat > ~/.dbay/config.json <<EOF
{ "endpoint": "https://api.dbay.cloud:8443", "api_key": "lk_xxx" }
EOF
chmod 600 ~/.dbay/config.json
dbay mem create my-mem
dbay mem use my-mem
如需端到端加密记忆库：
dbay mem create --encrypted my-private-mem
根据不同平台执行对应命令。
每个平台的 MCP 配置都应该带上 DBAY_SOURCE 环境变量，DBay 用它给每条记忆打上"是哪个 Agent 写的"标签，溯源不会混。
claude mcp add --scope user dbay --env DBAY_SOURCE=claude-code -- uvx dbay-mcp
OpenClaw 自带 mcp set 子命令，直接跑这一条即可（自动写入 ~/.openclaw/openclaw.json 的 mcp.servers 块，已有条目会保留）：
openclaw mcp set dbay '{"command":"uvx","args":["dbay-mcp"],"env":{"DBAY_SOURCE":"openclaw"}}'
OpenClaw runtime 用 chokidar 监听配置文件，保存后会自动热重载，无需手动重启 gateway。验证：
openclaw mcp show dbay
如果你只想看真实 JSON 落盘形态，路径是 ~/.openclaw/openclaw.json，dbay 条目会出现在 mcp.servers.dbay 下。
在 ~/.hermes/config.yaml 的 mcp_servers 块下添加：
mcp_servers:
dbay:
command: "uvx"
args: ["dbay-mcp"]
env:
DBAY_SOURCE: "hermes-agent"
timeout: 60
connect_timeout: 30
重启 hermes gateway 使配置生效。
安装完成后，可用工具包括：
| 工具 | 用途 |
|---|---|
memory_recall | 语义检索记忆 |
memory_ingest | 存储记忆 |
memory_list | 列出记忆 |
memory_delete | 删除记忆 |
knowledge_search | 搜索知识库 |
knowledge_list_bases | 列出知识库 |
knowledge_list_documents | 列出文档 |
knowledge_get_chunk | 获取文档片段 |
每条记忆都通过 source 字段标识来源 Agent：
| Agent | source 值 |
|---|---|
| Claude Code | claude-code |
| OpenClaw | openclaw |
| Hermes Agent | hermes-agent |
推荐做法：按上一节在每个 Agent 的 MCP 配置里设 DBAY_SOURCE 环境变量，dbay-mcp 会把它作为 source 字段的默认值。这样调用 memory_ingest 时不用每次都显式传 source，也不会忘记。
如需在某次调用里临时覆盖（例如代理别的 Agent 写记忆），仍可显式传：
memory_ingest(content="用户的偏好是...", memory_type="fact", source="openclaw")
如果需要日志诊断、租户定位等 SRE 运维能力，可额外安装 dbay-sre-mcp：
pip install dbay-sre-mcp
配置环境变量后注册 MCP：
# 必需环境变量
export LOG_DB_DSN="postgresql://..."
export LAKEON_ADMIN_TOKEN="..."
export LAKEON_API_BASE_URL="https://api.dbay.cloud:8443/api/v1"
Claude Code:
claude mcp add --scope user dbay-sre-mcp -- dbay-sre-mcp
OpenClaw 在 ~/.openclaw/openclaw.json 的 mcpServers 块里添加 dbay-sre-mcp 条目；Hermes 在 ~/.hermes/config.yaml 的 mcp_servers 块里添加对应条目，env 字段需显式声明上述环境变量。
memory 工具 ≠ DBay 记忆Hermes Agent 内置的 memory 工具 只写入本地 ~/.hermes/ 目录，不会写入 DBay。要让信息进入 DBay 长期记忆，必须明确调用 DBay MCP 的 memory_ingest 工具或使用 dbay mem ingest CLI 命令。
在 Hermes 中保存到 DBay 的正确方式：
方式一（推荐 — MCP 工具，通过 uvx dbay-mcp）：
memory_ingest(content="...", memory_type="fact|decision|rejection|convention|procedural|episode", source="hermes-agent")
方式二（API 直调，当 MCP 未就绪时）：
from dbay_cli.client import DbayClient
client = DbayClient(base_url, api_key)
client.mem_ingest(
mem_id="mem_xxx",
content="...",
role="assistant",
memory_type="decision",
source="hermes-agent"
)
dbay mem ingest CLI 选项dbay mem ingest "..." [--type TYPE] [--source TAG] [--raw]
--type：fact|decision|rejection|convention|procedural|episode，默认 fact--source：来源标签（如 cli、claude-code、hermes-agent），默认 cli--raw：把内容当作原始对话，让服务端 LLM 自动抽取（signal="conversation"）。不加此选项时默认按结构化记忆直接落库（signal="memory"），跟 MCP memory_ingest 行为一致。历史注：旧版本曾有
--no-extract选项，因为客户端从未实现对应字段且会污染signal字段，已在 dbay-cli 修复后删除——升级到最新版即可，不要再用--no-extract。
memory_type 是必填项当 signal='memory' 时，API 要求 memory_type 字段。可选值：fact, decision, rejection, convention, procedural, episode。不传会返回 400 错误。
DBay 支持多个 Agent（Hermes / Claude Code / OpenClaw）连接同一个记忆库。每条记忆通过 source 字段（hermes-agent / claude-code / openclaw）标识来源。三个平台都配好 MCP 后，在一个平台上存储的记忆，其他平台均可 memory_recall 搜索到。
dbay-mcp 读取 ~/.dbay/config.json 获取 API Key，确保 dbay login 已完成~/.dbay/encrypted_bases.json，密码在 ~/.dbay/secret~/.dbay/ 目录即可迁移