云策：同步全部文档到专属笔记目录 (2026-03-29)

- AGENTS.md, MEMORY.md, SOUL.md, IDENTITY.md, USER.md, TOOLS.md - LEARNINGS.md, n8n-content-pipeline-workflow.md - 星枢-Agent任务解耦方案.md
2026-03-29 12:28:53 +08:00
parent 44b2436719
commit f9e2b4dcf7
9 changed files with 2022 additions and 0 deletions
--- a/openclaw/yunce/TOOLS.md
+++ b/openclaw/yunce/TOOLS.md
@@ -0,0 +1,297 @@
+
+# TOOLS管理
+## 统一SSH管理
+- **所有服务器**: 包括macmini、ubuntu1、ubuntu2、NAS
+- **管理方式**: 通过SSH统一管理，不存储sudo密码
+- **权限原则**: 遵循最小权限原则
+## 管理流程
+1. 所有服务器操作都通过SSH进行
+2. 不存储任何服务器的sudo密码
+3. 需要sudo权限的操作通过SSH执行
+4. 保持所有服务器的管理方式一致
+## Docker命令路径
+- **macmini**: `/usr/local/bin/docker` 或 `/opt/homebrew/bin/docker`（SSH时PATH不包含docker）
+- **NAS**: `/usr/local/bin/docker`（使用 `docker-compose` 而非 `docker compose`）
+- **ubuntu1/ubuntu2**: 直接用 `docker`
+
+## 文件编辑注意事项
+- **所有重要文件**: 使用 `exec + echo` 追加内容，避免 edit 工具在文件末尾无换行时失败
+- **edit工具使用准则**: edit依赖精确文本匹配，任何空白字符差异都会导致失败。建议：先 read 文件确认内容，用 write 重写整个文件更可靠（特别是 memory、SOUL、IDENTITY 等重要文件）
+
+## 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)
+### 管理方式（通过tmux）
+1. 切换到root用户: `sudo su`
+2. 进入FRP目录: `cd /opt/frp/frp_xxx`
+3. 连接到tmux会话: `tmux attach -t frpc`
+4. 停止进程: `Ctrl+C`
+5. 重启frpc: `./frpc -c frpc.toml`
+6. 查看启动是否成功
+### 查看配置
+```bash
+# 读取frpc.toml了解端口映射
+cat /opt/frp/frp_0.65.0_xxx/frpc.toml
+```
+
+## 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
+## FRP状态检查 (2026-03-14)
+用户可能说: "检查frp状态"
+**检查方法**:
+1. SSH到对应服务器
+2. 切换root: `sudo su`
+3. 进入FRP目录: `cd /opt/frp/frp_xxx`
+4. 如果是macmini服务器连接tmux: `tmux attach -t frpc`
+5. 如果是ubuntu服务器：`systemctl status frpc`
+6. 查看日志输出
+
+**正常状态标志**:
+- 所有 proxy 启动成功时会显示: `[xxx] [name] start proxy success`
+- 例如: `2026-03-14 20:49:36.007 [I] [client/control.go:172] [65f4a34a064fae9e] [transmission] start proxy success`
+
+**重启命令** (如果需要):
+1. 如果是macmini服务器：
+- `Ctrl+C` 停止当前进程
+- `./frpc -c frpc.toml` 重启
+2. 如果是ubuntu服务器
+- `systemctl stop frpc` `systemctl start frpc` `systemctl restart frpc`
+
+## VPS2 (x-UI 科学上网)
+- **IP**: 104.194.92.188
+- **SSH**: `ssh vps2`
+- **管理命令**: `x-ui`
+- **用途**: x-UI 面板管理，用于科学上网
+- 结果展示用列表方式，方便阅读
+
+## 笔记系统
+用户可能说: "请帮我记笔记"、"帮我把这篇文章保存在笔记目录"、"请读取知识库笔记目录下的这篇笔记"
+使用obsidian skill 读取/保存/修改Markdown笔记
+Macmini服务器上
+- **Obsidian笔记目录**: `/Users/weishen/Workspace/nexus`
+- **Openclaw笔记目录**: `/Users/weishen/Workspace/nexus/openclaw`
+- **知识库笔记目录**: `/Users/weishen/Workspace/nexus/openclaw/knowledgebase`
+- **云策专属笔记目录**: `/Users/weishen/Workspace/nexus/openclaw/yunce`
+
+## 网络测试策略 (2026-03-15)
+用户可能说: "网络测试"、"检查服务器科学上网"
+**测试项目**:
+1. 国内直连baidu (https://www.baidu.com)
+2. 国外直连 Google (https://www.google.com)
+3. 国外通过代理访问 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连: ✅/❌
+  
+## Telegram 配置注意事项 (2026-03-15)
+- groupPolicy=allowlist 时必须配置 groupAllowFrom，否则群消息被静默丢弃
+- 中国访问Telegram API需要配置代理 (proxy)
+- 代理协议必须是 http:// 或 socks5://
+- Bot 的 has_topics_enabled: false，不支持 Telegram Topics 功能
+## 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` |
+
+## 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`
+**使用方式**:
+- SSH 到对应服务器后，使用完整路径执行命令
+- 例如: `ssh ubuntu1 '/home/shenwei/.npm-global/bin/openclaw status'`
+## sag (TTS 语音生成) (2026-03-27)
+### 安装
+```bash
+brew install steipete/tap/sag
+```
+
+### API Key 配置
+- 位置: `~/.openclaw/.env`
+- 环境变量: `ELEVENLABS_API_KEY`
+### 生成语音并发送到 Telegram
+```bash
+# 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
+- **用法**: 开发任务必须通过它执行
+
+## Nexus Git 仓库配置
+当用户说 "请帮我把这个笔记push到Git"
+用于提交Obsidian笔记目录里的笔记，进行版本控制管理
+- **Remote URL**: `ssh://git@192.168.3.189:2222/admin/nexus.git`
+- **SSH认证**: 已配置（osxkeychain），无需输入用户名密码
+- **可直接执行**: git add → git commit → git push
+- **用户名**: weishen
+- **邮箱**: ishenwei@gmail.com
+
+## AgentMail (邮件收发与自动化) (2026-03-28)
+### 安装
+```
+npm install -g @clawhub/agentmail
+```
+### API Key / 账号配置
+- 位置: `~/.openclaw/.env`
+- 环境变量:
+AGENTMAIL_API_KEY=your_api_key  
+AGENTMAIL_EMAIL=your_email@example.com  
+AGENTMAIL_PROVIDER=imap_smtp   # 或 gmail / outlook  
+AGENTMAIL_IMAP_HOST=imap.example.com  
+AGENTMAIL_SMTP_HOST=smtp.example.com  
+AGENTMAIL_PASSWORD=your_password_or_app_password
+> ⚠️ 建议使用 **App Password**（如 Gmail / Outlook），避免主密码暴露
+### 发送邮件
+```
+agentmail send \  
+  --to "target@example.com" \  
+  --subject "测试邮件" \  
+  --body "这是一封由 Agent 自动发送的邮件"
+```
+#### 带附件发送
+```
+agentmail send \  
+  --to "target@example.com" \  
+  --subject "报告文件" \  
+  --body "请查收附件" \  
+  --attachments "/tmp/report.pdf,/tmp/log.txt"
+```
+### 收取邮件
+```
+agentmail fetch \  
+  --limit 10 \  
+  --unread true
+```
+#### 输出为 JSON（方便 Agent 处理）
+```
+agentmail fetch \  
+  --limit 20 \  
+  --format json > /tmp/mails.json
+```
+### 搜索邮件
+```
+agentmail search \  
+  --query "from:boss@example.com subject:urgent" \  
+  --limit 5
+```
+### 自动化处理（典型 Agent 场景）
+#### 1️⃣ 拉取未读邮件并分类
+```
+agentmail fetch --unread true --format json > /tmp/unread.json
+```
+#### 2️⃣ 解析后自动回复
+```
+agentmail send \  
+  --to "<extracted_email>" \  
+  --subject "Re: <original_subject>" \  
+  --body "已收到您的邮件，我们会尽快处理"
+```
+#### 3️⃣ 保存关键邮件到 Markdown（用于知识库 / Daily Notes）
+```
+agentmail fetch --limit 10 --format markdown > /tmp/mails.md
+```
+### 与 Telegram 联动（通知类）
+```
+agentmail fetch --unread true --format text > /tmp/mail.txt  
+```
+
+```
+message \  
+  --account <telegram bot> \  
+  --chatId <user_id> \  
+  --message "$(cat /tmp/mail.txt)"
+```
+### 使用规则
+- 所有 **重要邮件（如告警 / 客户 / 商机）必须同步到 Telegram**
+- 邮件正文必须经过摘要处理（避免噪音信息）
+- 附件文件统一下载到 `/tmp/` 目录再处理
+- 自动回复必须符合上下文语义，避免机械回复
+- 对于批量邮件处理，优先输出 JSON 供 Agent 决策
+- 敏感邮件（如包含凭证 / 密钥）禁止自动转发
+
+## Obsidian笔记同步 (2026-03-28)
+用户可能说: "请帮我同步一下Obsidian笔记"、"请帮我把这篇笔记push到Git"、"请同步iCloud Obsidian笔记目录"
+
+### 使用规则
+1. 打开Macmini上的终端
+2. 先把Obsidian笔记目录(`/Users/weishen/Workspace/nexus`)里新增内容添加到Git, 并添加备注，并push到Git
+3. 再做一次`git pull`把Git上最新的内容同步到Obsidian笔记目录(`/Users/weishen/Workspace/nexus`)
+4. 进入iCloud Obsidian目录 `/Users/weishen/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/nexus`
+5. 再执行一次`git pull`
+6. 如果push成功，可以把commit id告诉用户。
+7. 如果pull成功，也可以告诉用户目录已经更新。
+
+### 异常处理
+如果在处理git命令过程中出现任何问题，请第一时间联系用户。并把错误消息贴给用户看。