agentmemory配置指南30环境变量逐项说明【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemoryagentmemory 是一款为 AI 编程助手提供持久记忆的开源工具它的核心配置就是 30 多个环境变量——全部写在~/.agentmemory/.env一个文件里。本文把 LLM 提供商、嵌入模型、端口、功能开关等 agentmemory 配置项逐项讲清楚帮你一次配到位不用反复查源码。配置文件放在哪所有 agentmemory 环境变量统一写在~/.agentmemory/.envWindows 为%USERPROFILE%\.agentmemory\.env每行一个KEYvalue支持注释和引号。进程级环境变量优先shell 中export的变量会覆盖文件里的值改完重启生效修改后执行agentmemory stop再启动解析逻辑见 src/config.ts官方配置说明见 README.md 的 Configuration 章节一个典型的最小配置长这样ANTHROPIC_API_KEYsk-ant-... III_REST_PORT3111一、LLM 提供商环境变量核心agentmemory 按固定优先级自动探测提供商OpenAI → MiniMax → Anthropic → Gemini → OpenRouter都不设则进入零 LLM 模式BM25 本地嵌入记忆检索依然可用只是没有 LLM 压缩摘要。环境变量默认值作用ANTHROPIC_API_KEY无启用 Anthropic 提供商按 token 计费ANTHROPIC_MODELclaude-sonnet-5指定 Anthropic 模型ANTHROPIC_BASE_URL无代理 / Azure 兼容端点GEMINI_API_KEY无启用 Gemini同时激活 Gemini 嵌入GEMINI_MODELgemini-3.7-flash指定 Gemini 模型GOOGLE_API_KEY无兼容别名等价于GEMINI_API_KEY会打警告OPENAI_API_KEY无启用 OpenAI 提供商同时激活 OpenAI 嵌入OPENAI_MODELgpt-5.6-luna指定 OpenAI 模型OPENAI_BASE_URL无指向 Ollama / LM Studio / vLLM / Azure / 代理OPENAI_API_VERSION无Azure 的 api-version 查询参数OPENAI_TIMEOUT_MS60000OpenAI 路径专属超时旧版兼容别名OPENAI_REASONING_EFFORT无low/medium/high/none仅推理模型识别OPENAI_API_KEY_FOR_LLM无设为false让该 Key 只用于嵌入、不用于 LLMOPENROUTER_API_KEY无启用 OpenRouter可跑任意模型OPENROUTER_MODELanthropic/claude-sonnet-5指定 OpenRouter 模型MINIMAX_API_KEY无启用 MiniMaxAnthropic 兼容 APIMINIMAX_MODELMiniMax-M3指定 MiniMax 模型MAX_TOKENS4096所有 LLM 调用的输出 token 上限AGENTMEMORY_LLM_TIMEOUT_MS60000全部 raw-fetch 提供商的出站超时AGENTMEMORY_SUPPRESS_COST_WARNING无设为1屏蔽贵模型的每日成本警告AGENTMEMORY_PROVIDER自动探测显式指定提供商如noop/agent-sdkFALLBACK_PROVIDERS无逗号分隔的备用提供商链如gemini,openrouterAGENTMEMORY_ALLOW_AGENT_SDK无设为true才允许 Claude 订阅回退默认关闭以防递归本地模型零成本跑法Ollama 为例OPENAI_API_KEYollama OPENAI_BASE_URLhttp://localhost:11434/v1 OPENAI_MODELqwen3:8b AGENTMEMORY_LLM_NOTHINK1 压缩摘要是短任务7B 模型足够本地模型返回空结果时优先换非推理模型或设置OPENAI_REASONING_EFFORTnone。二、嵌入Embedding环境变量嵌入决定语义搜索质量默认走本地huggingface/transformers384 维零配置。环境变量默认值作用EMBEDDING_PROVIDER自动探测强制指定local/openai/gemini/voyage/cohere/openrouterOPENAI_API_KEY无有 Key 时自动选用 OpenAI 嵌入OPENAI_EMBEDDING_MODELtext-embedding-3-small嵌入模型OPENAI_EMBEDDING_DIMENSIONS自动模型不在已知列表时必填VOYAGE_API_KEY无启用 Voyage 嵌入COHERE_API_KEY无启用 Cohere 嵌入三、端口与环境变量4 个端口一次看懂agentmemory 默认绑定 4 个端口重启报port in use时对照下表排查端口进程用途环境变量3111agentmemoryREST API MCP HTTPIII_REST_PORT3112iii-engine内部流式 WorkerIII_STREAMS_PORT3113agentmemory实时可视化 ViewerAGENTMEMORY_VIEWER_PORT49134iii-engineWebSocket / OTel 遥测III_ENGINE_URL环境变量默认值作用III_REST_PORT3111REST 锚点端口其余端口自动 1 / 联动偏移III_ENGINE_URLws://localhost:49134引擎完整 URLAGENTMEMORY_URLhttp://localhost:3111客户端连接的服务地址远程部署时必填四、功能开关环境变量环境变量默认作用AGENTMEMORY_AUTO_COMPRESS关闭每次观察都调 LLM 压缩注意 token 消耗AGENTMEMORY_SLOTS关闭开启可编辑的固定记忆槽人设、偏好、TODO 等AGENTMEMORY_REFLECT关闭依赖 SLOTSStop 钩子自动沉淀观察AGENTMEMORY_INJECT_CONTEXT关闭向会话注入约 1-2K 字符的项目上下文AGENTMEMORY_TOOLSallMCP 工具面all54 个或core8 个精简GRAPH_EXTRACTION_ENABLED关闭开启知识图谱抽取GRAPH_EXTRACTION_BATCH_SIZE10图谱抽取批大小CONSOLIDATION_ENABLED有 LLM 即开图谱/经验/结晶自动整合false彻底关闭CONSOLIDATION_DECAY_DAYS30记忆衰减周期天AGENTMEMORY_CONSOLIDATION_COOLDOWN_MS300000整合冷却时间防每轮都触发LESSON_DECAY_ENABLED开启经验条目衰减设为false关闭OBSIDIAN_AUTO_EXPORT关闭整合后自动导出 Obsidian 笔记AGENTMEMORY_EXPORT_ROOT~/.agentmemoryObsidian 导出目录CLAUDE_MEMORY_BRIDGE关闭把记忆桥接进 Claude Code 的 MEMORY.mdCLAUDE_PROJECT_PATH无桥接目标项目路径CLAUDE_MEMORY_LINE_BUDGET200桥接时 MEMORY.md 行数预算SNAPSHOT_ENABLED关闭定时 git 快照SNAPSHOT_INTERVAL3600快照间隔秒SNAPSHOT_DIR~/.agentmemory/snapshots快照目录AGENTMEMORY_DROP_STALE_INDEX关闭启动时丢弃过期持久化索引AGENTMEMORY_FOLLOWUP_WINDOW_SECONDS30搜索追问率诊断窗口STANDALONE_MCP关闭独立 stdio MCP 模式不依赖引擎STANDALONE_PERSIST_PATH~/.agentmemory/standalone.json独立模式持久化文件AGENTMEMORY_SECRET无API 鉴权密钥设置后受保护端点需 Bearer Token五、搜索调优与多 Agent 环境变量混合搜索调参BM25 关键词 向量语义加权环境变量默认值说明BM25_WEIGHT0.4关键词匹配权重专有名词多可调高VECTOR_WEIGHT0.6语义向量权重TOKEN_BUDGET2000搜索返回结果的 token 预算MAX_OBS_PER_SESSION500单会话最大观察条数多 Agent / 团队协作环境变量默认说明AGENT_ID无给所有写入打上角色标签architect / developer…AGENTMEMORY_AGENT_SCOPEshared设为isolated后召回按角色隔离过滤TEAM_ID无团队共享记忆的团队标识USER_ID无用户标识与 TEAM_ID 成对启用TEAM_MODEprivateshared表示团队内共享六、常见配置速查只想本地跑、零费用OPENAI_API_KEYlocalOPENAI_BASE_URL指向 Ollama嵌入保持默认EMBEDDING_PROVIDERlocal省钱方案OpenRouter 配deepseek/deepseek-v4-flash-0731实测 35 小时活跃使用约 $0.07Sonnet 约 $5只想保留记忆、关掉整合CONSOLIDATION_ENABLEDfalse端口冲突改III_REST_PORT3211其余三个端口自动联动为 3212 / 49234完整的 54 个 MCP 工具清单与 API 端点参考 src/triggers/api.ts配置解析全部实现集中在 src/config.ts。✅ 记住一句话API Key 决定能力上限AGENTMEMORY_*前缀变量决定行为开关III_*前缀变量决定端口位置。按需组合重启即生效。【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 agentmemory配置指南：30+环境变量逐项说明
agentmemory配置指南30环境变量逐项说明【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemoryagentmemory 是一款为 AI 编程助手提供持久记忆的开源工具它的核心配置就是 30 多个环境变量——全部写在~/.agentmemory/.env一个文件里。本文把 LLM 提供商、嵌入模型、端口、功能开关等 agentmemory 配置项逐项讲清楚帮你一次配到位不用反复查源码。配置文件放在哪所有 agentmemory 环境变量统一写在~/.agentmemory/.envWindows 为%USERPROFILE%\.agentmemory\.env每行一个KEYvalue支持注释和引号。进程级环境变量优先shell 中export的变量会覆盖文件里的值改完重启生效修改后执行agentmemory stop再启动解析逻辑见 src/config.ts官方配置说明见 README.md 的 Configuration 章节一个典型的最小配置长这样ANTHROPIC_API_KEYsk-ant-... III_REST_PORT3111一、LLM 提供商环境变量核心agentmemory 按固定优先级自动探测提供商OpenAI → MiniMax → Anthropic → Gemini → OpenRouter都不设则进入零 LLM 模式BM25 本地嵌入记忆检索依然可用只是没有 LLM 压缩摘要。环境变量默认值作用ANTHROPIC_API_KEY无启用 Anthropic 提供商按 token 计费ANTHROPIC_MODELclaude-sonnet-5指定 Anthropic 模型ANTHROPIC_BASE_URL无代理 / Azure 兼容端点GEMINI_API_KEY无启用 Gemini同时激活 Gemini 嵌入GEMINI_MODELgemini-3.7-flash指定 Gemini 模型GOOGLE_API_KEY无兼容别名等价于GEMINI_API_KEY会打警告OPENAI_API_KEY无启用 OpenAI 提供商同时激活 OpenAI 嵌入OPENAI_MODELgpt-5.6-luna指定 OpenAI 模型OPENAI_BASE_URL无指向 Ollama / LM Studio / vLLM / Azure / 代理OPENAI_API_VERSION无Azure 的 api-version 查询参数OPENAI_TIMEOUT_MS60000OpenAI 路径专属超时旧版兼容别名OPENAI_REASONING_EFFORT无low/medium/high/none仅推理模型识别OPENAI_API_KEY_FOR_LLM无设为false让该 Key 只用于嵌入、不用于 LLMOPENROUTER_API_KEY无启用 OpenRouter可跑任意模型OPENROUTER_MODELanthropic/claude-sonnet-5指定 OpenRouter 模型MINIMAX_API_KEY无启用 MiniMaxAnthropic 兼容 APIMINIMAX_MODELMiniMax-M3指定 MiniMax 模型MAX_TOKENS4096所有 LLM 调用的输出 token 上限AGENTMEMORY_LLM_TIMEOUT_MS60000全部 raw-fetch 提供商的出站超时AGENTMEMORY_SUPPRESS_COST_WARNING无设为1屏蔽贵模型的每日成本警告AGENTMEMORY_PROVIDER自动探测显式指定提供商如noop/agent-sdkFALLBACK_PROVIDERS无逗号分隔的备用提供商链如gemini,openrouterAGENTMEMORY_ALLOW_AGENT_SDK无设为true才允许 Claude 订阅回退默认关闭以防递归本地模型零成本跑法Ollama 为例OPENAI_API_KEYollama OPENAI_BASE_URLhttp://localhost:11434/v1 OPENAI_MODELqwen3:8b AGENTMEMORY_LLM_NOTHINK1 压缩摘要是短任务7B 模型足够本地模型返回空结果时优先换非推理模型或设置OPENAI_REASONING_EFFORTnone。二、嵌入Embedding环境变量嵌入决定语义搜索质量默认走本地huggingface/transformers384 维零配置。环境变量默认值作用EMBEDDING_PROVIDER自动探测强制指定local/openai/gemini/voyage/cohere/openrouterOPENAI_API_KEY无有 Key 时自动选用 OpenAI 嵌入OPENAI_EMBEDDING_MODELtext-embedding-3-small嵌入模型OPENAI_EMBEDDING_DIMENSIONS自动模型不在已知列表时必填VOYAGE_API_KEY无启用 Voyage 嵌入COHERE_API_KEY无启用 Cohere 嵌入三、端口与环境变量4 个端口一次看懂agentmemory 默认绑定 4 个端口重启报port in use时对照下表排查端口进程用途环境变量3111agentmemoryREST API MCP HTTPIII_REST_PORT3112iii-engine内部流式 WorkerIII_STREAMS_PORT3113agentmemory实时可视化 ViewerAGENTMEMORY_VIEWER_PORT49134iii-engineWebSocket / OTel 遥测III_ENGINE_URL环境变量默认值作用III_REST_PORT3111REST 锚点端口其余端口自动 1 / 联动偏移III_ENGINE_URLws://localhost:49134引擎完整 URLAGENTMEMORY_URLhttp://localhost:3111客户端连接的服务地址远程部署时必填四、功能开关环境变量环境变量默认作用AGENTMEMORY_AUTO_COMPRESS关闭每次观察都调 LLM 压缩注意 token 消耗AGENTMEMORY_SLOTS关闭开启可编辑的固定记忆槽人设、偏好、TODO 等AGENTMEMORY_REFLECT关闭依赖 SLOTSStop 钩子自动沉淀观察AGENTMEMORY_INJECT_CONTEXT关闭向会话注入约 1-2K 字符的项目上下文AGENTMEMORY_TOOLSallMCP 工具面all54 个或core8 个精简GRAPH_EXTRACTION_ENABLED关闭开启知识图谱抽取GRAPH_EXTRACTION_BATCH_SIZE10图谱抽取批大小CONSOLIDATION_ENABLED有 LLM 即开图谱/经验/结晶自动整合false彻底关闭CONSOLIDATION_DECAY_DAYS30记忆衰减周期天AGENTMEMORY_CONSOLIDATION_COOLDOWN_MS300000整合冷却时间防每轮都触发LESSON_DECAY_ENABLED开启经验条目衰减设为false关闭OBSIDIAN_AUTO_EXPORT关闭整合后自动导出 Obsidian 笔记AGENTMEMORY_EXPORT_ROOT~/.agentmemoryObsidian 导出目录CLAUDE_MEMORY_BRIDGE关闭把记忆桥接进 Claude Code 的 MEMORY.mdCLAUDE_PROJECT_PATH无桥接目标项目路径CLAUDE_MEMORY_LINE_BUDGET200桥接时 MEMORY.md 行数预算SNAPSHOT_ENABLED关闭定时 git 快照SNAPSHOT_INTERVAL3600快照间隔秒SNAPSHOT_DIR~/.agentmemory/snapshots快照目录AGENTMEMORY_DROP_STALE_INDEX关闭启动时丢弃过期持久化索引AGENTMEMORY_FOLLOWUP_WINDOW_SECONDS30搜索追问率诊断窗口STANDALONE_MCP关闭独立 stdio MCP 模式不依赖引擎STANDALONE_PERSIST_PATH~/.agentmemory/standalone.json独立模式持久化文件AGENTMEMORY_SECRET无API 鉴权密钥设置后受保护端点需 Bearer Token五、搜索调优与多 Agent 环境变量混合搜索调参BM25 关键词 向量语义加权环境变量默认值说明BM25_WEIGHT0.4关键词匹配权重专有名词多可调高VECTOR_WEIGHT0.6语义向量权重TOKEN_BUDGET2000搜索返回结果的 token 预算MAX_OBS_PER_SESSION500单会话最大观察条数多 Agent / 团队协作环境变量默认说明AGENT_ID无给所有写入打上角色标签architect / developer…AGENTMEMORY_AGENT_SCOPEshared设为isolated后召回按角色隔离过滤TEAM_ID无团队共享记忆的团队标识USER_ID无用户标识与 TEAM_ID 成对启用TEAM_MODEprivateshared表示团队内共享六、常见配置速查只想本地跑、零费用OPENAI_API_KEYlocalOPENAI_BASE_URL指向 Ollama嵌入保持默认EMBEDDING_PROVIDERlocal省钱方案OpenRouter 配deepseek/deepseek-v4-flash-0731实测 35 小时活跃使用约 $0.07Sonnet 约 $5只想保留记忆、关掉整合CONSOLIDATION_ENABLEDfalse端口冲突改III_REST_PORT3211其余三个端口自动联动为 3212 / 49234完整的 54 个 MCP 工具清单与 API 端点参考 src/triggers/api.ts配置解析全部实现集中在 src/config.ts。✅ 记住一句话API Key 决定能力上限AGENTMEMORY_*前缀变量决定行为开关III_*前缀变量决定端口位置。按需组合重启即生效。【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考