docs: 更新文档,清理废弃文件引用
README.md: - 更新部署方式说明(OpenClaw 集成 vs 独立监听器) - 更新文件结构 - 完善故障排查章节 INSTALL.md: - 更新文件结构(删除已清理文件) - 添加 v2.0.0 更新日志 - 标注代码行数 SKILL.md: - 说明卡片交互为可选模式 - 推荐 OpenClaw 集成使用命令触发
This commit is contained in:
88
README.md
88
README.md
@@ -217,24 +217,49 @@ node scripts/upload-to-qiniu.js config reset
|
||||
|
||||
---
|
||||
|
||||
## 🚀 启动监听器
|
||||
## 🚀 部署方式
|
||||
|
||||
### 方式一:OpenClaw 集成(推荐)
|
||||
|
||||
1. 复制 skill 到 OpenClaw:
|
||||
```bash
|
||||
cp -r qiniu-uploader ~/.openclaw/workspace/skills/
|
||||
```
|
||||
|
||||
2. 配置七牛云凭证:
|
||||
```bash
|
||||
cp qiniu-config.example.json ~/.openclaw/credentials/qiniu-config.json
|
||||
nano ~/.openclaw/credentials/qiniu-config.json
|
||||
```
|
||||
|
||||
3. 重启 OpenClaw Gateway:
|
||||
```bash
|
||||
openclaw gateway restart
|
||||
```
|
||||
|
||||
4. 在飞书中测试:
|
||||
```
|
||||
/qiniu-config list
|
||||
```
|
||||
|
||||
### 方式二:独立监听器
|
||||
|
||||
```bash
|
||||
cd ~/.openclaw/workspace/skills/qiniu-uploader
|
||||
|
||||
# 前台运行
|
||||
./scripts/start-listener.sh
|
||||
# 配置环境变量
|
||||
cp .env.example .env
|
||||
nano .env # 编辑飞书凭证
|
||||
|
||||
# 后台运行
|
||||
nohup node scripts/feishu-listener.js > listener.log 2>&1 &
|
||||
# 启动监听器
|
||||
node scripts/feishu-listener.js
|
||||
|
||||
# 查看日志
|
||||
tail -f listener.log
|
||||
|
||||
# 停止服务
|
||||
pkill -f feishu-listener
|
||||
# 或使用 PM2 后台运行
|
||||
pm2 start scripts/feishu-listener.js --name qiniu-uploader
|
||||
```
|
||||
|
||||
**注意:** 独立监听器需要在飞书开放平台配置事件订阅地址。
|
||||
|
||||
---
|
||||
|
||||
## 📊 文件结构
|
||||
@@ -242,15 +267,15 @@ pkill -f feishu-listener
|
||||
```
|
||||
qiniu-uploader/
|
||||
├── scripts/
|
||||
│ ├── upload-to-qiniu.js # 核心上传脚本(支持配置管理)
|
||||
│ ├── feishu-listener.js # 飞书监听器(v2)
|
||||
│ ├── start-listener.sh # 启动脚本
|
||||
│ └── verify-url.js # URL 验证
|
||||
├── .env.example # 环境变量模板
|
||||
└── docs/
|
||||
├── README.md # 本文档
|
||||
├── QUICKSTART.md # 快速开始
|
||||
└── FEISHU_SETUP.md # 飞书配置
|
||||
│ ├── upload-to-qiniu.js # 核心上传脚本
|
||||
│ ├── feishu-listener.js # 飞书独立监听器
|
||||
│ └── update-bucket-setting.js # 存储桶设置工具
|
||||
├── openclaw-processor.js # OpenClaw 处理器
|
||||
├── openclaw-handler.js # HTTP 处理器
|
||||
├── deploy.sh # 部署脚本
|
||||
├── .env.example # 环境变量模板
|
||||
├── qiniu-config.example.json # 配置示例
|
||||
└── README.md # 本文档
|
||||
```
|
||||
|
||||
---
|
||||
@@ -259,20 +284,31 @@ qiniu-uploader/
|
||||
|
||||
### 上传失败
|
||||
|
||||
1. 检查配置:
|
||||
```bash
|
||||
# 检查配置
|
||||
/qiniu-config list
|
||||
```
|
||||
|
||||
# 手动测试上传
|
||||
2. 手动测试上传:
|
||||
```bash
|
||||
node scripts/upload-to-qiniu.js upload --file ./test.txt --key /test.txt
|
||||
```
|
||||
|
||||
3. 检查实际存储桶名称:
|
||||
```bash
|
||||
# 回复中的"存储桶"应显示实际桶名(如 daoqires),而不是配置别名(如 default)
|
||||
```
|
||||
|
||||
### 配置命令无响应
|
||||
|
||||
检查监听器日志:
|
||||
|
||||
1. 检查 OpenClaw Gateway 状态:
|
||||
```bash
|
||||
tail -f listener.log
|
||||
openclaw gateway status
|
||||
```
|
||||
|
||||
2. 查看日志:
|
||||
```bash
|
||||
tail -f /tmp/openclaw/openclaw-*.log
|
||||
```
|
||||
|
||||
### 权限错误
|
||||
@@ -282,6 +318,10 @@ tail -f listener.log
|
||||
- `im:file`
|
||||
- `im:message:send_as_bot`
|
||||
|
||||
### 存储桶覆盖问题
|
||||
|
||||
如果同名文件无法覆盖,检查七牛云控制台的"防覆盖"设置是否已关闭。
|
||||
|
||||
---
|
||||
|
||||
## 💡 最佳实践
|
||||
|
||||
Reference in New Issue
Block a user