Friends DB

使用 scripts/friends_db.py 中的辅助脚本。不要执行任意 SQL。

何时使用

• - 请求依赖于原本存储在 friends.md 中的朋友/联系人详细信息
• 你需要电话号码、电子邮件、首选名称或关系备注
• 你需要跟踪友谊频率、上次见面日期或活动创意
• 你需要在对话或事件后添加或更新朋友信息
• 你需要将日历中过去的线下互动同步到朋友 CRM

命令

初始化或迁移：

bash
python3 ./skills/friends-db/scripts/friends_db.py migrate --source $HOME/.openclaw/workspace/friends.md --replace-with-stub

搜索：

bash
python3 ./skills/friends-db/scripts/friends_db.py search lily
python3 ./skills/friends-db/scripts/friends_db.py list

查看单个联系人：

bash
python3 ./skills/friends-db/scripts/friends_db.py show Lily Li
python3 ./skills/friends-db/scripts/friends_db.py show jerrypaulgreen@gmail.com

朋友 CRM 概览：

bash
python3 ./skills/friends-db/scripts/friends_db.py due-list
python3 ./skills/friends-db/scripts/friends_db.py due-list --status all --within-days 14
python3 ./skills/friends-db/scripts/friends_db.py profile David Su
python3 ./skills/friends-db/scripts/friends_db.py suggest David Su

CRM 设置与更新：

bash
python3 ./skills/friends-db/scripts/friends_db.py set-importance David Su high
python3 ./skills/friends-db/scripts/friends_db.py set-cadence David Su 21
python3 ./skills/friends-db/scripts/friends_db.py set-context David Su --home-area South Bay --best-times weekday evenings
python3 ./skills/friends-db/scripts/friends_db.py add-tag David Su interest pickleball
python3 ./skills/friends-db/scripts/friends_db.py add-tag David Su neighborhood South Park

互动记录：

bash
python3 ./skills/friends-db/scripts/friendsdb.py log-interaction David Su --type inperson --at 2026-03-15T18:30:00-07:00 --location South Park
python3 ./skills/friends-db/scripts/friends_db.py sync-calendar --days-back 180

通用联系人更新：

bash
python3 ./skills/friends-db/scripts/friends_db.py add-fact Lily Li Invited to dinner on 2026-03-20
python3 ./skills/friends-db/scripts/friends_db.py set-method David Su phone +14086246128 --primary
python3 ./skills/friends-db/scripts/friends_db.py set-preferred-name Lily Li Lily

规则

• - 将数据库保存在辅助脚本创建的隐藏 OpenClaw 工作区状态目录中。
• 辅助脚本强制执行私有文件系统权限和参数化 SQL。继续使用它，而不是直接使用原始用户文本调用 sqlite3。
• 迁移后仅将 friends.md 视为存根。数据库是真实数据源。
• sync-calendar 首先使用与会者电子邮件，然后使用标题/描述别名匹配。
• 仅统计 in_person 互动计入频率目标。电话/短信/电子邮件作为辅助上下文。
• 频率默认值：high=20，medium=30，low=90 天。
• 建议是本地且确定性的；它们来自标签以及捆绑的活动模板资源。
• 仅返回任务所需的字段。除非 Alex 明确要求，否则不要将整个联系人数据库转储到聊天中。