FEATURED · 精选文章

Claude-Mem 无交互安装:在无 GUI 机器上手工写入 settings.json 完成 CMEM Pro 部署

发布时间 / 2026/9/9 16:24:21
来源 / 创域科博编辑部
栏目 / 资讯中心
Claude-Mem 无交互安装:在无 GUI 机器上手工写入 settings.json 完成 CMEM Pro 部署 Claude-Mem 无交互安装在无 GUI 机器上手工写入 settings.json 完成 CMEM Pro 部署【免费下载链接】claude-memPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode More项目地址: https://gitcode.com/GitHub_Trending/cl/claude-mem在一台只能 SSH 登录的服务器、CI 机器或第二台没有浏览器的机器上npx claude-mem install的交互式 OAuth 配对输出设备码后打开浏览器授权页无法完成。Claude-Mem 官方文档 CMEM Pro (manual / headless) 给出的路径是前提是你已经有一个 cmem.ai 账号并拿到配对 token然后手工把安装器本应写入的键合并进~/.claude-mem/settings.json重启 worker再用/api/health和/api/sync/status两个端点验证。走完这条路径后该机器上的 observations 会通过cmem-observer模型经 cmem.ai 推理网关落库并与其他设备做 Cloud Sync。准备条件已有一个 cmem.ai 账号并且能通过cmem.ai → Connect或在一台能交互的机器上跑安装器配对拿到setup_token、user_id、hub_url以及memory_key如果没有单独的memory_key就用setup_token。目标机器上可以运行npx。按 Installation Guide 的系统要求Node.js 需要 20.0.0 或更高Bun 和 uv 由安装流程自动补齐。运行过 Claude-Mem 的机器上数据目录是~/.claude-mem/其中settings.json存放配置.worker.port和.worker.pid记录 worker 端口与进程。写入 settings.json安装器的写入分两部分Staged云同步 trial 元数据和Activated真正让 observations 跑起来的部分。手工部署时需要把两部分合并进同一个文件~/.claude-mem/settings.json。Activated 部分的规则是worker 通过通用的 OpenRouter 客户端访问 cmem.ai 推理网关因此 provider 设为openrouterbase URL 指向https://cmem.ai/api/inference/v1模型为cmem-observerAPI key 填入memory_key。项目文档说明没有单独的 CMEM provider 实现。cmem-pro-headless.mdx 给出的完整手工模板如下。其中的值都是占位符需替换成你自己的 token且文档明确要求不要把真实密钥粘贴进聊天、工单或文档{ CLAUDE_MEM_CLOUD_SYNC_TOKEN: cm_pro_YOUR_SETUP_TOKEN, CLAUDE_MEM_CLOUD_SYNC_USER_ID: YOUR_USER_ID, CLAUDE_MEM_CLOUD_SYNC_HUB_URL: https://YOUR_HUB_URL, CLAUDE_MEM_CLOUD_SYNC_DEVICE_ID: , CLAUDE_MEM_CLOUD_SYNC_DEVICE_NAME: my-machine, CLAUDE_MEM_PRO_TRIAL_STATE: active, CLAUDE_MEM_PRO_TRIAL_ENDS_AT: , CLAUDE_MEM_PRO_PLAN: trial, CLAUDE_MEM_PRO_FALLBACK_AT: , CLAUDE_MEM_PROVIDER: openrouter, CLAUDE_MEM_OPENROUTER_BASE_URL: https://cmem.ai/api/inference/v1, CLAUDE_MEM_OPENROUTER_MODEL: cmem-observer, CLAUDE_MEM_OPENROUTER_API_KEY: cm_pro_YOUR_MEMORY_KEY }各占位符的替换来源键替换来源CLAUDE_MEM_CLOUD_SYNC_TOKENConnect 页的setup_tokenCLAUDE_MEM_CLOUD_SYNC_USER_IDuser_idCLAUDE_MEM_CLOUD_SYNC_HUB_URLhub_urlcmem.ai 账号文档中提供的同步 hub 地址CLAUDE_MEM_CLOUD_SYNC_DEVICE_ID留空字符串worker 首次启动时自行生成CLAUDE_MEM_CLOUD_SYNC_DEVICE_NAME任意可读的设备名如主机名CLAUDE_MEM_PRO_PLAN/CLAUDE_MEM_PRO_TRIAL_STATE/CLAUDE_MEM_PRO_TRIAL_ENDS_AT按账号实际 trial 状态填写CLAUDE_MEM_OPENROUTER_API_KEYmemory_key若没有单独的memory_key用setup_token两点文档特别强调的细节memory_key和setup_token经常是同一个值cm_pro_…如果配对返回的是不同的memory_key就用它填CLAUDE_MEM_OPENROUTER_API_KEYsetup_token只保留在CLAUDE_MEM_CLOUD_SYNC_TOKEN上。另外云同步只在 token、user id、hub URL 三者全部非空时才生效没有单独的开关项见 Cloud Sync。设置权限并重启 worker写完文件后立即收紧权限因为文件里含密钥chmod 600 ~/.claude-mem/settings.json然后重启 worker让它不要继续持有旧的内存态 provider / 同步状态——交互式安装器在持久化 provider 之后会停掉 worker原因相同npx claude-mem restart验证部署worker 端口取自环境变量CLAUDE_MEM_WORKER_PORT或~/.claude-mem/.worker.port默认按用户派生为37700 (uid % 100)见 troubleshooting。拿到端口后依次请求curl -s http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/health curl -s http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/sync/status文档给出的成功条件/api/health中 provider 显示为openrouter/api/sync/status中configured: true且hub.reachable: true。/api/sync/status是无条件注册的端点未配置时返回200加{ configured: false }而不是 404所以未配置和worker 没起可以直接区分开。hub.reachable: true才是连通性判断lastError: null单独出现不够。最后一条端到端检查第一次真实 observation 应该通过cmem-observer模型成功落库。网关成功后CLAUDE_MEM_PRO_FALLBACK_AT会被清空如果网关返回终态的 quota / key 错误该时间戳会被写入内存回退到 Anthropic plan。回退是事件驱动的不要拿CLAUDE_MEM_PRO_TRIAL_ENDS_AT当作切换依据。排查与边界hub.reachable: false且带hub.error时说明 token 错误、hub URL 填错、响应格式异常、超时或网络故障——即使 pending 队列为空也能暴露出来见 cloud-sync.mdx。不要把个人 OpenRouter 的sk-or-…key 发给 cmem.ai 推理网关。三条路径不能混用CMEM Pro 用https://cmem.ai/api/inference/v1cm_pro_…memory key个人 OpenRouter 用空 base URL或https://openrouter.ai/api/v1 自己的sk-or-…Anthropic plan 走--provider claude完全不碰 cmem.ai 并清掉 CMEM 相关键。Cloud Sync 会把 observation 叙述和完整 prompt 文本上传到 cmem.ai 账号下的同步 hub如果这些内容必须留在本机不要启用云同步把 sync 三元组中任意一项置空即可关闭。一个 hub 账号最多接受 64 个不同 device id已有设备达到上限后照常同步新设备会收到409 device_limit_exceeded。如果这台机器上的插件文件本身还没装过首次部署交互式安装器的 runtime 阶段插件文件、依赖通常仍需一次可用终端来完成headless 文档覆盖的是已有 cmem.ai 账号、只是无法走交互式 OAuth 配对这一情形。部署完成后后续维护入口是 Installation 中的npx claude-mem repair版本标记不匹配时和 Cloud Sync 的/cloud-syncskill。【免费下载链接】claude-memPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode More项目地址: https://gitcode.com/GitHub_Trending/cl/claude-mem创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED — 相关阅读

相关资讯

LATEST — 最新资讯

最新发布

TODAY — 本日精选

新闻

WEEKLY — 本周精选

新闻

MONTHLY — 本月精选

新闻