简单部署你的 Zeroclaw with Docker 喂饭版

前言

正如前文所言，值得体验一把的是 Zeroclaw ，虽然推荐版本为 v0.3.2 但随着社区 BUG 修复，后面也值得更新。各种客制化适合给更高自由度的玩家，于是基础要义是自行构建镜像（不包源码修改）。

DockerfIle

基于官方 DockerfIle 移除源码构建部分，在线拉取最新 lastest 版本，仅配置运行时环境，快速，全面。中英混搭，原汁原味 + 国区风味（懒）

FROM debian:trixie-slim AS runtime

# 清华源
RUN sed -i 's/deb.debian.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list.d/debian.sources

# Install essential tools for agent shell operations
RUN apt-get update && apt-get install -y --no-install-recommends \
        bash \
        ca-certificates \
        curl \
        git \
        wget iputils-ping \
        python3 python3-pip build-essential \
    && rm -rf /var/lib/apt/lists/*

# Install uv and symlink to system path
RUN curl -LsSf https://astral.sh/uv/install.sh | sh && \
  ln -s /root/.local/bin/uv /usr/local/bin/uv && \
  ln -s /root/.local/bin/uvx /usr/local/bin/uvx && \
  uv --version

# 强制移除 python 外部环境管理限制，允许模型自由使用 pip
RUN rm -f /usr/lib/python3*/EXTERNALLY-MANAGED && ln -sf $(which python3) /usr/bin/python

# Copy binary 下载二进制文件放在当前目录
COPY ./zeroclaw-aarch64/zeroclaw /usr/local/bin/zeroclaw

# Environment setup
# Ensure UTF-8 locale so CJK / multibyte input is handled correctly
ENV LANG=C.UTF-8
ENV ZEROCLAW_WORKSPACE=/zeroclaw-data/workspace
ENV HOME=/zeroclaw-data
# Default provider and model are set in config.toml, not here,
# so config file edits are not silently overridden
ENV ZEROCLAW_GATEWAY_PORT=42617

# API_KEY must be provided at runtime!

# 同时启动 gateway 与 daemon
COPY entrypoint.sh /usr/local/bin/entrypoint.sh
RUN chmod +x /usr/local/bin/entrypoint.sh

WORKDIR /zeroclaw-data
USER 65534:65534
EXPOSE 42617
EXPOSE 42618
ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

对于国区玩家，解决痛点如下：

1、网络问题对应的容器的 Linux 源（RUN sed -i）与构建 PROXY（见 deploy.sh）。

2、各种 skill 工具需要的必不可少的 Python 环境，可在 RUN apt-get 处自由添加。

3、容器最好直接支持 gateway （ port: 42617）与 一个单独的 channel（比如 QQ 机器人, port: 42618），见 entrypoint.sh，可继续自由添加，同步端口暴露即可。

使用方法：

• 参数配置：根据需求编辑 config.toml 文件。
• 路径设置：查找所有出现的 /your/docker_data/（涉及 zeroclaw.yml 和 deploy.sh 文件），并将其替换为实际的数据路径。
• 科学设置：确保科学网络运行在 7890 端口（构建参数 build-arg 所需），或者从 deploy.sh 中移除相关配置。

然后：

chmod +x deploy.sh
./deploy.sh

使用效果：

注：此处默认配置拉高了所有工具权限，放开了大多数束缚包括调用限额，仅限本地模型进行放纵 Play，否则后果将非常严重。

总之，主要源码就这么点，代码开源。

版本问题

实测 0.6.x 依旧不值得更新，文件权限/网络/config 配置无效等问题，最终连 Tools xml 结构都无法解析，依旧还需要大量时间经过社区验证，简直废品。

可选我客制化的 v0.3.2 究极缝合怪，特性：保持最新、放开最大网络权限、默认中文 Web 以及小问题修复（仅 Arm 64）。

使用：直接执行 deploy-stable.sh 脚本即可。

资源

后续

废弃该库转向使用 AstrBot，见：抛弃 Zeroclaw 选择 AstrBot，简单易用，不过前提是不在意内存

以上。