AI 与开发

DeskClaw:配置团队代理工作空间

  • 0 次阅读
  • 0 条评论
文章摘要

DeskClaw 将代理、共享信息与工作空间组织在一个平台中,适合为有明确职责的自动化任务建立协作流程。 工作空间把代理角色、共享任务与文件集中在可视界面中。中央信息区用于查看进度和协作内容,各角色再配置模型、工具与职责,使任务交接能够被观察。 原资料展示了办公室视图、角色配置、渠道接入与技能管理等功能。适合多人关注同一批自动化任务的场景,起步时应减少角色和权限,让每个角色的输入输出足够明确。

项目介绍

DeskClaw 将代理、共享信息与工作空间组织在一个平台中,适合为有明确职责的自动化任务建立协作流程。

工作空间把代理角色、共享任务与文件集中在可视界面中。中央信息区用于查看进度和协作内容,各角色再配置模型、工具与职责,使任务交接能够被观察。

原资料展示了办公室视图、角色配置、渠道接入与技能管理等功能。适合多人关注同一批自动化任务的场景,起步时应减少角色和权限,让每个角色的输入输出足够明确。

核心功能

功能 作用与使用方式
工作空间 按项目组织角色、任务与共享资料。
角色配置 为代理选择模型、执行能力与职责。
共享信息 集中查看讨论、状态和文件。
技能管理 为角色选择需要的工作能力。
渠道接入 按版本支持连接团队日常消息渠道。

功能示意

DeskClaw 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目 说明
类型 项目指南
分类 AI 与开发
项目仓库 NoDeskAI/nodeskclaw
整理日期 2026-11-14

安装与运行

本地开发在 Linux/WSL 准备 Node.js、uv、Docker、Compose 和 Git。当前团队版部署路线已切换到 Kubernetes,本地开发使用 dev.sh,旧 Compose 不能当作当前团队版生产部署。

1. 安装和初始化

git clone https://github.com/NoDeskAI/nodeskclaw.git
cd nodeskclaw
if [ ! -e nodeskclaw-backend/.env ]; then
  cp nodeskclaw-backend/.env.example nodeskclaw-backend/.env
  chmod 600 nodeskclaw-backend/.env
  sed -i "s|^JWT_SECRET=.*|JWT_SECRET=$(openssl rand -hex 32)|" nodeskclaw-backend/.env
  sed -i "s|^ENCRYPTION_KEY=.*|ENCRYPTION_KEY=$(openssl rand -base64 32)|" nodeskclaw-backend/.env
fi
./dev.sh --docker-pg

2. 第一次使用

按 dev.sh 输出分别打开 Portal 与 API 地址,完成管理账号初始化,添加自己的模型服务。先建立一个测试空间和一项小任务,检查成员权限和日志。Kubernetes 实例需要从 Pod 访问后台、镜像仓库及模型服务,本机 localhost 地址不能直接交给集群实例使用。

团队生产部署使用仓库 deploy/README.md 的 Namespace、Secret、Ingress 和发布流程。不要把本地开发的数据库、默认管理密码及 .env 直接搬到生产;保存加密密钥,重建环境时继续使用原值以读取已保存的凭据。

常见问题

  • 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
  • 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
  • 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。

更新与备份

更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。

官方资料