本页内容

本页内容

网关

OpenShell 后端

基于相同 SSH 传输构建的 OpenShell 生命周期,以及其镜像和远程工作空间模式之间的差异。

OpenShell 后端

在 OpenShell- 托管远程环境中使用 backend: "openshell" 沙箱工具。 OpenShell 重复使用与通用 SSH 后端相同的 SSH 传输和远程文件系统桥,并添加 OpenShell 生命周期 (sandbox create/get/delete/ssh-config) 以及可选的 mirror 工作区同步模式。

json5
{  agents: {    defaults: {      sandbox: {        mode: "all",        backend: "openshell",        scope: "session",        workspaceAccess: "rw",      },    },  },  plugins: {    entries: {      openshell: {        enabled: true,        config: {          from: "openclaw",          mode: "remote", // mirror | remote        },      },    },  },}

mode: "mirror"(默认)将本地工作区保留为事实来源:OpenClaw 在 exec 之前将本地同步到沙箱,然后再同步回来。 mode: "remote" 从本地播种远程工作空间一次,然后直接针对远程工作空间运行 exec/read/write/edit/apply_patch,无需同步回来;种子后的本地编辑在您 openclaw sandbox recreate 之前是不可见的。在 scope: "agent" 或 scope: "shared" 下,该远程工作区在同一范围内共享。当前限制:尚不支持沙箱浏览器,并且 sandbox.docker.binds 不适用于此后端。

openclaw sandbox list/recreate/prune 都将 OpenShell 运行时视为 Docker 运行时;修剪逻辑是后端感知的。

有关完整的前置条件、配置参考、工作区模式对比以及生命周期细节,请参阅 OpenShell。

本页有帮助吗?