研究搜索 birdxs zeroclaw 怎么用compose部署

作者
68 次阅读

本文最后更新于 2026年5月23日。

经过对 birdxs/zeroclaw（这是目前社区公认最适合低配服务器的 OpenClaw 兼容实现）的研究，它的核心优势在于使用 Go 语言 编写，天生比 Node.js 版本更省内存。

对于你的 1C1G 服务器，使用 docker-compose 部署是最明智的，因为它可以限制资源配额，防止程序跑飞导致 SSH 断开。

1. 极简 Docker Compose 部署步骤

在你的服务器上创建一个目录并进入：

Bash

mkdir zeroclaw && cd zeroclaw
nano docker-compose.yml

将以下配置粘贴进去（已针对 1C1G 优化）：

YAML

services:
  zeroclaw:
    image: birdxs/zeroclaw:latest
    container_name: zeroclaw
    ports:
      - "8080:8080"  # 映射 API 端口
    volumes:
      - ./config.yaml:/app/config.yaml  # 映射配置文件
      - ./data:/app/data                # 持久化数据
    restart: always
    deploy:
      resources:
        limits:
          memory: 256M  # 严格限制 256MB，给系统留 700MB+ 呼吸空间
    logging:
      driver: "json-file"
      options:
        max-size: "10m" # 防止日志撑爆 1C1G 小硬盘

2. 核心配置文件 config.yaml

在同一目录下创建 config.yaml。ZeroClaw 的运行完全依赖这个文件。

YAML

server:
  addr: ":8080"
  token: "你的管理Token" # 用于保护 API 访问

# 关键：1C1G 建议只启用 1-2 个核心 Skill
skills:
  - name: "search"
    enabled: true
  - name: "shell"
    enabled: false # 单核服务器不建议开这个，容易卡死

# 推荐使用 GPT-4o-mini 或 DeepSeek，推理成本低且快
llm:
  provider: "openai" 
  base_url: "https://api.openai.com/v1"
  api_key: "sk-xxxxxx"
  model: "gpt-4o-mini"

3. 启动与验证

执行以下命令启动：

Bash

docker compose up -d

检查内存占用：

Bash

docker stats zeroclaw

你会惊喜地发现，在静默状态下，birdxs/zeroclaw 的内存占用通常在 30MB – 60MB 左右，这对于 1G 内存的机器来说非常安全。

4. 1C1G 避坑指南（针对 birdxs 版本）

  • 避开浏览器插件： 绝对不要启用任何需要 Playwright 或 Puppeteer 的插件（如网页截图、自动填表）。这类插件启动时会吃掉 500MB+ 内存，你的服务器会瞬间宕机。

  • 并发限制： 如果你打算把这个接口对接给很多人用，建议在 Compose 里增加 CPU 限制 cpus: '0.5'，防止高并发搜索时 CPU 占用 100% 导致服务器失联。