G.workspace Plugin#

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

架构#

text

用户 ←→ 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 后端#

bash

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

配置 .env：

env

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

启动：

bash

node src/index.js

2. 安装 OpenClaw 插件#

将 plugin/ 目录复制到 OpenClaw extensions：

bash

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

在 openclaw.json 中启用：

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= 为空）