G.workspace

Data & APIs

G.workspace — 群共享文件空间插件。通过 OpenClaw 插件注册 Discord 斜杠命令(/ws_create, /ws_files 等),代理到 G.workspace REST API。单 bot 架构,无冲突。包含插件源码,安装后需手动部署到 extensions 目录。

Install

openclaw skills install gworkspace

G.workspace Plugin

为 Discord 服务器提供共享文件空间,支持文件管理、版本控制、批注审阅。

架构

用户 ←→ Discord ←→ OpenClaw (插件处理斜杠命令) ←→ G.workspace REST API (localhost:3080)
  • OpenClaw 插件:注册 12 个 /ws_* 斜杠命令 + 5 个 AI tools
  • G.workspace 服务:Web-only 模式运行,提供 REST API 和 Web 界面
  • 单 Bot:所有 Discord 交互通过 OpenClaw 的 bot 处理,不需要额外 bot

安装步骤

1. 部署 G.workspace 后端

git clone https://github.com/gworkspace/gworkspace.git ~/Workspace
cd ~/Workspace
npm install

配置 .env

# G.workspace Web-only 模式(不连 Discord)
DISCORD_TOKEN=
DISCORD_CLIENT_ID=
DISCORD_BOT_TOKEN=
PORT=3080
BASE_URL=http://localhost:3080
DATA_DIR=./data

启动:

node src/index.js

2. 安装 OpenClaw 插件

plugin/ 目录复制到 OpenClaw extensions:

cp -r plugin/ ~/.openclaw/extensions/gworkspace/

openclaw.json 中启用:

{
  "plugins": {
    "entries": {
      "gworkspace": {
        "enabled": true,
        "config": { "port": 3080 }
      }
    },
    "allow": ["gworkspace"],
    "installs": {
      "gworkspace": {
        "source": "path",
        "sourcePath": "~/.openclaw/extensions/gworkspace",
        "installPath": "~/.openclaw/extensions/gworkspace",
        "version": "3.1.0"
      }
    }
  }
}

重启 OpenClaw 即可。

斜杠命令

命令说明
/ws_create [name]创建群共享文件空间(已有空间时弹出确认按钮)
/ws_info查看空间信息和统计
/ws_files [folder]查看文件列表
/ws_file <filename>查看文件详情
/ws_search <keyword>搜索文件
/ws_delete <filename>删除文件(移入回收站)
/ws_versions <filename>查看版本历史
/ws_ref <filename>生成文件引用链接
/ws_upload获取上传链接
/ws_trash [action] [filename]管理回收站
/ws_invite获取空间访问链接
/ws_members查看成员列表

AI Tools

插件同时注册 5 个 AI tools,供 agent 在对话中使用:

  • gworkspace_files — 列出文件
  • gworkspace_create — 创建空间
  • gworkspace_tasks — 获取批注任务
  • gworkspace_claim_task — 认领任务
  • gworkspace_complete_task — 完成任务

注意事项

  • G.workspace 必须在本地运行(默认 localhost:3080)
  • 插件通过 REST API 与 G.workspace 通信,不直接连接 Discord
  • 不要同时让 G.workspace 后端连接 Discord(设置 DISCORD_TOKEN= 为空)