clawk是什么:如何给AI编程助手一台专属的一次性Linux虚拟机
clawk是什么:如何给AI编程助手一台专属的一次性Linux虚拟机
clawk 是一个开源工具,它的定位非常直接:给 AI 编程助手(如 Claude Code、Codex)一台专属的一次性 Linux 虚拟机,而不是让它直接在你的电脑上执行命令。你在项目目录里敲一个 clawk 命令,AI 就能在这台隔离的 Linux 沙箱里安装依赖、运行代码、访问网络,而你的文件、密钥串(keychain)和主机系统始终与虚拟机隔绝——即使 AI 把系统"干炸了",销毁重建也只需一条命令。
为什么需要一次性Linux虚拟机?AI编程助手的安全困境
AI 编程助手只有真正"动手"才有价值:安装包、跑代码、起服务、用网络。而在你自己的机器上,你只有两个不尴不尬的选择:
- 每条命令都批准:每隔几秒就盯着一个权限弹窗,效率崩溃;
- 开启
--dangerously-skip-permissions:放手让 AI 跑,然后祈祷它不会有一条rm -rf或一次密钥泄露毁掉你的电脑。
clawk 给出了第三种选择:把 AI 放进一台独立的机器里。隔离边界不是写在提示词里、可能被 AI"说服"的规则,而是一台真正的虚拟机——宿主机文件系统从未挂载,AI 唯一能碰到的,只有你主动挂载进去的东西。
快速上手:3步安装并启动clawk
第一步:安装 clawk
要求 macOS 14+(Apple 芯片)。无需 Docker、无需 qemu、无需 sudo,一条命令搞定:
brew install clawkwork/tap/clawk
如果你不用 Homebrew,也可以从源码构建(需要 Go 1.26+):
git clone https://gitcode.com/gh_mirrors/cl/clawk && cd clawk
make install
第二步:进入项目目录,运行 clawk
这是 clawk 的日常使用场景,一条命令启动沙箱并接入 Claude:
cd ~/code/my-project
clawk # 为当前目录启动沙箱,并接入 claude
clawk run shell # 或进入沙箱内的 shell 自己看看
clawk run codex # 也可以接入其他 agent:codex、pi、opencode 等
首次启动会从你选择的 OCI 镜像(比如 golang:1.25)构建 rootfs,之后每次启动只需几秒——磁盘是写时复制(copy-on-write)克隆,启动时直接引导内核,没有固件、没有安装程序。
第三步:随时离开、随时回来
clawk down # 停止 VM(仓库 + agent 状态保留)
clawk attach # 之后回来:自动启动并重新接入 claude
clawk destroy # 删除 VM(对话历史仍然保留)
如果 AI 把虚拟机搞坏了?clawk destroy && clawk,全新虚拟机、同一个仓库,加上 --resume 恢复对话,损失为零。🔄
核心特性:clawk 为 AI 编程助手做了什么
⚡ 一条命令的全自主工作模式
clawk 启动 agent 时会使用其"外部沙箱"模式(claude 是 --dangerously-skip-permissions、codex 是对应的绕过参数)。在你自己机器上这些参数很危险,在这里它们恰好在点子上:VM 边界 + 网络白名单才是真正的防线,AI 可以全速工作、不被逐条确认打断。如果你仍想要确认提示,加一个 --safe 即可。
🔒 出网默认拒绝:网络白名单机制
每个沙箱拥有独立的出站白名单:DNS 可以解析一切,但 TCP/UDP/ICMP 对未列出的主机一律拒绝。npm、PyPI、crates.io、GitHub 等常用仓库已预置放行。
clawk network allow my-project api.example.com # 放行新域名
clawk network denials my-project # 查看 AI 被拦截的出站尝试
clawk forward add my-project 3000 # 把沙箱内开发服务器映射到本机 localhost:3000
更妙的是 ssh-agent 转发:你的 SSH 私钥从不进入虚拟机,但 git push 依然可用——签名动作发生在宿主机上。
♻️ 可随意销毁:VM 可弃,数据不丢
clawk 只有一条持久化规则:虚拟机是一次性的,你会心疼的东西全在宿主机上。
clawk down |
clawk destroy |
|
|---|---|---|
| 你的代码仓库(挂载的 worktree) | ✅ 保留 | ✅ 保留 |
| Agent 对话记忆(Claude/Codex 等) | ✅ 保留 | ✅ 保留 |
| VM 磁盘(apt 安装、缓存、$HOME) | ❌ 下次启动重建 | ❌ 彻底删除 |
Agent 的 home 目录(~/.claude/ 等)按沙箱挂载在宿主机 ~/.clawk/namespaces/default/state/<name>/ 下,所以重建虚拟机后旧对话依然可用 --resume 恢复。
💤 忘记关掉的沙箱几乎不花钱
空闲的 VM 会自动把内存释放到约 1 GiB,闲置 30 分钟后自动停止;clawk snapshot 还能把整个客户机"休眠"到磁盘,下次启动时恢复到暂停那一刻。多开几个项目沙箱也不会吃光你的内存。
配置指南:用 clawk.mod 定制你的虚拟机
clawk 没有配置文件也能用(默认 2 CPU、4 GiB、内置白名单)。当项目需要更多定制时,在仓库里放一个 clawk.mod 文件即可,语法类似 go.mod:
sandbox my-project (
vm (
cpu 4
memory 8GiB
image golang:1.25 # 任意 OCI 镜像都可作为 rootfs
)
network ( allow api.example.com )
forwards ( 3000 )
env ( DATABASE_URL ) # 从你的 shell 转发环境变量
)
完整参考(共享目录、密钥文件、MCP 服务器、多仓库工作区等)见 docs/configuration.md。
💡 用 Claude Code 的话,先运行
claude setup-token再执行clawk auth set-token,之后每个沙箱启动时都已自动登录,无需/login。详见 docs/claude-auth.md。
clawk 与容器、云沙箱有什么不同?
- vs 容器 / devcontainer:容器共享你的内核,看到"你的文件系统减去拒绝规则",一次挂载失误就可能暴露宿主机;clawk 是独立内核、从未挂载宿主机文件系统,且不需要写 Dockerfile——任何 OCI 镜像都是 rootfs。
- vs OS 级 agent 沙箱:那是在你真实机器上施加进程级护栏,一条策略失误(连 keychain 一起)就全暴露;clawk 把整个工作负载搬到了另一台机器上。
- vs 云沙箱:clawk 本地优先——代码永远不出你的机器、不按小时计费,AI 编辑的 worktree 就是你编辑器里打开的那份。
完整的架构与取舍逻辑可以看 ARCHITECTURE.md 和 DESIGN.md。
常见问题(FAQ)
🤔 需要装 Docker 吗? 不需要。clawk 自己拉取 OCI 镜像并构建可启动磁盘,Docker 引擎完全不参与(Docker 镜像只是输入格式)。
🖥️ 支持 Windows 或 Intel Mac 吗? 不支持。macOS 需要 Apple 芯片(macOS 14+);Linux 通过 firecracker 支持但仍是实验性,入门请看 docs/linux-quickstart.md。
📚 有哪些常用命令?
clawk list / clawk status 查看状态,clawk up / clawk down 启停,clawk pause / clawk resume 内存中挂起与恢复,clawk snapshot 休眠到磁盘。全部命令说明见 docs/commands.md。
🎫 跨多个仓库的工单能处理吗?
能。在一个列出多个仓库的 clawk.mod 工作区里运行 clawk work INFRA-123,会为每个仓库创建 git worktree 和新分支,之后 clawk pr INFRA-123 一次为所有仓库推送并开互相关联的 PR。详见 docs/ticket-mode.md。
总结
clawk 解决的是 AI 编程时代一个很实际的问题:如何让 AI 真正放手干活,又不把你的电脑当赌注。它的答案是"再给 AI 一台机器"——一次性、可销毁、网络白名单隔离,你的代码和密钥始终留在宿主机。一条 clawk 命令,AI 编程助手就有了自己的 Linux 工作站,而你的笔记本电脑安然无恙。🦞
