OpenClaw 的 Symbiont 治理能力

将 Symbiont 的零信任 AI 代理治理能力引入您的 OpenClaw 工作流。强制执行 Cedar 授权策略、使用 SchemaPin 验证 MCP 工具完整性、通过 ClawHavoc 扫描技能、维护加密审计日志，并统一管理受治理的代理。

本技能是 OpenClaw 平台对应的 Symbiont 治理实现，与 symbi-claude-code 和 symbi-gemini-cli 功能一致。三者均提供相同的 Symbiont 治理能力，仅适配各自平台的技能/扩展格式。

Symbiont 治理代理人格所用的配套 SOUL.md 文件可在 onlycrabs.ai 单独获取。

前提条件

• 已安装 OpenClaw
• 安装 jq 用于 JSON 解析（apt install jq / brew install jq）
• symbi 二进制文件已加入系统 PATH（可选；缺失时本技能将降级运行）

安装 symbi：

# 通过 Homebrew 安装（推荐）
brew tap thirdkeyai/tap && brew install symbi

# 或从源码构建
cargo install symbi

# 或通过 Docker 运行
docker pull ghcr.io/thirdkeyai/symbi:latest

快速上手

安装本技能后，请按以下步骤操作：

1. 向代理发出指令：“初始化一个 Symbiont 治理项目”
2. 在 agents/*.dsl 中定义代理
3. 在 policies/*.cedar 中编写 Cedar 策略
4. 向代理询问：“检查 Symbiont 状态”

能力概览

本技能提供六类受治理的工作流。您只需以自然语言描述需求，代理将自动执行对应流程。

1. 初始化受治理项目

触发语句：“配置 Symbiont 治理”、“初始化受治理项目”、“为当前仓库添加代理治理”

在当前目录中创建受治理项目的脚手架结构：

1. 检查 symbiont.toml 是否已存在；若存在，则提示确认是否覆盖。
2. 创建如下目录结构：

   agents/          # 代理 DSL 定义
   policies/        # Cedar 策略文件
   .symbiont/       # 本地治理配置与审计日志
   .symbiont/audit/ # 审计日志输出目录
   

3. 写入默认配置的 symbiont.toml：

   [runtime]
   security_tier = "tier1"
   log_level = "info"
   
   [policy]
   engine = "cedar"
   enforcement = "strict"
   
   [schemapin]
   mode = "tofu"
   

4. 在 agents/assistant.dsl 写入初始代理定义：

   metadata {
       version = "1.0.0"
       description = "默认受治理助手"
   }
   
   agent assistant(input: Query) -> Response {
       capabilities = ["read", "analyze"]
   
       policy default_access {
           allow: read(input) if true
           deny: write(any) if not approved
           audit: all_operations
       }
   
       with memory = "session" {
           result = process(input)
           return result
       }
   }
   

5. 在 policies/default.cedar 写入初始 Cedar 策略：

   permit(
       principal,
       action == Action::"read",
       resource
   );
   
   forbid(
       principal,
       action == Action::"write",
       resource
   ) unless {
       principal.approved == true
   };
   

6. 在 .symbiont/local-policy.toml 中写入默认拒绝规则：

   [deny]
   paths = [".env", ".ssh/", ".aws/", ".gnupg/", "credentials"]
   commands = ["rm -rf", "git push --force", "mkfs", "dd if="]
   branches = ["main", "master", "production"]
   

7. 生成 AGENTS.md 清单文件。
8. 报告已创建内容，并建议后续操作。

2. 创建或编辑 Cedar 策略

触发语句：“创建一个 Cedar 策略”、“编辑授权策略”、“为 X 添加策略”

执行步骤：

1. 询问该策略拟管控的对象（如读/写权限、工具调用、沙箱等级等）。
2. 检查 policies/*.cedar 中已存在的策略。
3. 使用 Cedar 语法编写或更新 .cedar 文件。
4. 若 symbi 在 PATH 中，则运行 symbi policy validate policies/ 进行验证。
5. 说明该策略允许与禁止的具体行为。

参考文档：请查阅 references/cedar-patterns.md 获取常用 Cedar 策略模式。

3. 验证 MCP 工具 Schema（SchemaPin）

触发语句：“验证此 MCP 工具”、“检查工具 Schema”、“该工具是否已签名？”

执行步骤：

1. 识别工具名称及所属域名。
2. 若 symbi 在 PATH 中，则运行 symbi verify --tool --domain 。
3. 否则，说明 SchemaPin 基于 ECDSA P-256 的验证模型，并提供手动验证建议。
4. 报告验证结果：签名有效/无效、TOFU 引脚状态、是否已被撤销。

4. 查询审计日志

触发语句：“显示审计日志”、“代理执行了哪些操作？”、“审查工具调用记录”

执行步骤：

1. 检查是否存在 .symbiont/audit/tool-usage.jsonl。
2. 解析 JSONL 条目并汇总：工具名、时间戳、操作类型、执行结果、策略决策。
3. 若 symbi 在 PATH 中，则使用 symbi audit query 实现更丰富的查询能力。
4. 高亮显示所有被拒绝或标记的操作。

5. 编写或验证 DSL 代理定义

触发语句：“创建代理定义”、“编写 DSL 代理”、“验证我的代理 DSL”

执行步骤：

1. 明确代理用途、所需能力及策略约束。
2. 在 agents/ 目录下新建或编辑 .dsl 文件。
3. 若 symbi 在 PATH 中，则运行 symbi dsl parse agents/.dsl 进行验证。
4. 更新 AGENTS.md 清单文件。

参考文档：请查阅 references/dsl-guide.md 获取 DSL 语法与设计模式。

6. 扫描技能中的恶意模式（ClawHavoc）

触发语句：“扫描该技能”、“该技能是否安全？”、“检查是否存在恶意模式”、“执行 ClawHavoc 扫描”

执行步骤：

1. 指定待扫描的技能目录或 SKILL.md 文件路径。
2. 运行 scripts/clawhavoc-scan.sh ，依据内置 40+ 条检测规则进行扫描。
3. 按严重等级分类报告发现项：Critical（严重）、High（高危）、Medium（中危）、Warning（警告）、Info（信息）。
4. 若存在 Critical 或 High 级别发现项，则该技能不得加载。
5. 针对每项发现提供修复建议。

扫描器覆盖范围包括：反向 Shell、凭据窃取、网络数据外泄、进程注入、提权操作、符号链接/路径遍历、下载器链等。

治理等级

本技能提供三个渐进式防护等级，与 symbi-claude-code 和 symbi-gemini-cli 保持一致：

等级 1：感知（默认）

所有工具调用均正常执行。状态变更类操作将记录至 .symbiont/audit/tool-usage.jsonl，供事后审查。

无需 symbi 二进制文件。scripts/audit-log.sh 脚本负责日志记录。

等级 2：防护

通过创建 .symbiont/local-policy.toml 屏蔽危险行为模式：

[deny]
paths = [".env", ".ssh/", ".aws/"]
commands = ["rm -rf", "git push --force"]
branches = ["main", "master", "production"]

scripts/policy-guard.sh 脚本依据该拒绝列表校验工具调用。内置高危模式（如破坏性命令、强制推送、向敏感路径写入）始终被拦截，不受配置影响。

无需 symbi 二进制文件。同一份 .symbiont/local-policy.toml 可跨 symbi-claude-code、symbi-gemini-cli 及本技能通用。

等级 3：治理

当 symbi 在 PATH 中且 policies/ 目录存在时，每次工具调用均需经 Cedar 策略评估，生成正式的授权决策。

双模架构

模式 A：独立运行（技能优先）

开发者将本技能安装至 OpenClaw。该技能提供策略建议检查、审计日志记录，并在 symbi 可用时接入 Symbiont MCP 工具。

开发者 -> OpenClaw + symbiont 技能 -> symbi mcp（stdio）

适用场景：个人开发者在其工作流中增强治理意识。

模式 B：ORGA 统一托管（运行时优先）

Symbiont 的 CliExecutor 以受治理子进程方式启动 OpenClaw。本技能检测到环境变量 SYMBIONT_MANAGED=true 后，将连接父运行时的 MCP 服务端，而非自行启动新服务。外部 ORGA Gate 提供不可绕过的硬性强制策略执行能力。

Symbiont 运行时（ORGA 循环）
  -> CliExecutor（沙箱 + 预算控制）
    -> OpenClaw（含 symbiont 技能）
      -> 技能回连至父 MCP 服务端

适用场景：自动化流水线、暗工厂部署、企业级治理。

规则

• 执行任何修改文件、运行 Shell 命令或操作 Git 分支的命令前，必须检查 .symbiont/local-policy.toml。
• 必须将所有状态变更类工具调用记录至 .symbiont/audit/tool-usage.jsonl。
• 禁止执行匹配本地策略拒绝列表的命令。
• 禁止向拒绝列表中指定的路径（如 .env、.ssh/、.aws/ 等）写入数据。
• 禁止向受保护分支执行强制推送（force-push）。
• 若环境变量中设置了 SYMBIONT_MANAGED=true，则所有策略决策必须通过 MCP 委托给父 Symbiont 运行时处理。
• 使用 ClawHavoc 扫描技能时，必须拒绝加载存在 Critical 或 High 级别问题的技能。
• 使用 SchemaPin 验证工具时，若工具签名无效或其密钥已被撤销，必须向用户发出警告。

文件约定

与其他 Symbiont 插件对比

相关链接

• Symbiont 文档
• ThirdKey AI
• SchemaPin
• AgentPin
• Claude Code 插件
• Gemini CLI 扩展

许可证

Apache 2.0

免责声明

本项目与 Anthropic PBC、Google LLC 或 OpenClaw 项目无任何隶属、背书或赞助关系。“OpenClaw”和“ClawHub”为其各自所有者的商标。“Symbiont”和“ThirdKey”为 ThirdKey AI 的商标。