ZeroClaw安装部署全记录：本地安装踩了一堆坑，分享给后来人

OpenClaw交流
, , ,
1

花了一个下午把ZeroClaw装好了，过程不算顺利，记录一下踩的坑分享给大家。

我的环境：Ubuntu 22.04，Python 3.11，8G内存

坑1：Python版本问题
ZeroClaw要求Python 3.10+，但我系统默认装的是3.8，直接pip install报了一堆语法错误。后来用pyenv装了3.11才解决。

坑2：依赖冲突
装的时候和我本地的numpy版本冲突了，建议大家用虚拟环境（venv或conda），别污染全局Python。

坑3：API Key配置
第一次运行不知道Key填哪，文档没写清楚。后来发现是创建一个.env文件放在项目根目录……

有没有其他人也遇到类似问题的？分享一下你们的解决方案吧

2

遇到过一模一样的问题！Python版本那个真的是新手大坑。建议用conda创建一个干净环境：

conda create -n zeroclaw python=3.11
conda activate zeroclaw
pip install zeroclaw

三行搞定，不会污染系统环境。

3

Docker部署是最省事的，分享一下我的docker-compose：

version: '3.8'
services:
  zeroclaw:
    image: zeroclaw/zeroclaw:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:7860:7860"
    environment:
      - OPENAI_API_KEY=你的Key
      - ZEROCLAW_WORKERS=2
    volumes:
      - ./data:/app/data

跑一下 docker compose up -d 就完事了。环境隔离、版本管理、重启策略全在里面，比裸装省心太多。

不过Docker方式有个缺点：调试不方便，如果你想改源码二次开发，还是建议本地安装。

4

分享个冷门坑：ZeroClaw默认日志级别是WARNING，新手出了问题看不到有用信息。在.env里加一行 LOG_LEVEL=DEBUG，排查问题快很多。

另外建议装完之后跑一下自带的测试用例验证环境没问题：

zeroclaw test

会做一个简单的Agent调用，通过了说明环境OK。

5

我选择了最简单的方式——不自己装，直接用Molili​:joy:

不是说ZeroClaw不好，而是对我这种不想折腾环境的人来说，Molili那种装完就能用的体验太舒服了。当贝把OpenClaw的那套东西包装得很好，开箱即用，还自带优化过的模型调用（词元消耗低50%），适合懒人。

当然如果你是想学习AI Agent原理或者做二次开发，ZeroClaw的代码质量很高，值得研究。

6

楼上那个Docker方案我用了，确实省事:+1:

额外补充：如果服务器在国内，OPENAI_API_KEY可以换成DeepSeek的，在.env里多加一行：

OPENAI_API_BASE=https://api.deepseek.com/v1

ZeroClaw兼容OpenAI的API格式，换国产模型很简单。

7

感谢大家的分享！我按Docker方案重新部署了，确实比裸装舒服。

总结一下安装建议：

  • 怕折腾 → Docker一把梭
  • 想学习 → 本地venv/conda安装
  • 完全不想折腾 → 直接用Molili

三条路都能走通:+1: