openclaw claws
Claw 是用于一个新 OpenClaw 智能体的版本化设置。它可以描述智能体的可移植身份、工作区文件、Skills、插件、MCP 服务器和定时任务。特定于 harness 的智能体设置可以包含在引用的包配置文件中。Claw 不会替换或修改现有智能体。
Claws 是实验性功能。其架构、命令输出和生命周期可能会发生变化。
请显式启用命令界面：
CLAW.md 或分组的 JSON 清单。
通过 ClawHub 发布、搜索和安装完整 Claws 属于单独的注册表路线，尚未纳入此命令界面。
创建 Claw 包
包包含package.json、一个 CLAW.md 清单，以及该清单引用的任何配置文件或工作区附属文件：
CLAW.md 以 YAML frontmatter 开头。其 Markdown 正文面向用户描述 Claw，不属于智能体配置：
metadata 是用于可移植使用方提示的字符串到字符串映射。OpenClaw 的
openclaw.config 键指向可选的包相对 YAML 配置文件。导出的默认值为 profiles/openclaw.yml；该指针具有规范性，因此包可以选择另一个安全的相对 .yml 或 .yaml 路径。
metadata.openclaw.config 指针，而不是嵌入 OpenClaw 配置文件的第二份副本。本页其余架构片段使用 JSON，CLAW.md frontmatter 中提供等效键。
OpenClaw 包配置文件可以选择运行中 OpenClaw 版本注册的任何内置工具配置文件，然后使用 alsoAllow、deny 和 tools.fs.workspaceOnly: true 进一步调整。Claw 不能将该字段设置为 false 并削弱主机文件系统限制。tools.allow 仍可用作显式允许列表，但不能与 alsoAllow 组合使用。Claw 还可以设置 memory.search.enabled，选择可移植的 memory 和 sessions 来源，并通过 rememberAcrossConversations 选择启用跨对话记忆。
声明 sessions 来源需要启用该选项。
主机策略仍会约束这些设置，Claws 不携带自定义配置文件定义、提供商、凭据、绑定或本地记忆路径。
引用的配置文件大小限制为 256 KiB，必须是与 JSON 兼容的 YAML，不得使用别名、锚点、标签或合并键，并且必须是包内的常规文件，不能是符号链接或硬链接。
包路径和工作区路径必须保持在包根目录内。清单大小限制为 1 MiB，包元数据限制为 256 KiB，工作区来源则分别实施单文件限制和总量限制。工作区来源还会拒绝包含符号链接的父目录。
工作区文件按路径声明，并从包附属文件中读取。SOUL.md 等引导文件使用命名条目；其他文件使用包相对来源和工作区相对目标：
mcp.servers 配置模型：
检查和预览
验证来源而不规划本地更改：planIntegrity 摘要。能力记录会显示确切的包、MCP、计划工作、沙箱、工具或 Heartbeat 影响。创建智能体前请审查计划：
--yes 并不足够。如果预览后来源、目标或实时配置发生变化，OpenClaw 会重新构建计划并拒绝同意。当包默认值与本地状态冲突时，请在预览和应用期间都使用 --agent-id 或 --workspace。对于一次性配置文件和并行验证，请传递显式的 --workspace；OPENCLAW_STATE_DIR 会重新定位运行时状态，但不会更改默认工作区位置。
添加 Claw 会创建新的智能体和工作区配置，写入声明的工作区文件，安装或复用声明的技能和插件工件，并记录包、MCP 和定时任务的来源信息。现有文件不会被覆盖；如果拥有的内容发生漂移，重试会以关闭方式失败。
检查已安装状态
status 会将已安装的智能体及其记录的工作区、包、MCP 和定时任务来源信息与当前状态进行比较。它会报告未完成的安装、缺失资源和漂移，而不会更改本地状态。openclaw doctor 会添加 Claw 专用诊断，用于检测不完整的所有权记录、不安全的托管文件，以及无法通过实时 Gateway 网关清单核实的定时任务。
Claw 来源记录区分两种关系：
- **托管：**Claw 引入并且当前管理该资源。当资源未更改且不存在冲突的所有者时，它是清理候选项。
- **引用：**该资源原本独立存在或由多方共享。移除操作会释放此 Claw 的引用，并默认保留该资源。
更新已安装的 Claw
默认情况下，更新操作使用添加 Claw 时记录的来源。当该来源已移动或测试其他包目录时，请使用--from：
! 行。其中包括解析后的包完整性、安装身份和任何信任警告。移除包声明会释放此 Claw 的依赖边，但更新期间不会卸载工件。最终的精确 planIntegrity 确认会同时约束该已披露集合和普通内容更改。主机可以使用相同的记录显示单独的对话框或进行聚合的多智能体审查。使用显式同意应用经过准确审查的计划：
update_partial 和结构化的 status: partial，保留不确定的来源记录，并停止执行。检查 claws status、受影响的资源和 openclaw doctor；然后再次预览，之后再重试或移除任何内容。
移除已安装的 Claw
选择清理操作前先预览移除计划：--yes 绝不会扩大其范围。全局安装的插件会被保留，同时释放此 Claw 的引用；如果确实要卸载进程范围的插件，请另行使用普通的插件生命周期。
要移除由 Claw 引入、未更改且不存在其他当前所有者的引用，请在预览和应用中都包含 --remove-unused。要改为选择确切的被引用资源，请重复使用 --remove-referenced：
--force-referenced。它允许在存在这些冲突的情况下清理所选内容，但不会跳过计划完整性同意。
导出已安装的智能体
导出会创建一个新的包目录；如果目标已存在或托管状态已发生漂移，则操作失败：package.json、规范的 CLAW.md 和托管工作区
辅助文件。它是一个可移植的 Claw 包，而不是整个实例的备份：不相关的
智能体、凭据、会话和不归其所有的本地状态均不包含在内。
命令参考
使用
--json 获取实验性的机器可读输出。