OpenClaw 中文文档
本页内容

本页内容

查看 Markdown以纯文本查看本页在 ChatGPT 中打开针对本页提问在 Claude 中打开针对本页提问

FAQ

东西在磁盘上的位置

磁盘上的内容位置

OpenClaw 使用的所有数据都保存在本地吗？

不是：OpenClaw 自身的状态保存在本地，但外部服务仍然能看到你发送给它们的内容。

  • 默认本地存储：会话、记忆文件、配置和工作区都位于 Gateway 主机上（~/.openclaw 以及你的工作区目录）。
  • 必须远程：发送到模型提供者（Anthropic/OpenAI/etc.）的消息会转到他们的API，聊天平台（Slack/Telegram/WhatsApp/etc.）将消息数据存储在他们的服务器上。
  • 由你控制数据留存范围：本地模型会将提示词保留在你的机器上，但频道流量仍会经过相应频道的服务器。

相关内容：Agent workspace、Memory。

OpenClaw 的数据存储在哪里？

所有内容都位于 $OPENCLAW_STATE_DIR 下（默认：~/.openclaw）：

路径 用途
$OPENCLAW_STATE_DIR/openclaw.json 主配置（JSON5）
$OPENCLAW_STATE_DIR/credentials/oauth.json openclaw doctor --fix 的旧版 OAuth 迁移源
$OPENCLAW_STATE_DIR/state/openclaw.sqlite 共享 SQLite 状态，包括共享身份验证配置文件
$OPENCLAW_STATE_DIR/secrets.json 用于 file SecretRef 提供方的可选文件后端密钥载荷
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.json openclaw doctor --fix 的旧版身份验证迁移源
$OPENCLAW_STATE_DIR/credentials/ 提供方状态（例如 whatsapp/<accountId>/creds.json）
$OPENCLAW_STATE_DIR/agents/ 每个代理状态（agentDir + legacy/archive 会话工件）
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/openclaw-agent.sqlite 每个代理 SQLite 状态，包括本地身份验证配置文件、会话和成绩单
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/ 旧会话迁移源和 archive/support 工件

旧版单 agent 路径 ~/.openclaw/agent/* 会由 openclaw doctor 迁移。

旧版 auth-profiles.json 文件由 openclaw doctor --fix 导入；新登录写入 SQLite。代理本地配置文件会覆盖共享的通读基础。较旧的安装将该共享存储保留在主代理的数据库中，直到医生重新定位它；请参阅 Auth 凭证语义。

你的工作区（AGENTS.md、memory 文件、skills 等）是单独的，通过 agents.defaults.workspace 配置（默认：~/.openclaw/workspace）。

AGENTS.md / SOUL.md / USER.md / MEMORY.md 应该住在哪里？

它们位于agent 工作区中，而不是 ~/.openclaw。

  • 工作区（每个 agent）：AGENTS.md、SOUL.md、IDENTITY.md、USER.md、MEMORY.md、memory/YYYY-MM-DD.md。根目录中的小写 memory.md 仅用于旧版修复输入；当两个文件同时存在时，openclaw doctor --fix 可以将其合并到 MEMORY.md 中。
  • State dir （~/.openclaw）：配置、channel/provider 状态、身份验证配置文件、会话、日志、共享技能 （~/.openclaw/skills）。

默认工作区是 ~/.openclaw/workspace，可配置：

json5
{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

如果机器人在重启后“忘记”了内容，请确认 Gateway 每次启动都使用相同的工作区（远程模式使用的是gateway 主机上的工作区，而不是你本地笔记本上的）。

提示：如果需要持久行为或偏好，最好让机器人把它写入 AGENTS.md 或 MEMORY.md，而不是依赖聊天历史。

参见 Agent workspace 和 Memory。

我可以把SOUL.md变大吗？

可以。SOUL.md 是注入到 agent 上下文中的工作区启动文件之一。默认单文件注入上限为 20000 个字符；跨文件的总启动预算为 60000 个字符。

更改共享默认值：

json5
{  agents: {    defaults: {      bootstrapMaxChars: 50000,      bootstrapTotalMaxChars: 300000,    },  },}

或在 agents.entries.*.bootstrapMaxChars / bootstrapTotalMaxChars 下为某个 agent 单独设置。

使用 /context 查看原始大小与注入后大小，以及是否发生了截断。保持 SOUL.md 重点描述语气、立场和个性；把操作规则放在 AGENTS.md 中，把持久事实放在 memory 中。

参见 Context 和 Agent config。

如何彻底卸载OpenClaw？

参见 Uninstall。

客服人员可以在工作空间之外工作吗？

可以。工作区是默认 cwd 和记忆锚点，而不是硬性沙箱。相对路径会解析到工作区内；如果未启用沙箱，绝对路径可以访问主机上的其他位置。若要隔离，请使用 agents.defaults.sandbox 或每个 agent 的沙箱设置。要把某个仓库设为默认工作目录，请把该 agent 的 workspace 指向仓库根目录——OpenClaw 仓库本身只是源代码，所以除非你有意让 agent 在其中工作，否则应保持工作区分离。

json5
{  agents: {    defaults: {      workspace: "~/path/to/my-repo",    },  },}
远程模式：会话存储在哪里？

会话状态归gateway 主机所有。在远程模式下，你关心的会话存储位于远程机器上，而不是你本地的笔记本上。参见 Session management。

本页有帮助吗？