跳转至

沙箱与内存

沙箱与记忆

有专门的沙箱文档吗?

是的:沙箱。有关 Docker 特定设置(在 Docker 中运行完整网关或使用沙箱镜像),请参阅 Docker。

Docker 感觉受限——如何启用完整功能?

默认镜像以安全为先,并以 node 用户运行,因此不包含系统软件包、Homebrew 和捆绑的浏览器。若需更完整的设置:

  • 使用 OPENCLAW_HOME_VOLUME 持久化 /home/node,以便缓存得以保留。
  • 使用 OPENCLAW_IMAGE_APT_PACKAGES 将系统依赖烘焙到镜像中。
  • 使用 OPENCLAW_INSTALL_BROWSER=1 将 Playwright Chromium 及其系统依赖烘焙到镜像中。

文档:Docker、浏览器。

能否通过一个智能体,让私信保持私密,同时让群组公开/沙箱化?

可以,前提是私密流量为 私信(DM),公开流量为群组。设置 agents.defaults.sandbox.mode: "non-main",以便群组/频道会话(非主键)在配置的沙箱后端中运行,而主私信会话仍在主机上运行。选择 backend: "docker" 以使用 Docker,或选择 backend: "podman" 以使用 Podman。通过 tools.sandbox.tools 限制沙箱会话中可用的工具。

设置演练:群组:个人私信 + 公开群组。关键参考:网关配置。

如何将主机文件夹绑定到沙箱中?

将 agents.defaults.sandbox.docker.binds 设置为 ["host:container:mode"](例如 "/home/user/src:/src:ro")。全局绑定与每个智能体的绑定会合并;当 scope: "shared" 时,每个智能体的绑定会被忽略。对任何敏感内容使用 :ro;绑定会绕过沙箱文件系统的隔离墙。

OpenClaw 会同时根据规范化路径和通过最深现有祖先目录解析出的规范路径来验证绑定源,因此即使最终路径段尚不存在,通过符号链接父目录的逃逸也会失败关闭(fail closed)。

参见 沙箱 和 沙箱 vs 工具策略 vs 提权。

记忆如何工作?

OpenClaw 的记忆是智能体工作区中的 Markdown 文件:每日笔记存放在 memory/YYYY-MM-DD.md,精选的长期笔记存放在 MEMORY.md(仅限主会话/私密会话)。

OpenClaw 还会在压缩(compaction)对对话进行总结之前,运行一次静默的压缩前记忆刷新(pre-compaction memory flush),提醒模型先写入持久笔记。它仅在工作区可写时运行(只读沙箱会跳过它);可通过 agents.defaults.compaction.memoryFlush.enabled: false 禁用。参见 记忆。

记忆总是忘记事情。如何让它记住?

让智能体把事实写入记忆:长期笔记放入 MEMORY.md,短期上下文放入 memory/YYYY-MM-DD.md。提醒模型存储记忆通常可以解决这个问题。如果它仍然忘记,请确认网关在每次运行时都使用相同的工作区。

文档:记忆、智能体工作区。

记忆会永久保留吗?限制是什么?

记忆文件保存在磁盘上,在被删除之前会一直存在;限制在于你的存储空间,而非模型。会话上下文仍然受限于模型的上下文窗口,因此长对话可能会被压缩(compact)或截断(truncate)——这正是记忆搜索存在的原因:它只将相关部分拉回上下文中。

文档:记忆、上下文。

语义记忆搜索需要 OpenAI API 密钥吗?

不需要。默认提供方 OpenAI embeddings 可以在账户授予嵌入访问权限时使用已存储的 Codex OAuth 配置文件,或者使用 API 密钥(OPENAI_API_KEY 或 models.providers.openai.apiKey)。单独的“Sign in with ChatGPT”令牌共享授权并不授权使用嵌入功能。运行 openclaw memory status --deep 以检查你配置的账户。

如需保持本地运行,请设置 memory.search.provider: "local"(GGUF/llama.cpp)。其他支持的提供方:Bedrock、DeepInfra、Gemini(GEMINI_API_KEY 或 memory.search.remote.apiKey)、GitHub Copilot、LM Studio、Mistral、Ollama、OpenAI 兼容服务以及 Voyage。有关设置详情,请参阅 记忆 和 记忆搜索。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw