Auto-sync: 2026-04-22 19:20

2026-04-22 19:20:32 +08:00
parent 72f3673978
commit 772cbf2051
85 changed files with 2919 additions and 53 deletions
--- a/wiki/entities/Alex-Finn.md
+++ b/wiki/entities/Alex-Finn.md
@@ -0,0 +1,29 @@
+---
+title: "Alex Finn"
+type: entity
+tags: [content-creator, openclaw-community]
+sources: [market-research-product-factory, content-factory, custom-morning-brief]
+last_updated: 2026-04-22
+---
+
+## Definition
+
+Alex Finn 是 OpenClaw 社区的内容创作者和资深用户，通过 YouTube 视频分享 OpenClaw 高阶用法，推动了多个 OpenClaw 自动化工作流的流行。
+
+## Aliases
+
+- Alex Finn
+- Alex Finn (OpenClaw YouTuber)
+
+## Role in System
+
+- 通过 YouTube 视频激发了 [[market-research-product-factory]] 和 [[custom-morning-brief]] 等工作流的实践
+- 其视频内容是 OpenClaw 社区高阶用法的重要传播渠道
+- 专注于展示 AI Agent 在个人生产力场景中的实际应用价值
+
+## Key Relationships
+
+- [[OpenClaw]] — Alex Finn 的主要研究和推广对象
+- [[market-research-product-factory]] — 受 Alex Finn 视频启发的 OpenClaw 工作流
+- [[custom-morning-brief]] — 受 Alex Finn 视频启发的 OpenClaw 工作流
+- [[content-factory]] — 受 Alex Finn 视频启发的 Discord 多 Agent 内容工厂
--- a/wiki/entities/Asana.md
+++ b/wiki/entities/Asana.md
@@ -0,0 +1,28 @@
+---
+title: "Asana"
+type: entity
+tags: [productivity, task-management, collaboration]
+sources: [multi-channel-assistant, custom-morning-brief]
+last_updated: 2026-04-22
+---
+
+## Definition
+
+Asana 是一个企业级工作管理平台，支持项目追踪、团队协作和任务管理，被 OpenClaw 多 Agent 工作流广泛集成作为任务数据来源。
+
+## Aliases
+
+- Asana
+- asana
+
+## Role in System
+
+- 作为 [[OpenClaw]] Agent 工作流的标准任务集成目标之一（与 Todoist / Apple Reminders 并列）
+- 在 [[custom-morning-brief]] 中用于拉取当日待办事项，纳入晨间简报
+- 在 [[multi-channel-assistant]] 中作为统一任务管理后端
+
+## Key Relationships
+
+- [[OpenClaw]] — 集成 Asana 作为任务管理后端
+- [[Todoist]] — Asana 的竞品，同为待办列表集成选项
+- [[Apple Reminders]] — Asana 的竞品，同为待办列表集成选项
--- a/wiki/entities/Caddy.md
+++ b/wiki/entities/Caddy.md
@@ -0,0 +1,136 @@
+---
+title: "Caddy"
+type: entity
+aliases: [Caddy Web Server, Caddy反代]
+tags: [web-server, reverse-proxy, https, open-source]
+---
+
+# Caddy
+
+## Overview
+**Caddy** 是一个用 Go 语言编写的开源 Web 服务器，以自动 HTTPS 和简洁配置著称。相比 Nginx，Caddy 默认启用 HTTPS（Let's Encrypt 自动证书），配置语法更简洁直观。
+
+## Core Features
+
+| 特性 | 说明 |
+|------|------|
+| **自动 HTTPS** | 自动从 Let's Encrypt 申请和续期 SSL 证书 |
+| **自动 HTTP→HTTPS 重定向** | 无需手动配置 |
+| **TLS 1.3 支持** | 现代加密标准 |
+| **配置热加载** | 修改配置无需重启服务 |
+| **反向代理** | 支持 HTTP/2、WebSocket |
+| **Markdown 渲染** | 内置静态文件服务 |
+
+## Installation (Ubuntu/Debian)
+```bash
+sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
+curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
+curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
+sudo apt update
+sudo apt install caddy
+```
+
+## Basic Configuration (Caddyfile)
+
+### 简单反向代理
+```
+n8n.ishenwei.online {
+    reverse_proxy 127.0.0.1:15678
+}
+```
+
+### 多域名配置
+```
+nas.ishenwei.online {
+    reverse_proxy 127.0.0.1:15000
+}
+
+grafana.ishenwei.online {
+    reverse_proxy 127.0.0.1:13000
+}
+```
+
+### 带认证的反向代理
+```
+n8n.ishenwei.online {
+    basicauth /* {
+        admin JDJhJDE0JDN3ZXVhV2YyZG9SY2hvYzVmZ2h3QUlVblpOMU4vS1ptcENrSlhySElMb3l5dytOMkh0Tk93
+    }
+    reverse_proxy 127.0.0.1:15678
+}
+```
+
+## Integration with frp
+
+典型架构：frp 建立内网隧道 → Caddy 反向代理到本地端口 → 自动 HTTPS
+
+```
+用户请求 https://n8n.ishenwei.online
+   ↓
+阿里云 DNS → VPS 公网 IP
+   ↓
+Caddy (443端口) 接收请求
+   ↓
+Caddyfile 配置匹配 n8n.ishenwei.online
+   ↓
+reverse_proxy 127.0.0.1:15678
+   ↓
+frpc 在 VPS 15000 端口监听
+   ↓
+frp 隧道 → 内网 Ubuntu 5678 端口
+   ↓
+n8n 服务
+```
+
+## Common Commands
+
+```bash
+# 验证配置文件语法
+sudo caddy validate --config /etc/caddy/Caddyfile
+
+# 重载配置（热加载）
+sudo systemctl reload caddy
+
+# 重启服务
+sudo systemctl restart caddy
+
+# 查看状态
+sudo systemctl status caddy
+
+# 紧急恢复（服务卡死时）
+sudo systemctl stop caddy
+sudo pkill -9 caddy
+sudo systemctl start caddy
+```
+
+## Troubleshooting
+
+### Caddyfile 语法检查
+```bash
+sudo caddy validate --config /etc/caddy/Caddyfile
+# 输出 "Valid configuration" 表示语法正确
+```
+
+### 端口被占用
+如果 Caddy 启动失败，检查端口是否被占用：
+```bash
+ss -ltnp | grep ':80\|:443'
+```
+
+### Caddy 意外占用端口
+某些一键脚本可能配置 Caddy 监听非标准端口，检查是否有：
+```
+:7000 {
+    reverse_proxy ...
+}
+```
+
+## Related Concepts
+- [[反向代理]] — Caddy 的核心功能
+- [[Let's Encrypt]] — Caddy 自动使用的 SSL 证书提供商
+- [[frp]] — Caddy 常与 frp 配合使用
+- [[VPS]] — Caddy 通常部署在公网 VPS
+
+## References
+- 官网: https://caddyserver.com/
+- 文档: https://caddyserver.com/docs/
--- a/wiki/entities/Calibre.md
+++ b/wiki/entities/Calibre.md
@@ -52,6 +52,6 @@ Calibre 是功能最强大的开源电子书库管理工具，支持电子书格
 ## Related Entities
 - [[Synology NAS DS718]] — 部署宿主
 - [[RackNerd]] — 公网 VPS（Caddy）
- [[FRP]] — 内网穿透机制
+- [[frp]] — 内网穿透机制
 - [[Jellyfin]] — 视频媒体服务（同一 NAS）
 - [[Navidrome]] — 音乐流媒体服务（同一 NAS）
--- a/wiki/entities/ClawdTalk.md
+++ b/wiki/entities/ClawdTalk.md
@@ -0,0 +1,33 @@
+---
+title: "ClawdTalk"
+type: entity
+tags: []
+sources: []
+last_updated: 2026-04-22
+---
+
+# ClawdTalk
+
+## Overview
+ClawdTalk 是由 Telnyx 团队出品的电话集成客户端库（[@team-telnyx/clawdtalk-client](https://github.com/team-telnyx/clawdtalk-client)），使 [[OpenClaw]] 能够接收和拨打电话，将任意手机变成 AI 助理的语音入口。
+
+## Core Functions
+- **来电接收**：AI Agent 可接收用户拨打的电话
+- **去电发起**：AI Agent 可主动拨打电话联系用户
+- **语音对话**：通过电话实现与 AI Agent 的实时语音交互
+
+## Architecture
+- 作为 [[OpenClaw]] 的电话技能（phone skill）集成
+- 底层依赖 [[Telnyx]] API 提供电信连接
+- 属于 [[OpenClaw Skills]] 生态，通过 OpenClaw 的 skills 接口调用
+
+## Related Links
+- [ClawdTalk Website](https://clawdtalk.com)
+- [ClawdTalk GitHub](https://github.com/team-telnyx/clawdtalk-client)
+
+## Sources
+- [[phone-based-personal-assistant]]
+
+## Aliases
+- clawdtalk
+- ClawdTalk Client
--- a/wiki/entities/Gitea.md
+++ b/wiki/entities/Gitea.md
@@ -0,0 +1,33 @@
+---
+title: "Gitea"
+type: entity
+tags: [git, self-hosted, github-alternative, devops]
+sources: [self-healing-home-server]
+last_updated: 2026-04-22
+---
+
+## Aliases
+- Gitea
+- gitea
+
+## Definition
+Gitea 是一个开源、轻量级的自托管 Git 服务（GitHub/GitLab 替代方案），使用 Go 语言编写，最低硬件要求极低（512MB RAM）。支持 Git 仓库管理、Issue 追踪、Pull Request、Wiki、CI/CD（Actions）等完整功能。
+
+## In Home Lab Context
+在 [[self-healing-home-server]] 安全架构中，Gitea 作为**本地优先 Git 仓库**：
+- 作为私有代码中转站（推送到公共 GitHub 前的 CI 扫描_gate）
+- CI pipeline 运行 TruffleHog 等 secrets scanning 工具
+- Human review required before main branch merges
+- 防止 Agent 直接暴露 API keys 到公共仓库
+
+## Security Role
+Gitea 在 [[Local-first Git]] 工作流中的位置：
+```
+Agent → commits → Gitea (private) → CI scan (TruffleHog) → Human review → GitHub (public)
+```
+
+## Connections
+- [[Local-first Git]] — Gitea 作为私有中转的核心基础设施
+- [[OpenClaw]] — Agent 代码托管和工作流编排平台
+- [[TruffleHog]] — Gitea CI pipeline 中运行的 secrets scanning 工具
+- [[Defense-in-Depth]] — Gitea 是多层安全防御架构的一环
--- a/wiki/entities/K3s.md
+++ b/wiki/entities/K3s.md
@@ -0,0 +1,32 @@
+---
+title: "K3s"
+type: entity
+tags: [kubernetes, container, orchestration, open-source]
+sources: [self-healing-home-server]
+last_updated: 2026-04-22
+---
+
+## Aliases
+- K3s
+- k3s
+
+## Definition
+K3s 是一个轻量级的 Kubernetes 发行版，由 Rancher Labs（现 SUSE）开发，专为边缘计算、资源受限环境和家庭实验室设计。相较于标准 Kubernetes，K3s 将所有控制平面组件打包为单一二进制文件，去除了 cloud provider 特化代码，默认使用 SQLite 作为存储后端，体积仅约 50MB。
+
+## Core Features
+- **单二进制部署**：所有 K8s 组件打包为单一可执行文件
+- **轻量资源占用**：最低 512MB RAM 即可运行，适合树莓派和家庭服务器
+- **内置容器运行时**：默认使用 containerd，无需 Docker 依赖
+- **简化运维**：自动处理 TLS、滚动更新、指标收集
+
+## In Home Lab Context
+在 [[self-healing-home-server]] 使用场景中，K3s 作为家庭 Kubernetes 集群，由 OpenClaw Agent "Reef" 通过 kubectl 管理。Agent 可自动化执行以下操作：
+- Pod 重启与健康检查
+- 资源扩缩容
+- 配置变更与 Rollback
+- 跨节点工作负载调度
+
+## Connections
+- [[OpenClaw]] — 通过 kubectl 管理 K3s 集群的 Agent 平台
+- [[Self-Healing-Systems]] — K3s 提供 Liveness/Readiness Probes 原生自愈能力
+- [[Infrastructure-as-Code]] — Agent 编写并应用 Kubernetes manifests
--- a/wiki/entities/LinuxServer.io.md
+++ b/wiki/entities/LinuxServer.io.md
@@ -0,0 +1,64 @@
+# LinuxServer.io
+
+## Type
+- Entity
+- Organization / Open Source Project
+
+## Description
+LinuxServer.io 是一个社区驱动的开源组织，专门为流行的自托管应用维护高质量的 Docker 镜像。所有镜像均遵循标准化配置模式，支持 PUID/PGID 环境变量、统一的目录结构、Web UI 默认端口约定，以及完整的文档支持。
+
+## Key Facts
+- **Focus**: Self-hosted applications on Docker
+- **Image Registry**: lscr.io (Docker Hub official partner)
+- **Standard Variables**: PUID, PGID, TZ, UMASK_SET
+- **Notable Images**: transmission, jellyfin, navidrome, plex, sonarr, radarr, jackett, SABnzbd, home-assistant, nginx, nextcloud, portainer, it-tools, etc.
+- **License**: Various (per image)
+
+## Standard Configuration Pattern
+
+所有 LinuxServer.io 镜像遵循统一配置规范：
+
+### Environment Variables
+```yaml
+environment:
+  - PUID=1000        # Process UID (宿主用户ID)
+  - PGID=1000        # Process GID (宿主组ID)
+  - TZ=Etc/UTC       # Timezone
+  # Image-specific variables below
+```
+
+### Volume Mounts
+```yaml
+volumes:
+  - /path/to/config:/config    # 配置目录
+  - /path/to/downloads:/downloads  # 可选：下载目录
+```
+
+### Restart Policy
+```yaml
+restart: unless-stopped  # 容器异常退出后自动重启
+```
+
+### Network Mode
+```yaml
+network_mode: bridge     # 桥接网络，支持端口映射
+```
+
+## Notable Images in shenwei's Home Server
+
+| Image | Purpose | Port |
+|-------|---------|------|
+| [[Transmission]] | BT 下载客户端 | 9091 |
+| [[Jellyfin]] | 视频流媒体服务器 | 8096 |
+| [[Navidrome]] | 音乐流媒体服务器 | 4533 |
+| portainer | Docker 容器管理 | 9000 |
+| it-tools | IT 工具集 | 8080 |
+| home-assistant | 智能家居控制 | 8123 |
+
+## Connections
+- [[Transmission]] — maintained image
+- [[Jellyfin]] — maintained image
+- [[Navidrome]] — maintained image
+- [[Docker]] — deployment platform
+- [[群晖 NAS]] — 常见部署平台
+- [[Docker Compose]] — recommended deployment method
--- a/wiki/entities/NicholasCarlini.md
+++ b/wiki/entities/NicholasCarlini.md
@@ -0,0 +1,20 @@
+---
+title: "Nicholas Carlini"
+type: entity
+tags: [ai-researcher, autonomous-agents]
+sources: [autonomous-project-management]
+last_updated: 2026-04-22
+---
+
+## 基本信息
+- **职业**：AI 研究者
+- **研究领域**：自主编码 Agent、可扩展 AI 系统
+
+## 核心观点
+- "Let agents self-organize rather than micromanaging them."
+  - 让 Agent 自我组织，而非微观管理每个执行步骤
+  - 这是 [[autonomous-project-management]] 去中心化协调模式的核心思想来源
+
+## Aliases
+- Nicholas Carlini
+- N. Carlini
--- a/wiki/entities/OpenClaw.md
+++ b/wiki/entities/OpenClaw.md
@@ -2,7 +2,7 @@
 title: "OpenClaw"
 type: entity
 tags: [OpenClaw, Agent, Workspace, Multi-Agent]
-sources: [万字讲透openclaw-workspace深度解析-2026-03-21, 养龙虾5天血泪史-我的ai-agent为什么总失忆-openclaw-记忆调试全记录, daily-youtube-digest]
+sources: [multi-agent-team, 万字讲透openclaw-workspace深度解析-2026-03-21, 养龙虾5天血泪史-我的ai-agent为什么总失忆-openclaw-记忆调试全记录, daily-youtube-digest, self-healing-home-server, custom-morning-brief]
 last_updated: 2026-03-21
 ---

--- a/wiki/entities/RackNerd.md
+++ b/wiki/entities/RackNerd.md
@@ -84,7 +84,7 @@ RackNerd VPS 在整个家庭网络架构中扮演**公网网关**角色：

 ## Related Entities
 - [[Caddy]] — 自动HTTPS反向代理（VPS上运行）
- [[FRP]] — 内网穿透工具（frps在VPS, frpc在各内网节点）
+- [[frp]] — 内网穿透工具（frps在VPS, frpc在各内网节点）
 - [[Cloudflare]] — DNS托管服务商
 - [[Synology NAS DS718]] — 内网NAS（frpc客户端之一）
 - [[Mac Mini M4]] — 主控节点（frpc客户端之一）
--- a/wiki/entities/Synology-NAS-DS718.md
+++ b/wiki/entities/Synology-NAS-DS718.md
@@ -94,7 +94,7 @@ Synology NAS DS718 是群晖（Synology）推出的双盘位 NAS 设备，搭载
 - [[Zipline]] — 图床应用
 - [[MinIO]] — 对象存储
 - [[Caddy]] — 自动HTTPS反向代理（VPS运行）
- [[FRP]] — 内网穿透（frps:VPS, frpc:NAS）
+- [[frp]] — 内网穿透（frps:VPS, frpc:NAS）
 - [[RackNerd]] — 公网VPS提供商
 - [[矿神源]] — 群晖第三方套件源（SPK格式）
 - [[阿里云盘]] — CloudDrive2的挂载目标
--- a/wiki/entities/Telnyx.md
+++ b/wiki/entities/Telnyx.md
@@ -0,0 +1,24 @@
+---
+title: "Telnyx"
+type: entity
+tags: []
+sources: []
+last_updated: 2026-04-22
+---
+
+# Telnyx
+
+## Overview
+Telnyx 是一家电信 API 提供商，提供可靠的全球电话连接服务。在 AI Agent 场景中，Telnyx API 为 [[ClawdTalk]] 提供底层电话能力支撑，使 [[OpenClaw]] 能够实现来电接收和去电呼叫。
+
+## Key Products
+- **Telnyx Voice API**：全球 SIP 中继和电话号码管理
+- **电话连接**：支持来电接收（Inbound）和去电发起（Outbound）
+- **短信服务（即将）**：SMS 支持正在开发中
+
+## Sources
+- [[phone-based-personal-assistant]]
+
+## Aliases
+- Telnyx API
+- Telnyx.com
--- a/wiki/entities/Todoist.md
+++ b/wiki/entities/Todoist.md
@@ -1,35 +1,29 @@
 ---
 title: "Todoist"
 type: entity
-tags: []
+tags: [productivity, task-management]
+sources: [multi-channel-assistant, custom-morning-brief, meeting-notes-action-items]
 last_updated: 2026-04-22
 ---

-# Todoist
+## Definition

-跨平台个人和团队任务管理工具，支持自然语言输入、标签、过滤器和协作功能。通过 API 可实现个人行动项的自动化管理，适合个人工作流和轻量级团队场景。
-
-## Overview
-
-Todoist 是 [[meeting-notes-action-items]] 和 [[todoist-task-manager]] 中的核心任务管理工具。Agent 从会议中提取的个人行动项可自动添加到 Todoist，设置截止日和提醒。
+Todoist 是一个跨平台待办事项管理工具，支持个人任务管理和团队协作，被 OpenClaw 多 Agent 工作流广泛集成作为任务数据来源。

 ## Aliases
- Todoist 自然语言解析
- Todoist API

-## Capabilities
- 自然语言任务创建（"明天3点完成任务"）
- 项目/标签/过滤器层级
- 团队协作（个人版/专业版/商业版）
- REST API
- 截止日和定时提醒
- 与 Google Calendar 同步
+- Todoist
+- todoist

-## Related Entities
- [[Linear]] — 团队级替代
- [[Jira]] — 企业级替代
- [[Notion]] — 协作型知识管理
+## Role in System

-## Related Sources
- [[meeting-notes-action-items]]
- [[todoist-task-manager]]
+- 作为 [[OpenClaw]] Agent 工作流的标准任务集成目标之一（与 Apple Reminders / Asana 并列）
+- 在 [[custom-morning-brief]] 中用于拉取当日待办事项，纳入晨间简报
+- 在 [[multi-channel-assistant]] 中作为统一任务管理后端
+- 在 [[meeting-notes-action-items]] 中用于自动创建会议行动项任务
+
+## Key Relationships
+
+- [[OpenClaw]] — 集成 Todoist 作为任务管理后端
+- [[Apple Reminders]] — Todoist 的竞品，同为待办列表集成选项
+- [[Asana]] — Todoist 的竞品，同为团队协作任务管理工具
--- a/wiki/entities/Transmission.md
+++ b/wiki/entities/Transmission.md
@@ -0,0 +1,77 @@
+# Transmission
+
+## Type
+- Entity
+- Software
+
+## Description
+Transmission 是一个开源的 BitTorrent 下载客户端，提供简洁的 Web UI 界面，支持远程管理和自动化下载。是 Home Server 媒体中心的核心组件，负责 BT 种子下载环节。
+
+## Aliases
+- Transmission BitTorrent
+- lscr.io/linuxserver/transmission
+
+## Key Facts
+- **License**: MIT
+- **Language**: C ( GTK+ / Qt GUI / Web UI )
+- **Official Image**: lscr.io/linuxserver/transmission:latest
+- **Deployment**: Docker Compose on Synology NAS / Home Server
+- **Web UI Port**: 9091
+- **Peer Port**: 51413 (TCP + UDP)
+- **Author**: shenwei
+
+## Configuration
+
+### Web UI Access
+通过 http://host:9091 访问 Web 管理界面，支持：
+- 种子管理（添加/暂停/删除/优先级）
+- 下载/上传速度限制
+- 连接peer管理
+- RSS自动下载（需插件）
+
+### Authentication
+Web UI 认证通过 USER/PASS 环境变量配置：
+```yaml
+environment:
+  - USER=shenwei
+  - PASS=<password>
+```
+
+### Docker Deployment (shenwei)
+```yaml
+services:
+  transmission:
+    image: lscr.io/linuxserver/transmission:latest
+    container_name: transmission
+    restart: unless-stopped
+    network_mode: bridge
+    ports:
+      - "9091:9091"       # Web UI
+      - "51413:51413"     # Peer TCP
+      - "51413:51413/udp" # Peer UDP
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=Etc/UTC
+      - USER=shenwei
+      - PASS=<password>
+    volumes:
+      - /home/shenwei/Docker/transmission/data:/config
+      - /home/shenwei/Downloads:/downloads
+```
+
+## Connections
+
+### Upstream
+- [[LinuxServer.io]] — 官方 Docker 镜像维护者
+
+### Downstream
+- [[Jellyfin]] — 视频播放（Transmission 下载 → Jellyfin 播放）
+- [[Navidrome]] — 音乐播放（Transmission 下载 → Navidrome 播放）
+- [[Docker Compose]] — 部署方式
+
+### Related
+- [[群晖 NAS]] — 部署平台（Synology NAS Docker 环境）
+
+## Sources
+- [[用docker安装transmission]]
--- a/wiki/entities/TruffleHog.md
+++ b/wiki/entities/TruffleHog.md
@@ -0,0 +1,38 @@
+---
+title: "TruffleHog"
+type: entity
+tags: [security, secrets-detection, git, open-source]
+sources: [self-healing-home-server]
+last_updated: 2026-04-22
+---
+
+## Aliases
+- TruffleHog
+- trufflehog
+- Truffle Hog
+
+## Definition
+TruffleHog 是一个开源的 Git secrets scanning 工具，通过正则表达式和 entropy 分析检测 Git 仓库中的硬编码凭证（API keys、tokens、passwords、private keys 等）。支持 GitHub、GitLab、Gitea 等所有 Git 服务，是 DevSecOps 和 AI Agent 安全运营的必备工具。
+
+## Core Features
+- **High-entropy 检测**：识别随机字符串形式的 API keys
+- **正则匹配**：识别常见凭证格式（AWS keys、Slack tokens、JWTs 等）
+- **Git 历史扫描**：扫描整个 Git 历史中的 secrets（og commit 检测）
+- **CI/CD 集成**：支持 GitHub Actions、GitLab CI、Gitea Actions 等
+
+## In Home Lab Context
+在 [[self-healing-home-server]] 的安全 checklist 中，TruffleHog 是**第一道防线**：
+- **Pre-push hooks**：在 Agent commit 之前阻断包含 secrets 的代码
+- 配合 [[Gitea]] CI pipeline 使用
+- 与 [[1Password]] 专用 AI vault 共同构成纵深防御
+
+## Critical Insight
+> "AI assistants will happily hardcode secrets. They sometimes don't have the same instincts humans do." — Nathan（[[OpenClaw]] 用户）
+
+AI Agent 在生成代码时倾向于直接写入 API keys，这是 AI Agent 基础设施安全的 #1 风险。TruffleHog pre-push hooks 是**必须配置**的防线。
+
+## Connections
+- [[Defense-in-Depth]] — TruffleHog 作为多层安全防御的第一环
+- [[Local-first Git]] — 与 Gitea 配合实现安全 Git 工作流
+- [[1Password]] — Agent secrets 的安全存储方案
+- [[OpenClaw]] — 需要 TruffleHog 保护的 Agent 平台
--- a/wiki/entities/frp.md
+++ b/wiki/entities/frp.md
@@ -0,0 +1,142 @@
+---
+title: "frp"
+type: entity
+aliases: [frp内网穿透, frp工具]
+tags: [network, proxy, tunneling, open-source]
+---
+
+# frp
+
+## Overview
+**frp** (Fast Reverse Proxy) 是一个开源的高性能内网穿透工具，由 [fatedier](https://github.com/fatedier/frp) 开发维护。通过在公网服务器（frps）和内网机器（frpc）之间建立反向隧道，使内网服务可被公网访问。
+
+## Architecture
+
+frp 采用 C/S 架构，包含两个核心组件：
+
+| 组件 | 全称 | 角色 | 部署位置 |
+|------|------|------|---------|
+| **frps** | frp Server | 服务端，监听客户端连接 | 公网 VPS |
+| **frpc** | frp Client | 客户端，建立反向隧道 | 内网机器 |
+
+## Core Concepts
+
+### Protocol Types
+- **TCP**：通用 TCP 代理，适用于 SSH、数据库等任意 TCP 服务
+- **UDP**：通用 UDP 代理，适用于 DNS、视频流等 UDP 服务
+- **HTTP/HTTPS**：专为 Web 服务设计，支持虚拟主机和路径路由
+
+### Authentication
+- **Token**：基于共享密钥的认证机制，frps 和 frpc 配置中的 `token` 必须一致
+- Token 不一致会导致认证失败：`authentication failed token mismatch`
+
+### Dashboard (Optional)
+frps 可选启用 Web 管理面板：
+```ini
+[dashboard]
+dashboard_addr = 0.0.0.0
+dashboard_port = 7500
+dashboard_user = admin
+dashboard_pwd = StrongPassword123!
+```
+
+## Configuration Files
+
+### frps.ini (服务端)
+```ini
+[common]
+bind_addr = 0.0.0.0
+bind_port = 7000
+
+# 可选：Web Dashboard
+dashboard_addr = 0.0.0.0
+dashboard_port = 7500
+dashboard_user = admin
+dashboard_pwd = StrongPassword
+
+# 认证 Token（必须与客户端一致）
+token = YourSecretTokenHere
+```
+
+### frpc.ini (客户端)
+```ini
+[common]
+server_addr = <frps公网IP>
+server_port = 7000
+token = YourSecretTokenHere
+
+# TCP 映射示例：本地 5000 → VPS 15000
+[nas]
+type = tcp
+local_ip = 127.0.0.1
+local_port = 5000
+remote_port = 15000
+
+# SSH 映射示例
+[ssh]
+type = tcp
+local_ip = 127.0.0.1
+local_port = 22
+remote_port = 60022
+```
+
+## Installation
+
+### VPS (frps)
+```bash
+cd /opt
+sudo mkdir frp && cd frp
+FRP_VER=0.65.0
+sudo curl -LO https://github.com/fatedier/frp/releases/download/v${FRP_VER}/frp_${FRP_VER}_linux_amd64.tar.gz
+sudo tar xzf frp_${FRP_VER}_linux_amd64.tar.gz
+sudo mv frp_${FRP_VER}_linux_amd64/* /opt/frp/
+```
+
+### systemd Service (frps)
+```ini
+[Unit]
+Description=frp server (frps)
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=/opt/frp/frps -c /opt/frp/frps.ini
+Restart=on-failure
+
+[Install]
+WantedBy=multi-user.target
+```
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now frps
+sudo systemctl status frps
+```
+
+## Common Use Cases
+
+1. **Web 服务穿透**：内网 NAS、Web 应用通过子域名访问
+2. **SSH 远程访问**：通过 `ssh -p 60022 user@vps.domain.com` 访问内网机器
+3. **数据库远程连接**：MySQL、MongoDB 等数据库的远程管理
+4. **监控系统访问**：Grafana、Prometheus 等内网监控面板的公网展示
+
+## Advantages
+
+| 特性 | 说明 |
+|------|------|
+| **轻量** | 单二进制文件，无额外依赖 |
+| **高性能** | 基于 Go 语言，支持高并发连接 |
+| **自动重连** | 网络中断后自动重连 |
+| **热更新** | 支持配置热加载 |
+| **多协议支持** | TCP/UDP/HTTP/HTTPS |
+| **Web Dashboard** | 可选的图形化管理界面 |
+
+## Related Concepts
+- [[内网穿透]] — frp 是实现内网穿透的典型工具
+- [[反向代理]] — frp 与 Caddy/Nginx 常配合使用
+- [[TCP 隧道]] — frp 建立的底层连接机制
+- [[VPS]] — frps 常部署在公网 VPS 上
+
+## References
+- GitHub: https://github.com/fatedier/frp
+- 文档: https://gofrp.org/docs/
--- a/wiki/entities/gog.md
+++ b/wiki/entities/gog.md
@@ -0,0 +1,27 @@
+---
+title: "gog"
+type: entity
+tags: [gog, Google Workspace, CLI, OpenClaw]
+sources: [multi-channel-assistant]
+last_updated: 2026-04-22
+---
+
+# gog
+
+## Overview
+gog 是一个 Google Workspace CLI 工具，支持通过命令行操作 Gmail、Google Calendar 和 Google Drive。在 [[multi-channel-assistant]] 中作为 OpenClaw 与 Google Workspace 集成的核心工具。
+
+## Capabilities
+- **Gmail**：发送、读取、搜索邮件
+- **Calendar**：创建日历事件、查询日程
+- **Drive**：上传和管理文件
+
+## Role in OpenClaw Workflow
+- "Schedule [event]" → 使用 `gog calendar`
+- "Email [person] about [topic]" → 使用 `gog gmail`
+- "Upload [file] to Drive" → 使用 `gog drive`
+
+## Connections
+- [[OpenClaw]] — 通过命令行调用 gog
+- [[Google-Workspace]] — gog 的集成目标
+- [[multi-channel-assistant]] — 依赖 gog 实现 Google 生态集成
--- a/wiki/entities/idea-reality-mcp.md
+++ b/wiki/entities/idea-reality-mcp.md
@@ -0,0 +1,66 @@
+---
+title: "idea-reality-mcp"
+type: entity
+tags: []
+last_updated: 2026-04-22
+---
+
+## Overview
+基于 [[MCP（Model Context Protocol）]] 的竞争分析 MCP 服务器，在 AI 项目启动前扫描 GitHub、Hacker News、npm、PyPI、Product Hunt 五个真实数据源，返回 `reality_signal` 分数（0-100）评估赛道拥挤度，并提供竞品信息和转向建议。
+
+## Type
+产品 / MCP Server
+
+## Installation
+```bash
+uvx idea-reality-mcp
+```
+
+## Configuration (OpenClaw)
+```json
+{
+  "mcpServers": {
+    "idea-reality": {
+      "command": "uvx",
+      "args": ["idea-reality-mcp"]
+    }
+  }
+}
+```
+
+## API: `idea_check()`
+输入：项目想法描述（字符串）
+输出：
+- `reality_signal`：0-100 拥挤度评分
+- `top_competitors`：竞品列表（含 stars、描述）
+- `pivot_hints`：转向建议
+
+## Usage Rules (OpenClaw Instructions)
+```
+Before starting any new project, feature, or tool, always run idea_check first.
+
+Rules:
+- If reality_signal > 70: STOP. Report top 3 competitors with star counts.
+  Ask if I want to proceed, pivot, or abandon.
+- If reality_signal 30-70: Show results and pivot_hints.
+  Suggest a niche angle that existing projects don't cover.
+- If reality_signal < 30: Proceed to build.
+  Mention that the space is open.
+- Always show the reality_signal score and top competitors before writing any code.
+```
+
+## Data Sources
+- GitHub（仓库数量、Star 分布）
+- Hacker News（讨论热度）
+- npm（Node.js 包生态）
+- PyPI（Python 包生态）
+- Product Hunt（早期产品关注度）
+
+## Related
+- [[Pre-Build Validation]]
+- [[Competition-Analysis]]
+- [[MCP（Model Context Protocol）]]
+- [[OpenClaw]]
+- [GitHub](https://github.com/mnemox-ai/idea-reality-mcp)
+- [PyPI](https://pypi.org/project/idea-reality-mcp/)
+- [Web Demo](https://mnemox.ai/check)