ishenwei/nexus

Fork 0

Files

Shen Wei f09834b5a5 Update nexus: fix conflicts and sync local changes

2026-04-26 12:06:50 +08:00

32 KiB

Raw Blame History

title, source, author, published, created, description, tags

title

source

author

published

created

description

TOOLS管理

1.统一SSH管理

所有服务器: 包括macmini、ubuntu1、ubuntu2、NAS
管理方式: 通过SSH统一管理，不存储sudo密码
权限原则: 遵循最小权限原则

2.管理流程

所有服务器操作都通过SSH进行
不存储任何服务器的sudo密码
需要sudo权限的操作通过SSH执行
保持所有服务器的管理方式一致

3.文件编辑注意事项

所有重要文件: 使用 exec + echo 追加内容，避免 edit 工具在文件末尾无换行时失败
edit工具使用准则: edit依赖精确文本匹配，任何空白字符差异都会导致失败。建议：先 read 文件确认内容，用 write 重写整个文件更可靠（特别是 memory、SOUL、IDENTITY 等重要文件）

4.FRP (frpc 客户端) 管理

安装目录

服务器	FRP目录
macmini	/opt/frp/frp_0.65.0_darwin_arm64
ubuntu1	/opt/frp/frp_0.65.0_linux_amd64
ubuntu2	/opt/frp/frp_0.65.0_linux_amd64

配置文件

文件名: frpc.toml（在FRP目录下）
作用: 定义所有通过frp反向代理的应用及端口映射 (localPort ↔ remotePort)

Mac Mini 管理方式（launchd）

启动方式: launchd plist（KeepAlive: true，崩溃自动重启）

plist 位置: ~/Library/LaunchAgents/com.homebrew.frpc.plist

管理命令:


# 重启

launchctl unload ~/Library/LaunchAgents/com.homebrew.frpc.plist && launchctl load ~/Library/LaunchAgents/com.homebrew.frpc.plist

# 停止（KeepAlive 会自动重启，需先 unload）

launchctl unload ~/Library/LaunchAgents/com.homebrew.frpc.plist

# 查看状态

launchctl list | grep frpc

# 查看日志

tail -f /opt/frp/frp_0.65.0_darwin_arm64/frpc.log

正常状态标志: 日志中显示 [name] start proxy success

Ubuntu1/2 管理方式（systemd --user）


ssh ubuntu1 'systemctl --user restart frpc'

ssh ubuntu2 'systemctl --user restart frpc'

ssh ubuntu1 'systemctl --user status frpc'

ssh ubuntu2 'systemctl --user status frpc'

不需要密码，开机自启（linger 已启用）

查看配置


# 读取frpc.toml了解端口映射

cat /opt/frp/frp_0.65.0_xxx/frpc.toml

5.FRP端口映射查询格式 (2026-03-14)

用户会这样提问:

"ubuntu1上frp的列表"
"macmini的frp配置"
"查看ubuntu2的frpc.toml"

格式: 扫描frpc.toml文件，列出proxies相关配置

输出格式: 表格 (名称 | 类型 | localPort | remotePort)

查询示例: ssh到对应服务器 -> cat /opt/frp/frp_0.65.0_xxx/frpc.toml

6.FRP状态检查 (2026-04-04)

用户可能说: "检查frp状态"

检查方法:

如果是macmini服务器：

- launchctl list | grep frpc 查看进程状态

- tail /opt/frp/frp_0.65.0_darwin_arm64/frpc.log 查看代理启动情况

如果是ubuntu服务器：

- systemctl --user status frpc

正常状态标志:

所有 proxy 启动成功时会显示: [xxx] [name] start proxy success
例如: 2026-04-04 16:43:01.276 [I] [client/control.go:172] [1a254958e6553119] [macmini-ssh] start proxy success

重启命令 (如果需要):

如果是macmini服务器：


launchctl unload ~/Library/LaunchAgents/com.homebrew.frpc.plist && launchctl load ~/Library/LaunchAgents/com.homebrew.frpc.plist

如果是ubuntu服务器：


systemctl --user restart frpc

7.VPS2 (x-UI 科学上网)

IP: 104.194.92.188
SSH: ssh vps2
管理命令: x-ui
用途: x-UI 面板管理，用于科学上网
结果展示用列表方式，方便阅读

8.网络测试策略 (2026-03-15)

用户可能说: "网络测试"、"检查服务器科学上网"

测试项目:

国内直连baidu (https://www.baidu.com)
国外直连 Google (https://www.google.com)
国外通过代理访问 Google (socks5://127.0.0.1:10808)

测试命令模板:

国内访问直连


curl -v https://www.baidu.com

国外访问直连


curl -v https://www.google.com

国外访问通过代理连

这是最快、最直接的方法。我们可以强制 curl 使用 SOCKS5 代理去访问 Google 的状态页。

执行命令：


curl -x socks5h://127.0.0.1:10808 -v https://www.google.com

参数解释：

- -x socks5h://：指定使用 SOCKS5 代理。注意加个 h，这表示让代理服务器去解析域名（防止本地 DNS 污染导致测试失败）。

- -v：(Verbose) 显示详细连接过程。

判断标准：

- 如果看到 HTTP/2 200 或者大量的 HTML 文本，说明代理成功。

- 如果显示 Connection refused 或 Timeout，说明端口未开放或 V2Ray 未运行。

服务器列表与代理端口:

服务器	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	-	直连正常

输出格式: 列表方式，方便阅读

网络测试输出格式

用户要求格式示例:

• 服务器名

• 国内访问直连: ✅/❌

• 国外访问直连: ✅/❌

• 国外访问通过代理XXX连: ✅/❌

9.OpenClaw 命令路径 (2026-03-27)

| 服务器 | OpenClaw 路径 |

| -------- | ---------------------------------------- |

| Mac mini | /opt/homebrew/bin/openclaw |

| Ubuntu1 | /home/shenwei/.npm-global/bin/openclaw |

| Ubuntu2 | /home/shenwei/.npm-global/bin/openclaw |

10.NAS Docker 代理配置 (2026-03-27)

配置文件: /etc/systemd/system/pkg-ContainerManager-dockerd.service.d/http-proxy.conf
用途: Synology NAS 上 Docker 守护进程的代理设置
修改后需执行: sudo systemctl daemon-reload && sudo systemctl restart docker

11.sag (TTS 语音生成) (2026-03-27)

安装


brew install steipete/tap/sag

API Key 配置

位置: ~/.openclaw/.env
环境变量: ELEVENLABS_API_KEY

生成语音并发送到 Telegram


# 1. 生成 MP3 文件

source ~/.openclaw/.env

sag --api-key "$ELEVENLABS_API_KEY" -o /tmp/voice.mp3 "要转换的文字"

# 2. 发送到 Telegram (voice note)

message --account <telegram bot> --chatId <user_id> --filePath /tmp/voice.mp3 --message "文字" --buttons []

使用规则

所有用 sag 生成的语音都必须通过 Telegram voice note 发送给我
使用当前agent对应的telegram bot 账号发送
文件临时保存在 /tmp/ 目录

OpenCode

路径: /Users/weishen/.opencode/bin/opencode
版本: 1.2.27
用法: 开发任务必须通过它执行

12.OpenClaw Gateway 重启步骤

Mac Mini (2026-03-30 新方法)

使用 launchctl 管理 OpenClaw Gateway 服务：

launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist && launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Ubuntu1/2 服务器 (2026-03-28)

完整操作流程

1. SSH 登录并重启


ssh ubuntu1 'systemctl --user restart openclaw-gateway'

ssh ubuntu2 'systemctl --user restart openclaw-gateway'

2. 查看启动状态


ssh ubuntu1 'systemctl --user status openclaw-gateway'

ssh ubuntu2 'systemctl --user status openclaw-gateway'

3. 检查 OpenClaw 健康状态


ssh ubuntu1 '/home/shenwei/.npm-global/bin/openclaw status'

ssh ubuntu2 '/home/shenwei/.npm-global/bin/openclaw status'

快捷命令组合 (单行执行)


# Ubuntu1

ssh ubuntu1 'systemctl --user restart openclaw-gateway && systemctl --user status openclaw-gateway && /home/shenwei/.npm-global/bin/openclaw status'

# Ubuntu2

ssh ubuntu2 'systemctl --user restart openclaw-gateway && systemctl --user status openclaw-gateway && /home/shenwei/.npm-global/bin/openclaw status'

13.AgentMail (邮件收发与自动化) (2026-04-04 更新)

📂 技能目录


~/.openclaw/skills/agentmail/

├── scripts/           # 可直接使用的 Python 脚本

│   ├── check_inbox.py   # 查看收件箱

│   ├── send_email.py    # 发送邮件

│   └── setup_webhook.py # 配置 Webhook

└── references/       # 参考文档

    ├── API.md         # API 完整文档

    ├── EXAMPLES.md    # 使用示例

    └── WEBHOOKS.md   # Webhook 配置指南

快速使用

查看收件箱


unset HTTP_PROXY && unset HTTPS_PROXY && unset http_proxy && unset https_proxy

python3 ~/.openclaw/skills/agentmail/scripts/check_inbox.py --inbox star-agent@agentmail.to --limit 10

发送邮件


python3 ~/.openclaw/skills/agentmail/scripts/send_email.py \

  --inbox star-agent@agentmail.to \

  --to "recipient@example.com" \

  --subject "主题" \

  --text "正文内容"

API Key 配置

位置: ~/.openclaw/.env
环境变量: AGENTMAIL_API_KEY=your_key_here

附件处理

附件需要用 Python 代码下载，参考：


cat ~/.openclaw/skills/agentmail/references/API.md

cat ~/.openclaw/skills/agentmail/references/EXAMPLES.md

⚠️ 注意事项

代理问题：遇到 SOCKS 代理错误时，先 unset HTTP_PROXY && unset HTTPS_PROXY
临时文件存放：下载的附件和临时脚本请放在 ~/.openclaw/temp/<agentId>/ 目录，不要放在 workspace 下
参考文档：详细用法见 references/API.md 和 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 ps

# macmini SSH

ssh macmini '/Applications/Docker.app/Contents/Resources/bin/docker ps'

# ubuntu1/2 SSH

ssh ubuntu1 'docker ps'

ssh ubuntu2 'docker ps'

15.定时任务创建注意事项 (2026-03-29)

预防措施

在远程服务器(Ubuntu1/Ubuntu2)创建定时任务后，手动运行一次确认能正常发送 Telegram 通知
如果遇到 "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 和网页上的热门内容，生成研究报告

调用方式

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`

对比模式

# 比较两个话题
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 中配置：

SCRAPECREATORS_API_KEY=...   # Reddit + TikTok + Instagram（必填）
AUTH_TOKEN=...                 # X 搜索（推荐）
CT0=...                        # X 搜索（推荐）
XAI_API_KEY=xai-...           # X 搜索备选

保存位置

研究数据自动保存到：~/Documents/Last30Days/
文件名格式：{话题}-YYYY-MM-DD.md

使用场景

热点追踪 — 搜索"AI一人公司"了解最新趋势
工具对比 — "cursor vs windsurf" 对比两个工具
人物研究 — 搜索某人的 X 账号帖子
竞品分析 — 搜索竞品最新动态
话题深挖 — 发现新工具、新技术

注意事项

深度研究需要 2-8 分钟
TikTok/Instagram 需要 ScrapeCreators API key（前 100 次免费）
建议先用 --quick 测试话题

17. gog (Google Workspace CLI) 代理配置 (2026-03-30)

必须走代理

gog CLI 在 Mac Mini 上直连 Google API 会超时，必须设置代理：

HTTPS_PROXY=socks5h://127.0.0.1:10808 HTTP_PROXY=socks5h://127.0.0.1:10808 gog <command>

常用命令示例

# 日历列表（带代理）
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

scp /Users/weishen/Workspace/nexus/openclaw/content-queue/<文件名> ubuntu2:/home/shenwei/docker/n8n/n8n_data/files/<文件名>

步骤 2：触发 Webhook

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

scp ubuntu2:/home/shenwei/docker/n8n/n8n_data/files/<输出文件名> /Users/weishen/Workspace/nexus/openclaw/content-out/<输出文件名>

步骤 5：清理 Ubuntu2 临时文件

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

19.Ubuntu Docker 通过 proxychains4 走代理拉取镜像 (2026-04-05)

问题背景

Ubuntu1/2 服务器直连 Docker Hub 的 443 端口被封，导致 docker pull/build 超时。Ubuntu1/2 上已安装 proxychains4，可用于将 Docker 的 TCP 连接通过 SOCKS5 代理转发。

验证 proxychains4 是否可用

ssh ubuntu1 'proxychains4 curl -s -o /dev/null -w "HTTP %{http_code}" --max-time 8 https://registry-1.docker.io/v2/'
ssh ubuntu2 'proxychains4 curl -s -o /dev/null -w "HTTP %{http_code}" --max-time 8 https://registry-1.docker.io/v2/'
# 预期输出: HTTP 401 (TCP 接通，认证失败表示通道打通)

Docker pull 走代理

ssh ubuntu1 'proxychains4 docker pull <image>:<tag>'
ssh ubuntu2 'proxychains4 docker pull <image>:<tag>'

Docker build 走代理

ssh ubuntu1 'proxychains4 docker build --pull=false -t <image>:<tag> <dockerfile-path>'
ssh ubuntu2 'proxychains4 docker build --pull=false -t <image>:<tag> <dockerfile-path>'

注意事项

SOCKS5 vs HTTP: Xray/V2Ray 通常提供 SOCKS5 代理，proxychains4 在 TCP 层转发流量，不依赖 HTTP 代理设置
--pull=false: 在已有本地镜像时使用，避免 build 过程中再次拉取基础镜像（耗时且仍可能失败）
apt-get 不走代理: Docker build 过程中 apt-get install 走的是直连 Debian 源，不受影响
Docker daemon vs client: proxychains4 包裹的是 docker 命令，而非 dockerd 守护进程

20. memory-lancedb-pro 场景指令手册

概述

基于 LanceDB 的长期记忆系统，支持向量+BM25 混合检索、LLM 智能分类、Weibull 衰减。六种分类：fact entity preference decision reflection other。

分类	适用场景
`fact`	客观事实、知识
`entity`	实体、人物、项目
`preference`	用户偏好、设置
`decision`	决策记录、结论
`reflection`	反思、复盘
`other`	其他

场景一：列出记忆

你说： "列出 memory-lancedb-pro 记忆" Agent 调用： memory_list(limit=20) 返回：

• [fact] 用户偏好 MacBook Pro 作为开发机 (0.9)
• [entity] NAS 照片项目共 283,801 文件 (0.8)
• [decision] Memory-Pro 选用 nomic-embed-text (0.7)
...

场景二：搜索记忆

你说： "搜索 memory-lancedb-pro 里有没有关于 xxx 的记忆" Agent 调用： memory_recall(query="xxx", limit=5) 返回：

[2 条相关]
1. [entity|0.8] NAS照片整理项目（2026-03-31启动）...
2. [other|0.6] ...

场景三：存储记忆

你说： "帮我记住 xxx" Agent 调用： memory_store(text="xxx", category="fact", importance=0.8) 返回： ✅ 已存储 [fact] "xxx" (0.8)

场景四：更新记忆

你说： "帮我更新记忆，改为 xxx" Agent 调用： memory_update(memoryId="<ID>", text="新内容") 返回： ✅ 已更新 ID: a2d1fb54

场景五：删除记忆

你说： "帮我删除 xxx 这条记忆" Agent 调用：

memory_recall(query="xxx")           # 先确认
memory_forget(memoryId="<找到的ID>") # 再删除

返回： ✅ 已删除 ID: a2d1fb54

场景六：查询统计

你说： "memory-lancedb-pro 有多少条记忆" Agent 调用： memory_stats() 返回： 总计：146 条 / other:69 / fact:25 / entity:19 / ...

快速对照表

你的需求	Agent 调用	关键参数
列出记忆	`memory_list`	`limit`, `scope`, `category`
搜索记忆	`memory_recall`	`query`, `limit`
记住新内容	`memory_store`	`text`, `category`, `importance`
更新已有记忆	`memory_update`	`memoryId`, `text`
删除记忆	`memory_forget`	`memoryId` 或 `query`
看有多少条	`memory_stats`	`scope`

21. Hermes Agent (Ubuntu2) (2026-04-12)

概述

Hermes Agent 是 Nous Research 开发的自改进 AI agent，支持 Telegram/Discord/Slack 等消息平台。

安装位置: ~/.hermes/hermes-agent/
systemd 服务: hermes-gateway.service（已 enable，linger 已开启）

配置文件

文件	位置
环境变量	`~/.hermes/hermes-agent/.env`
主配置	`~/.hermes/config.yaml`
systemd service	`~/.config/systemd/user/hermes-gateway.service`

代理配置

Hermes Gateway 通过代理访问 Telegram，代理写在 systemd service 文件中：

Environment="ALL_PROXY=http://127.0.0.1:10808"
Environment="HTTPS_PROXY=http://127.0.0.1:10808"
Environment="HTTP_PROXY=http://127.0.0.1:10808"

重启步骤

# 仅重启（无需重载 systemd）
systemctl --user restart hermes-gateway

# 重载 systemd（修改 service 文件后必须）
systemctl --user daemon-reload && systemctl --user restart hermes-gateway

状态与日志

# 查看状态
systemctl --user status hermes-gateway
hermes gateway status

# 查看日志
journalctl --user -u hermes-gateway -n 30    # systemd journal
tail -30 ~/.hermes/logs/agent.log            # agent 日志
tail -30 ~/.hermes/logs/gateway.log          # gateway 日志

正常启动标志：[Telegram] Connected to Telegram (polling mode) / ✓ telegram connected

Bot Token

Bot: 云智 bot
Token: 8653044481:AAFmqdOBOFeQB6JI3M0977rLgj0s28mvbeY
用户名: @shenwei_ubuntu2_yunzhi_bot
更换 bot：编辑 ~/.hermes/hermes-agent/.env 中的 TELEGRAM_BOT_TOKEN

22. Claude Code 调用方法（OpenClaw & Hermes Terminal）

核心模式

Print Mode（推荐） — 适合绝大多数任务：

cat << 'TASK_END' | claude -p print \
  --dangerously-skip-permissions \
  --add-dir ~/.claude/skills/[技能名] \
  --add-dir [项目源码路径] \
  --max-turns 30 \
  2>&1
[任务描述]
TASK_END

TMUX 交互模式 — 适合超长任务：

tmux new-session -d -s claude-work -x 140 -y 40
tmux send-keys -t claude-work 'claude --permission-mode bypassPermissions' Enter
sleep 8 && tmux capture-pane -t claude-work -p  # 确认已启动后即可发送任务

用 --permission-mode bypassPermissions 可直接跳过信任目录 + bypass 权限确认两步

关键参数

参数	作用
`--permission-mode bypassPermissions`	直接设置 bypass 模式，跳过所有交互确认（包括信任目录、bypass 权限提示）
`--dangerously-skip-permissions`	跳过文件写入/网络确认提示（必写，否则卡住）
`--add-dir <路径>`	添加可访问目录，可多次使用
`--max-turns N`	最大迭代次数，建议 20-30
`--bare`	跳过插件/MCP/CLAUDE.md 加载，最快启动
`-p print`	非交互单次执行模式

任务文本结构

1. 告诉 Claude Code 要做什么
2. 告诉它用哪个 skill
3. 告诉它输出文件路径
4. 如果需要格式转换，明确写出转换命令
5. 最后要求输出 "done: 文件路径"

Skill 加载

--add-dir <技能目录> 会自动扫描该目录下的 SKILL.md 和 .claude/skills/，触发条件自动匹配激活。

常见坑点

不写 --dangerously-skip-permissions → 文件写入被阻塞
命令行参数直接传任务 → 特殊字符引发 shell 转义错误，用 stdin 管道
max-turns 太小 → 任务没跑完就超时，复杂任务设 25-30
环境变量 ANTHROPIC_API_KEY → 需在 settings.json 或环境变量中配置

23. yt-dlp (网络视频下载) (2026-04-15)

功能

从 Internet 下载视频文件，支持 Twitter/X、YouTube 等多种平台。

安装位置

/opt/homebrew/bin/yt-dlp

基本用法

下载并存放到挂载盘

# 直接下载到目标目录
yt-dlp -o "/Users/weishen/mnt/volume2/knowledgebase/%(title)s.%(ext)s" "视频URL"

# 或者先下载到本地，再移动
yt-dlp "视频URL"
mv video.mp4 /Users/weishen/mnt/volume2/knowledgebase/

# 如果需要指定格式
yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" \
  -o "/Users/weishen/mnt/volume2/knowledgebase/%(title)s.%(ext)s" "视频URL"

常用选项

选项	说明
`-o filename`	指定输出文件名
`--audio-format mp3`	只下载音频并转为 MP3
`--write-auto-sub`	下载自动生成的字幕

应用场景

Twitter/X 视频链接下载
YouTube 视频下载
其他支持的视频平台

⚠️ 注意事项

大文件通过 SSH pipe 传输时可能有连接问题
视频默认保存到挂载盘目录 ~/mnt/volume2/knowledgebase/
临时文件建议放在 ~/.openclaw/temp/<agentId>/attachments/ 目录

24. OpenClaw Cron Job 创建规范

标准模板

openclaw cron add \
  --agent <agentId> \
  --name "<job-name>" \
  --every <duration> \        # 如 30m, 1h, 4h
  --announce \
  --channel telegram \
  --to "5038825565" \         # ⚠️ 必须指定，否则投递失败
  --description "<描述>" \
  --message "<执行指令>"

⚠️ 关键规则

--announce --channel telegram 必须同时指定 --to "5038825565"
不带 --to 时 Telegram 投递会静默失败（无报错），导致 cron 看起来正常但用户收不到通知
禁止使用 launchd / crontab / systemd 管理定时任务，必须用 OpenClaw cron

25. Obsidian CLI (官方) (2026-04-16)

概述

官方 Obsidian CLI，集成在 Obsidian 应用中，支持读取、搜索、创建、修改笔记等操作。需要 Obsidian 应用在运行状态。

安装信息

路径: /Applications/Obsidian.app/Contents/MacOS/obsidian-cli
版本: 1.12.7
命令: obsidian（已软链到 /opt/homebrew/bin/obsidian）

前置要求

Obsidian 应用必须已在运行
默认 Vault: /Users/weishen/Workspace/nexus

核心命令

请读取obsidian-cli技能 /Users/weishen/.openclaw/skills/obsidian-cli/SKILL.md

⚠️ 注意事项

Obsidian 应用必须运行才能使用 CLI
如果 Obsidian 未运行，会报错或无响应
内容中换行用 \n，制表符用 \t

26. OpenClaw 发送图片到 Telegram (2026-04-17)

功能

通过 OpenClaw 将本地图片发送到 Telegram。

前置要求

Telegram bot 已配置
目标 chat ID（比利哥: 5038825565）

操作步骤

1. 复制图片到 media 目录

cp /path/to/image.png ~/.openclaw/media/inbound/

2. 通过 OpenClaw 发送

/opt/homebrew/bin/openclaw message send \
  --account bot1 \
  --channel telegram \
  --target 5038825565 \
  --media ~/.openclaw/media/inbound/image.png \
  --message "说明文字"

参数说明

参数	说明
`--account`	Telegram bot 账号（如 bot1）
`--channel telegram`	固定为 telegram
`--target`	目标 chat ID（比利哥: 5038825565）
`--media`	图片路径
`--message`	说明文字

示例

# 复制并发送
cp ~/Downloads/photo.jpg ~/.openclaw/media/inbound/

/opt/homebrew/bin/openclaw message send --account bot1 --channel telegram --target 5038825565 --media ~/.openclaw/media/inbound/photo.jpg --message "📷 测试图片"

注意事项

图片支持 jpg、png、gif 等常见格式
临时文件放在 ~/.openclaw/media/inbound/ 目录
文件名避免中文，建议用英文或数字

27. update-agents-tools.py 一键更新所有 Agent 的 TOOLS.md

脚本位置

~/.openclaw/scripts/update-agents-tools.py

功能

通过 Obsidian CLI 读取权限矩阵，自动解析每个 Agent 的章节分配，再从标准模板提取对应章节内容，一键更新所有 Agent 的 TOOLS.md 文件。

工作流程

📖 通过 obsidian read 读取 TOOLS权限矩阵.md
📊 解析 markdown 表格，自动发现所有 Agent 及其章节
📄 从 TOOLS标准模板.md 提取各章节内容
✏️ 写入所有 Agent 的 TOOLS.md（支持本地和 SSH 远程路径）

用法

python3 ~/.openclaw/scripts/update-agents-tools.py

特点

无需人工数表格：程序自动解析矩阵，零失误
自动发现 Agent：从表头动态提取，不依赖硬编码
支持远程：自动同步到 Ubuntu1/2 上的 Agent 目录
幂等执行：重复运行结果一致

28. Grafana 服务器监控面板 (2026-04-17)

访问地址

服务器	监控地址
MacMini	http://192.168.3.45:3000/d/macmini-cpu-mem/node-exporter-cpu-and-e58685-e5ad98-e79b91-e68ea7?orgId=1&refresh=5s&var-node=192.168.3.189:9100
Ubuntu1	http://192.168.3.45:3000/d/macmini-cpu-mem/node-exporter-cpu-and-e58685-e5ad98-e79b91-e68ea7?orgId=1&refresh=5s&var-node=192.168.3.47:9100
Ubuntu2	http://192.168.3.45:3000/d/macmini-cpu-mem/node-exporter-cpu-and-e58685-e5ad98-e79b91-e68ea7?orgId=1&refresh=5s&var-node=192.168.3.45:9100

认证信息

用户名: admin
密码: admin123

访问方式

通过 agent-browser 技能访问 Grafana 页面：

使用 agent-browser 打开上述 URL
如需登录，输入用户名 admin 和密码 admin123
使用截图功能对页面进行截屏
通过 Telegram 发送给用户

截图示例命令

# 使用 agent-browser 打开并截图
# 参考 agent-browser 技能文档进行操作

32 KiB Raw Blame History Unescape Escape

TOOLS管理

1.统一SSH管理

2.管理流程

3.文件编辑注意事项

4.FRP (frpc 客户端) 管理

安装目录

配置文件

Mac Mini 管理方式（launchd）

Ubuntu1/2 管理方式（systemd --user）

查看配置

5.FRP端口映射查询格式 (2026-03-14)

6.FRP状态检查 (2026-04-04)

7.VPS2 (x-UI 科学上网)

8.网络测试策略 (2026-03-15)

9.OpenClaw 命令路径 (2026-03-27)

10.NAS Docker 代理配置 (2026-03-27)

11.sag (TTS 语音生成) (2026-03-27)

安装

API Key 配置

生成语音并发送到 Telegram

使用规则

OpenCode

12.OpenClaw Gateway 重启步骤

Mac Mini (2026-03-30 新方法)

Ubuntu1/2 服务器 (2026-03-28)

完整操作流程

快捷命令组合 (单行执行)

13.AgentMail (邮件收发与自动化) (2026-04-04 更新)

📂 技能目录

快速使用

查看收件箱

发送邮件

API Key 配置

附件处理

⚠️ 注意事项

14.Docker命令路径 (2026-04-04)

列表

15.定时任务创建注意事项 (2026-03-29)

预防措施

常见错误处理

16. Last30Days 技能 (2026-03-29)

功能概述

调用方式

常用参数

对比模式

输出说明

数据来源权重

API Keys 配置

保存位置

使用场景

注意事项

17. gog (Google Workspace CLI) 代理配置 (2026-03-30)

必须走代理

常用命令示例

认证状态

18.n8n工作流标准执行步骤

N8N 配置信息

⚠️ 执行时间与等待规范

目录结构

执行步骤

步骤 1：复制源文件到 Ubuntu2

步骤 2：触发 Webhook

步骤 3：等待执行完成

步骤 4：复制输出文件到 MacMini

步骤 5：清理 Ubuntu2 临时文件

n8n 工作流速查表

19.Ubuntu Docker 通过 proxychains4 走代理拉取镜像 (2026-04-05)

问题背景

验证 proxychains4 是否可用

Docker pull 走代理

Docker build 走代理

注意事项

20. memory-lancedb-pro 场景指令手册

概述

场景一：列出记忆

场景二：搜索记忆

场景三：存储记忆

场景四：更新记忆

场景五：删除记忆

32 KiB

Raw Blame History