更新TOOLS.md标准模板

This commit is contained in:
2026-04-04 17:51:41 +08:00
parent 7e47461be6
commit d21ee11a36

View File

@@ -223,21 +223,14 @@ curl -x socks5h://127.0.0.1:10808 -v https://www.google.com
**服务器列表与代理端口**:
| 服务器 | IP | 代理端口 | 备注 |
|--------|-----|---------|------|
| MacMini | 192.168.3.189 | 10808 | V2RayN |
| Ubuntu1 | 192.168.3.47 | 10808 | 需SSH后测试 |
| Ubuntu2 | 192.168.3.45 | 10808 | 需SSH后测试 |
| NAS | 192.168.3.17 | 20170 | 仅监听127.0.0.1 |
| VPS1 | 192.227.222.142 | - | 直连正常 |
| VPS2 | 104.194.92.188 | - | 直连正常 |
| 服务器 | IP | 代理端口 | 备注 |
| ------- | --------------- | ----- | ------------ |
| MacMini | 192.168.3.189 | 10808 | V2RayN |
| Ubuntu1 | 192.168.3.47 | 10808 | 需SSH后测试 |
| Ubuntu2 | 192.168.3.45 | 10808 | 需SSH后测试 |
| NAS | 192.168.3.17 | 20170 | 仅监听127.0.0.1 |
| VPS1 | 192.227.222.142 | - | 直连正常 |
| VPS2 | 104.194.92.188 | - | 直连正常 |
**输出格式**: 列表方式,方便阅读
@@ -459,15 +452,11 @@ cat ~/.openclaw/skills/agentmail/references/EXAMPLES.md
## 14.Docker命令路径 (2026-04-04)
| 服务器 | 命令 | 说明 |
|--------|------|------|
| macmini | `docker` | 直接可用(已在 PATH |
| macmini (SSH) | `/Applications/Docker.app/Contents/Resources/bin/docker` | SSH 时用完整路径 |
| ubuntu1/2 | `docker` | 直接可用 |
| 服务器 | 命令 | 说明 |
| ------------- | -------------------------------------------------------- | ------------- |
| macmini | `docker` | 直接可用(已在 PATH |
| macmini (SSH) | `/Applications/Docker.app/Contents/Resources/bin/docker` | SSH 时用完整路径 |
| ubuntu1/2 | `docker` | 直接可用 |
**使用方式**:
@@ -487,4 +476,275 @@ ssh ubuntu1 'docker ps'
ssh ubuntu2 'docker ps'
```
```
## 15.定时任务创建注意事项 (2026-03-29)
### 预防措施
1. 在远程服务器(Ubuntu1/Ubuntu2)创建定时任务后,**手动运行一次**确认能正常发送 Telegram 通知
2. 如果遇到 "Outbound not configured for channel: telegram" 错误,重启 Gateway
   ```bash
   # Ubuntu1/Ubuntu2 重启 Gateway
   systemctl --user restart openclaw-gateway
   systemctl --user status openclaw-gateway
   ```
### 常见错误处理
| 错误信息 | 原因 | 解决方案 |
| ----------------------------------------------- | --------------------- | ---------- |
| "Outbound not configured for channel: telegram" | Gateway Telegram 连接异常 | 重启 Gateway |
| "Message failed" | Telegram API 限流或连接问题 | 分散任务执行时间 |
## 16. Last30Days 技能 (2026-03-29)
### 功能概述
搜索过去 30 天内 Reddit、X、YouTube、TikTok、Instagram、Hacker News、Polymarket 和网页上的热门内容,生成研究报告。
### 调用方式
```bash
python3 ~/.openclaw/skills/last30days-official/scripts/last30days.py "<话题>" --emit=compact --no-native-web --save-dir=~/Documents/Last30Days
```
### 常用参数
| 参数 | 说明 | 示例 |
|------|------|------|
| `--days=N` | 回溯 N 天默认30天 | `--days=7` |
| `--quick` | 快速模式8-12条/来源) | |
| `--deep` | 深度模式50-70条Reddit | |
| `--x-handle=HANDLE` | 指定 X 账号搜索 | `--x-handle=elonmusk` |
### 对比模式
```bash
# 比较两个话题
python3 ~/.openclaw/skills/last30days-official/scripts/last30days.py "cursor vs windsurf" --emit=compact --no-native-web --save-dir=~/Documents/Last30Days
```
### 输出说明
- **What I Learned** — 研究发现摘要
- **Key Patterns** — 关键模式3-5条
- **Stats** — 统计数据(各平台帖子数、点赞数等)
- **Invitation** — 根据类型推荐下一步
### 数据来源权重
| 来源 | 权重 | 说明 |
|------|------|------|
| Reddit/X | 高 | 有互动数据(点赞、评论) |
| YouTube | 高 | 有观看数和字幕 |
| TikTok/Instagram | 中 | 有观看数和标题 |
| Polymarket | 高 | 真实钱币投注,数据真实 |
| Web | 低 | 无互动数据 |
### API Keys 配置
在 `~/.openclaw/.env` 中配置:
```bash
SCRAPECREATORS_API_KEY=...   # Reddit + TikTok + Instagram必填
AUTH_TOKEN=...                 # X 搜索(推荐)
CT0=...                        # X 搜索(推荐)
XAI_API_KEY=xai-...           # X 搜索备选
```
### 保存位置
- 研究数据自动保存到:`~/Documents/Last30Days/`
- 文件名格式:`{话题}-YYYY-MM-DD.md`
### 使用场景
1. **热点追踪** — 搜索"AI一人公司"了解最新趋势
2. **工具对比** — "cursor vs windsurf" 对比两个工具
3. **人物研究** — 搜索某人的 X 账号帖子
4. **竞品分析** — 搜索竞品最新动态
5. **话题深挖** — 发现新工具、新技术
### 注意事项
- 深度研究需要 2-8 分钟
- TikTok/Instagram 需要 ScrapeCreators API key前 100 次免费)
- 建议先用 `--quick` 测试话题
## 17. gog (Google Workspace CLI) 代理配置 (2026-03-30)
### 必须走代理
gog CLI 在 Mac Mini 上直连 Google API 会超时,**必须设置代理**
```bash
HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog <command>
```
### 常用命令示例
```bash
# 日历列表(带代理)
HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog calendar list --account ishenwei@gmail.com
# 查看日历事件(带代理)
HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog calendar events --account ishenwei@gmail.com "OpenClaw" --from 2026-03-30T00:00:00+08:00 --to 2026-04-05T23:59:59+08:00 --max 50
# 删除日历事件(带代理)
HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog calendar delete --account ishenwei@gmail.com "OpenClaw" <eventId> -y
```
### 认证状态
- 已完成 OAuth 授权ishenwei@gmail.com
- Google Calendar: OpenClaw 日历cfd0ba26...@group.calendar.google.com
## 18.n8n工作流标准执行步骤
> ⚠️ n8n 已迁移到 Ubuntu2 服务器2026-03-30 更新)
> 用户可能说:"请用n8n内容转换工作流帮我转化这篇文章<文件名>"
### N8N 配置信息
- **N8N_BASE_URL**: `https://n8n.ishenwei.online`(从 Ubuntu2 `~/.openclaw/.env` 读取)
- **Webhook URL**: `https://n8n.ishenwei.online/webhook/<Webhook Path>`
### ⚠️ 执行时间与等待规范
- **执行时间**: 每次触发 webhook 后,需要等待 **4-5 分钟** 才能得到结果
- **禁止频繁请求**: 触发 webhook 后,**不要**连续发送多个请求或频繁轮询
- **正确做法**: 触发一次 → 等待 4-5 分钟 → 再检查 content-out 目录结果
- **失败标志**: 如果等了 5+ 分钟还没结果,再检查是否有问题
### 目录结构
| 用途 | MacMini 路径 | Ubuntu2 路径 |
| -------- | -------------------------------------------------------- | ------------------------------------------ |
| 源文件目录 | `/Users/weishen/Workspace/nexus/openclaw/content-queue/` | — |
| n8n 文件目录 | — | `/home/shenwei/docker/n8n/n8n_data/files/` |
| 输出目录 | `/Users/weishen/Workspace/nexus/openclaw/content-out/` | — |
### 执行步骤
#### 步骤 1复制源文件到 Ubuntu2
```bash
scp /Users/weishen/Workspace/nexus/openclaw/content-queue/<文件名> ubuntu2:/home/shenwei/docker/n8n/n8n_data/files/<文件名>
```
#### 步骤 2触发 Webhook
```bash
curl -X POST "<N8N_BASE_URL>/webhook/content-translation-v6" \
  -H "Content-Type: application/json" \
  -d '{
    "note_name": "<文件名>",
    "source_path": "/Users/weishen/Workspace/nexus/openclaw/content-queue/<文件名>",
    "output_name": "<文件名去掉后缀>"
  }'
```
#### 步骤 3等待执行完成
- 成功标志:返回 `{"ok":true}` 且 HTTP 200
- N8N 会通过 Telegram bot 发送完成通知
#### 步骤 4复制输出文件到 MacMini
```bash
scp ubuntu2:/home/shenwei/docker/n8n/n8n_data/files/<输出文件名> /Users/weishen/Workspace/nexus/openclaw/content-out/<输出文件名>
```
#### 步骤 5清理 Ubuntu2 临时文件
```bash
ssh ubuntu2 "rm /home/shenwei/docker/n8n/n8n_data/files/<输入文件名>"
ssh ubuntu2 "rm /home/shenwei/docker/n8n/n8n_data/files/<输出文件名>"
```
### n8n 工作流速查表
| 工作流 | Webhook Path | 输入文件规则 | 输出文件规则 | 通知方式 |
| ---- | ------------------------ | -------------------- | ------------------------- | -------- |
| 内容转化 | `content-translation-v6` | `content-queue/*.md` | `content-out/*_output.md` | Telegram |