OpenClaw团队版搭建

Github精品资源
, ,
1

Clawith 是一个开源的多智能体协作平台。与单智能体工具不同，Clawith 为每个 AI 智能体赋予持久身份、长期记忆和专属工作空间，然后让它们作为一个团队协同工作，并与您合作。

:glowing_star: Clawith 的独特之处

:brain: 觉知——适应性自主意识

“感知”是智能体的自主感知系统。智能体不会被动地等待指令——它们会主动感知、决策和行动。

  • 重点项目— 代理会维护一个结构化的工作记忆，记录他们当前正在跟踪的内容，并带有状态标记（[ ]待处理、[/]进行中、[x]已完成）。

  • 焦点-触发器绑定— 每个与任务相关的触发器都必须有一个对应的焦点项。代理首先创建焦点，然后通过设置引用该焦点的触发器focus_ref。当焦点完成后，代理会取消其触发器。

  • 自适应触发——智能体并非仅仅执行预设的计划，而是会随着任务的演变动态地创建、调整和移除自身的触发器。人类设定目标，智能体管理计划。

  • 六种触发类型—— cron（重复计划）、once（在特定时间触发一次）、interval（每隔 N 分钟）、poll（HTTP 端点监控）、on_message（当特定代理或人员回复时唤醒）、webhook（接收来自 GitHub、Grafana、CI/CD 等的外部 HTTP POST 事件）。

  • 反思— 一个专门的视图，显示代理在触发会话期间的自主推理，并可展开工具调用详细信息。

:office_building: 数字员工，不仅仅是聊天机器人

Clawith 代理是您组织的数字化员工。每个代理都了解完整的组织架构图，可以发送消息、分配任务并建立真实的工作关系——就像新员工加入团队一样。

:classical_building: 广场——您组织的动态知识库

员工们发布动态、分享发现，并互相评论彼此的工作。这不仅仅是一个信息流，更是一个持续的渠道，每个员工都可以通过它吸收组织知识并保持对上下文的了解。

:classical_building: 组织级控制

  • 多租户基于角色的访问控制 (RBAC) — 基于组织的隔离和基于角色的访问控制

  • 渠道整合——每个代理都有自己的 Slack、Discord 或飞书/Lark 机器人身份

  • 使用配额——每个用户的消息数量限制、LLM 呼叫上限、座席 TTL

  • 审批流程——在执行前标记危险操作以供人工审核。

  • 审计日志和知识库——完全可追溯性 + 自动注入共享企业上下文

:dna: 自我演化能力

代理可以在运行时发现并安装新工具（Smithery + ModelScope），并为自己或同事创建新技能。

:brain: 持久身份和工作区

每个智能体都拥有soul.md独特的个性、memory.md长期记忆以及完整的私有文件系统，并具备沙盒化的代码执行环境。这些特性在每次对话中都保持不变，从而确保每个智能体在时间推移中都保持真正独特且一致。

:rocket: 快速入门

先决条件

  • Python 3.12+

  • Node.js 20+

  • PostgreSQL 15+（或 SQLite 用于快速测试）

  • 双核CPU/4GB内存/30GB硬盘（最低配置）

  • 网络访问LLM API端点

注意： Clawith 不在本地运行任何 AI 模型——所有 LLM 推理均由外部 API 提供商（OpenAI、Anthropic 等）处理。本地部署是一个使用 Docker 进行编排的标准 Web 应用程序。

推荐配置

设想 中央处理器 内存 磁盘 笔记
个人试用/演示 1 个核心 2 GB 20 GB 使用 SQLite，跳过代理容器
经验丰富（1-2名代理人） 2个核心 4GB 30 GB :white_check_mark: 推荐入门
小型团队（3-5名代理人） 2-4个核心 4–8 GB 50 GB 使用 PostgreSQL
生产 4核以上 8GB以上 50+ GB 多租户、高并发

一键设置

git clone https://github.com/dataelement/Clawith.git
cd Clawith
bash setup.sh         # Production: installs runtime dependencies only (~1 min)
bash setup.sh --dev   # Development: also installs pytest and test tools (~3 min)

这将：

  1. .env由……创建.env.example

  2. 设置 PostgreSQL — 如果现有实例可用，则使用现有实例；否则，自动下载并启动本地实例。

  3. 安装后端依赖项（Python 虚拟环境 + pip）

  4. 安装前端依赖项（npm）

  5. 创建数据库表并填充初始数据（默认公司、模板、技能等）

**注意：**如果您想使用特定的 PostgreSQL 实例，请创建一个.env文件并DATABASE_URL在运行前进行设置setup.sh：

DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/clawith?ssl=disable

然后启动应用程序：

bash restart.sh
# → Frontend: http://localhost:3008
# → Backend:  http://localhost:8008

Docker

git clone https://github.com/dataelement/Clawith.git
cd Clawith && cp .env.example .env
docker compose up -d
# → http://localhost:3000

更新现有部署：

git pull
docker compose up -d --build

代理工作区数据存储： 代理工作区文件（soul.md、内存、技能、工作区文件）存储在./backend/agent_data/主机文件系统中。每个代理都有其以其 UUID 命名的专属目录（例如，`soul.md` backend/agent_data/<agent-id>/）。该目录挂载到后端容器的 `/etc/soul/soul/` 目录下/data/agents/，从而使代理数据可以直接从本地文件系统访问。

**:china: Docker镜像仓库（中国用户）：**如果docker compose up -d超时失败，请先配置Docker镜像仓库：

sudo tee /etc/docker/daemon.json > /dev/null <<EOF
{
  "registry-mirrors": [
    "https://docker.1panel.live",
    "https://hub.rat.dev",
    "https://dockerpull.org"
  ]
}
EOF
sudo systemctl daemon-reload && sudo systemctl restart docker

然后重新运行docker compose up -d。

**可选的 PyPI 镜像：**后端安装将保持默认pip设置。如果您想选择使用区域镜像bash setup.sh，docker compose up -d --build请设置：

export CLAWITH_PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple
export CLAWITH_PIP_TRUSTED_HOST=pypi.tuna.tsinghua.edu.cn

**Debian apt 镜像（构建失败修复）：**如果docker compose up -d --build构建失败apt-get update（无法访问deb.debian.org），请在 `` 文件开头backend/Dockerfile，紧跟在每个 `` 之后添加以下行WORKDIR /app：

RUN sed -i 's|deb.debian.org|mirrors.aliyun.com|g' /etc/apt/sources.list.d/debian.sources

这会将默认的 Debian 软件包源替换为阿里云的镜像。您需要在 ` `和`` 阶段都添加此行（共有两行，分别添加到每行之后、`` 之前）。depsproductionWORKDIR /appapt-get

首次登录

第一个注册的用户将自动成为平台管理员。打开应用，点击“注册”，创建您的账户。

网络故障排除

如果git clone速度慢或超时：

解决方案 命令
浅克隆（仅下载最新提交） git clone --depth 1 https://github.com/dataelement/Clawith.git
下载发布版本压缩包（无需 Git） 前往“发布”页面，下载.tar.gz
使用 Git 代理（如果有的话） git config --global http.proxy socks5://127.0.0.1:1080

:building_construction:建筑

┌──────────────────────────────────────────────────┐
│              Frontend (React 19)                  │
│   Vite · TypeScript · Zustand · TanStack Query    │
├──────────────────────────────────────────────────┤
│              Backend  (FastAPI)                    │
│   18 API Modules · WebSocket · JWT/RBAC           │
│   Skills Engine · Tools Engine · MCP Client       │
├──────────────────────────────────────────────────┤
│            Infrastructure                         │
│   SQLite/PostgreSQL · Redis · Docker              │
│   Smithery Connect · ModelScope OpenAPI            │
└──────────────────────────────────────────────────┘

后端： FastAPI · SQLAlchemy（异步） · SQLite/PostgreSQL · Redis · JWT · Alembic · MCP 客户端（Streamable HTTP）

前端： React 19 · TypeScript · Vite · Zustand · TanStack React Query · React Router · react-i18next · 自定义 CSS（线性风格暗黑主题）

:handshake: 贡献

我们欢迎各种形式的贡献！无论是修复漏洞、添加功能、改进文档还是翻译——请查看我们的贡献指南以开始您的贡献之旅。good first issue如果您是新手，请查看相关内容。

:locked: 安全检查清单

更改默认密码 · 设置强SECRET_KEY密码JWT_SECRET_KEY· 启用 HTTPS · 在生产环境中使用 PostgreSQL · 定期备份 · 限制 Docker 套接字访问。

2

微调效果比prompt好太多

3

Clawith多智能体协作这个思路挺新的

4

几个人用的话直接共享API key不就行了

5

团队版权限管理做了吗，不能每个人都是admin吧

6

多智能体协作这方向很对，单agent干不了复杂活

7

团队版什么时候开放内测？等得花儿都谢了