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