ZeroClaw Docker部署指南一条命令打造生产级AI助手容器环境【免费下载链接】zeroclawFast, small, and fully autonomous AI assistant infrastructure — deploy anywhere, swap anything 项目地址: https://gitcode.com/gh_mirrors/zer/zeroclawZeroClaw是一款用 Rust 编写、快速且完全自治的 AI 助手基础设施框架。通过ZeroClaw Docker 部署你可以用一条命令将这套轻量级 AI 助手容器化获得隔离、可移植、生产级可用的运行环境支持任意硬件与任意 LLM 提供商真正做到随处部署、随意替换。本指南面向新手全程只需 3 步即可完成容器化部署。 为什么选择 Docker 部署 ZeroClaw很多新手担心容器化会引入复杂依赖。ZeroClaw 天生适合容器化因为它只有一个单二进制运行时优势说明 极低资源占用发布版仅需几 MB 内存比同类方案节省 99% 内存⚡ 冷启动极快单一 Rust 二进制网关与守护进程秒级启动 环境隔离配置与工作区统一挂载到容器内/zeroclaw-data不污染宿主机 生产级镜像官方 Dockerfile 采用多阶段构建生产阶段基于 distroless 无 root 镜像攻击面极小✅ 部署前准备环境要求清单开始之前请确认你的机器满足以下条件详见 docs/docker-setup.md已安装Docker或Podman已安装Git一个 LLM 提供商的 API Key如 OpenRouter、OpenAI、Anthropic或本地 Ollama 快速开始三步完成 ZeroClaw 容器化部署第 1 步克隆仓库并启动 Docker 模式git clone https://gitcode.com/gh_mirrors/zer/zeroclaw cd zeroclaw # 一条命令构建 Docker 镜像并准备数据目录 ./bootstrap.sh --docker./bootstrap.sh实际会转发到 zeroclaw_install.sh完成镜像构建与数据目录初始化。注意此步骤只构建镜像不会自动启动容器。 提示若想使用 Podman只需设置环境变量ZEROCLAW_CONTAINER_CLIpodman即可无缝切换。第 2 步运行 Onboarding 引导配置首次使用需要配置 API Key 与默认模型推荐交互式引导./zeroclaw_install.sh --docker --interactive-onboard如果已有 API Key也可以非交互一条命令完成./zeroclaw_install.sh --docker --api-key sk-... --provider openrouter第 3 步以后台守护进程启动# 启动后台守护容器 ./zeroclaw_install.sh --docker --docker-daemon # 实时查看日志 docker logs -f zeroclaw-daemon # 停止守护进程 docker rm -f zeroclaw-daemon启动后网关默认监听容器端口42617提供 Web 控制台与 API 服务实现位于 src/gateway/mod.rs。 进阶玩法Docker Compose 一键启动推荐生产环境项目根目录自带了一份生产就绪的 docker-compose.yml包含资源限制2 核 CPU / 2G 内存上限与健康检查每 60 秒执行zeroclaw status。使用方式# 1. 复制并填入你的 API Key 到 .env echo API_KEYsk-你的密钥 .env # 2. 一键拉起 docker compose up -d该 Compose 文件的关键设计数据持久化工作区与配置统一挂载到命名卷zeroclaw-data→ 容器内/zeroclaw-data端口映射${HOST_PORT:-42617}:42617宿主端口被占用时可直接覆盖自动重启restart: unless-stopped宕机自动恢复 数据持久化与配置说明Docker 模式下数据默认存放在目录用途~/.zeroclaw-docker/.zeroclaw/配置文件config.toml 等~/.zeroclaw-docker/workspace/Agent 工作区文件常用环境变量速查完整文档见 docs/docker-setup.md变量作用默认值ZEROCLAW_DOCKER_DATA_DIR数据目录路径~/.zeroclaw-dockerZEROCLAW_DOCKER_IMAGE镜像名称zeroclaw-bootstrap:localZEROCLAW_CONTAINER_CLI容器引擎docker/podmandockerZEROCLAW_DOCKER_DAEMON_NAME守护容器名zeroclaw-daemon如果已有现成的config.toml可在引导时直接预置无需二次配置./bootstrap.sh --docker --docker-config ./my-config.toml完整配置项参考 docs/config-reference.md。️ 日常运维常用命令速查表任务命令启动守护进程./zeroclaw_install.sh --docker --docker-daemon查看守护日志docker logs -f zeroclaw-daemon停止守护进程docker rm -f zeroclaw-daemon运行一次性任务docker run --rm -it ... zeroclaw agent -m 你好交互式 CLIdocker run --rm -it ... zeroclaw agent检查运行状态docker run --rm -it ... zeroclaw status一键重置环境./bootstrap.sh --docker --docker-reset其中...代表两个数据卷挂载参数见上文 Onboarding 后的交互式示例完整命令列表见 docs/docker-setup.md。❓ 常见问题排查Q1宿主机执行zeroclaw提示 command not foundDocker 模式下 ZeroClaw 只存在于容器内不能直接在宿主机运行。所有命令都要通过docker run进入容器执行docker run --rm -it \ -v ~/.zeroclaw-docker/.zeroclaw:/home/claw/.zeroclaw \ -v ~/.zeroclaw-docker/workspace:/workspace \ zeroclaw-bootstrap:local \ zeroclaw agentQ2bootstrap 之后没有容器在运行./bootstrap.sh --docker只负责构建镜像与初始化数据目录。需再执行 Onboarding第 2 步与启动守护进程第 3 步后容器才会启动。Q3容器启动失败优先查看日志docker logs zeroclaw-daemon。最常见原因是缺少 API Key——重新用--api-key运行 Onboarding或直接编辑容器内config.toml。️ 深入了解ZeroClaw 容器运行时是怎么设计的ZeroClaw 的 Dockerfile 采用三阶段多阶段构建这也是它被称为生产级的原因builder 阶段基于 Rust 官方镜像编译发布版二进制并利用 BuildKit 缓存加速dev 阶段Debian slim bash/curl方便调试默认对接本地 Ollamarelease 阶段distroless 无 root 最小化镜像仅含二进制与默认配置以非 root 用户UID 65534运行。所有核心能力Provider、Channel、工具、记忆、隧道都是可插拔 trait容器内只需通过环境变量或config.toml即可切换底层 LLM无需重新构建镜像。若你希望为 Agent 提供更严格的命令沙箱可参考 docs/sandboxing.md 了解 Firejail / Bubblewrap / Docker 三种隔离后端开发调试场景还有现成的 dev/docker-compose.yml 双容器沙箱环境Agent 模拟用户机通过./dev/cli.sh up一键拉起详细说明见 dev/README.md。 总结步骤命令耗时1️⃣ 构建镜像./bootstrap.sh --docker首次约数分钟2️⃣ 引导配置./zeroclaw_install.sh --docker --interactive-onboard1 分钟3️⃣ 启动服务./zeroclaw_install.sh --docker --docker-daemon秒级ZeroClaw Docker 部署的真正价值在于一条命令隔离出生产级 AI 助手环境数据持久化、健康检查、资源限制全部开箱即用。从本地笔记本到云端实例、从树莓派到服务器同一套配置即可迁移运行——这正是Deploy anywhere, swap anything的精髓所在。【免费下载链接】zeroclawFast, small, and fully autonomous AI assistant infrastructure — deploy anywhere, swap anything 项目地址: https://gitcode.com/gh_mirrors/zer/zeroclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考