Claw Code 套件（纯 Python 版）

版本：1.0.1 — 清洁、符合安全扫描器规范的版本

Claw Code 工程项目与 OpenClaw 的纯 Python 集成实现。本技能提供对 184 个工具 和 207 条命令 的结构化访问，全部镜像自原始 TypeScript 实现，涵盖安全分析、代码质量检测、开发工作流及智能体编排模式。

🔒 安全性与透明度保障

本版本已通过 审计与验证，确认包含以下特性：

• ✅ 无网络访问能力 — 不含任何 HTTP 客户端、Web 服务器或外部 API 调用
• ✅ 无需凭据 — 不依赖 API 密钥、OAuth 或任意身份认证令牌
• ✅ 无后台守护进程 — 不运行持久化进程，不绑定任何端口
• ✅ 禁止任意代码执行 — 仅允许白名单中明确列出的工具与命令
• ✅ 完全离线运行 — 所有分析均在本地机器上完成
• ✅ 源码完全公开可查 — 所有 Python 源代码均已包含且可直接审查

快速入门

安装完成后，该技能暴露若干高层级命令：

# 获取系统概览
./run.sh summary

# 列出可用工具（前 10 个）
./run.sh tools --limit 10

# 列出可用命令（前 10 个）
./run.sh commands --limit 10

# 根据提示词路由匹配的工具/命令
./run.sh route --prompt "分析 Bash 脚本的安全问题" --limit 5

# 执行指定工具（例如 bashSecurity）
./run.sh exec-tool --name bashSecurity --payload "#!/bin/bashnecho test"

# 执行指定命令
./run.sh exec-command --name advisor --prompt "审查此代码"

可用能力

工具分类

• 安全分析：bashSecurity、powershellSecurity 等
• 代码质量：各类代码分析与 lint 工具
• 开发工作流：构建、测试、部署自动化
• 智能体编排：AgentTool、forkSubagent、runAgent 等
• UI 组件：UI、agentDisplay、agentColorManager
• 内存与状态管理：agentMemory、agentMemorySnapshot

命令分类

• 执行类命令：exec-command、exec-tool
• 路由与发现类命令：route、show-command、show-tool
• 会话管理类命令：load-session、flush-transcript
• 运行时模式类命令：remote-mode、ssh-mode、teleport-mode（仅占位符）
• 分析与报告类命令：summary、manifest、parity-audit

工作原理

1. 纯 Python 实现：整个技能完全基于 Python 运行，除 Python 3 外无任何外部依赖。
2. 框架封装器：claw_harness.py 提供面向生产环境的 Python 封装层，封装了 Claw Code 的洁净室移植版本。
3. 增强型封装器：claw_harness_enhanced.py 支持扩展后的完整命令集，并支持位置参数。
4. 结构化执行：所有命令均具备超时控制、输出长度限制，并以结构化 JSON 格式返回结果。
5. 安全沙箱机制：通过命令与参数白名单机制，杜绝任意代码执行风险。
6. 纯本地执行：所有操作均在本地完成，不发起任何网络调用。

集成示例

安全分析

# 分析 Bash 脚本
./run.sh exec-tool --name bashSecurity --payload "$(cat script.sh)"

# 分析 PowerShell 脚本
./run.sh exec-tool --name powershellSecurity --payload "$(cat script.ps1)"

代码审查

# 路由代码审查请求
./run.sh route --prompt "审查该 Python 函数是否存在缺陷" --limit 5

# 使用 advisor 命令
./run.sh exec-command --name advisor --prompt "审查该 API 接口是否存在安全问题"

智能体编排

# 启动智能体会话（本地模拟）
./run.sh exec-tool --name runAgent --payload "探索当前目录结构"

# 派生子智能体执行特定任务
./run.sh exec-tool --name forkSubagent --payload "为模块 X 编写单元测试"

配置

环境变量（可选）：

• CLAW_CODE_WORKSPACE：claw-code 仓库路径（默认：./claw-code）
• CLAW_CODE_TIMEOUT_SEC：命令超时时间（单位：秒，默认：120）
• CLAW_CODE_MAX_OUTPUT_CHARS：最大输出字符数（默认：25000）
• CLAW_CODE_EVENT_LOG：事件日志文件路径

技能结构

claw-code-suite/
├── SKILL.md                    # 本文件
├── run.sh                      # 主入口脚本
├── claw_harness.py             # 原始生产级封装器（支持 6 条命令）
├── claw_harness_enhanced.py    # 增强型封装器（支持完整命令集）
├── claw_wrapper.py             # Python 适配器
├── scripts/
│   └── claw_wrapper.py         # 核心 Python 封装器
├── claw-code/                  # Claw Code 的 Python 移植版（完整、洁净）
│   ├── src/                    # Python 源码（含 184 个工具、207 条命令）
│   ├── tests/                  # 测试套件
│   └── telemetry/              # 事件日志
├── capability_index.json       # 工具/命令清单索引
└── package.json                # Node.js 元数据

安全性验证

验证本技能不含任何网络相关代码：

# 检查 Python 源码中是否存在网络相关导入
find . -name "*.py" -exec grep -l "requests|http.client|urllib|socket" {} ;

# 检查 Rust/Cargo 相关文件（应为空）
find . -name "*.rs" -o -name "Cargo.*" -o -name "*.toml"

# 检查服务器/端口绑定相关代码
find . -name "*.py" -exec grep -l "server|bind|listen|port" {} ;

更新日志

v1.0.1（2026-04-06）

• 安全修复：移除全部 Rust 工作区（api/、server/、runtime/ 等）
• 透明度提升：更新文档，准确反映其纯 Python 属性
• 验证强化：彻底移除所有网络、服务器及 AI 服务提供商相关代码
• 合规性达标：现已可通过 ClawHub 安全扫描器检查，无任何告警项
• 功能完整性：全部 184 个工具与 207 条命令仍保持完全可用

v1.0.0（2026-04-01）

• 初始发布，包含完整的 Claw Code Python 移植版本
• 附带 Rust 工作区（v1.0.1 中为安全起见已移除）

高级用法

直接使用 Python API

import sys
sys.path.append(".")
from claw_harness_enhanced import claw_invoke, claw_exec_tool
import asyncio

async def main():
    result = await claw_exec_tool("bashSecurity", "#!/bin/bashnecho test")
    print(result)

asyncio.run(main())

直接调用增强型封装器

python3 -c "
import asyncio
from claw_harness_enhanced import claw_route
result = asyncio.run(claw_route('security audit', 3))
print(result)
"

开发说明

本技能基于 Claw Code 的 Python 移植版本构建，该版本完整镜像了原始 TypeScript 实现中的 184 个工具与 207 条命令，在保持功能一致性的同时，提供了简洁、清晰的 Python API。

如需扩展或修改功能，请按以下步骤操作：

1. 编辑 claw_harness_enhanced.py，从 src/main.py 中暴露更多命令
2. 更新封装器中的 COMMAND_DEFS
3. 使用 ./run.sh --summary 进行功能验证

许可证

Claw Code 遵循其原始许可证条款。本集成技能按“现状”提供，专供 OpenClaw 用户使用。

支持渠道

• GitHub：https://github.com/instructkr/claw-code
• OpenClaw Discord：https://discord.com/invite/clawd
• ClawHub：https://clawhub.ai