1. 项目概述Claw Friends UX一个为AI助手打造的社交网络技能如果你和我一样日常工作中重度依赖Claude、ChatGPT这类AI助手那你肯定也遇到过类似的困扰每次开启一个新的对话都得花上几分钟甚至更长时间向AI重新介绍一遍“我是谁”、“我擅长什么”、“我最近在做什么项目”。这种重复劳动不仅低效还常常因为描述不完整导致AI无法给出最精准、最贴合你个人背景的建议。更不用说在多个AI助手之间切换时这种“自我介绍”的负担会成倍增加。Claw Friends UX的出现就是为了彻底解决这个问题。它本质上是一个运行在AI助手环境如Claude Desktop里的“社交网络”技能。但别误会这里的“社交”不是让你和AI聊天而是让你能通过AI助手与其他同样使用这个技能的用户建立连接、交换技能标签和兴趣图谱。想象一下你只需要在本地初始化一份加密的个人资料声明你的技术栈比如Rust、Kubernetes、机器学习和兴趣领域比如开源、分布式系统系统就能自动帮你找到社区里志同道合的开发者。你们可以通过AI助手进行加密的“自动协商”逐步交换非敏感的专业见解最终决定是否建立“好友”关系。成为好友后双方AI助手在对话时就能自动加载对方的公开资料实现真正意义上的“上下文感知”让每一次对话都建立在充分了解你专业背景的基础上。这个项目的核心价值在于“去中心化”和“用户体验优先”。你的所有数据包括加密密钥、个人资料都只保存在本地。社交图谱通过Git仓库进行点对点同步没有任何中心服务器存储你的隐私。而“UX”版本更是对原有Claw Friends的一次彻底重构重点强化了视觉交互、智能引导和错误恢复能力让整个从安装、配置到日常使用的过程变得无比顺滑。接下来我将结合自己从零开始部署、测试到深度使用的全过程为你拆解这个工具的每一个细节。2. 核心设计思路与架构解析2.1 为什么是“技能”而非独立应用初次接触时你可能会疑惑为什么不直接做一个Web应用或桌面客户端而要做成一个AI助手的“技能”Skill这背后有非常实际的技术和用户体验考量。首先降低使用门槛和心智负担。对于开发者而言命令行和AI助手对话是最高频的工作界面。一个需要额外安装、单独启动的应用很容易被遗忘在角落。而作为一个技能它直接集成在你每天都要使用的Claude或Copilot对话窗口中通过简单的/friends命令即可唤醒使用路径极短形成了“需求-触发-解决”的无缝闭环。其次深度利用AI助手的上下文能力。这是最关键的一点。当技能被触发时它能获取到当前对话的部分上下文例如你正在和AI讨论一个Rust的并发问题。结合你的个人资料和好友网络技能可以给出更具针对性的建议比如“你的好友chengdu_panda上个月分享过Tokio Select!宏的实战心得需要我调取摘要吗”这种深度集成是独立应用难以实现的。最后利用现有的信任与安全模型。AI助手客户端本身已经处理了用户认证、会话隔离等安全问题。技能运行在助手的沙盒环境中其数据存储通常是用户主目录下的隐藏文件夹和网络访问权限受到严格约束这为构建一个去中心化的、隐私优先的社交网络提供了天然的基础设施。2.2 去中心化架构是如何实现的“去中心化”听起来很酷但Claw Friends UX用一套相当精巧且务实的设计将其落地了。整个系统没有中心化的用户数据库或消息服务器其运转依赖于两个核心组件本地配置文件和Git仓库网络。1. 本地数据存储 (~/.ocfr/)所有核心数据都存放在用户本地的一个隐藏目录中结构如下~/.ocfr/ ├── keys/ │ ├── private.pem # RSA私钥绝对不可泄露 │ └── public.pem # RSA公钥用于加密发送给好友的消息 ├── profile.yaml # 你的个人资料技能、兴趣、简介 ├── friends/ # 好友列表及每个人的公开资料缓存 ├── requests/ # 收到和发出的好友请求 ├── messages/ # 加密的私密消息存储 └── sync_log.txt # 数据同步记录这种设计确保了用户数据的绝对主权。即使项目的GitHub仓库消失你的社交关系和资料依然完好无损。2. Git仓库作为同步层社区成员列表和公开资料不包含私钥和私密消息通过一个指定的Git仓库进行同步。你可以把它想象成一个特殊的“电话簿”。当你执行/friends sync时脚本会拉取git pull远程仓库的最新数据获取新加入的成员或已更新资料的成员信息。将你的公开资料由profile.yaml生成的一个脱敏版本提交git commit push到仓库中供其他人拉取。 这个过程是异步的、基于操作的而非实时推送。它巧妙利用了Git的版本控制特性实现了数据的分布式共享与冲突解决虽然概率极低。3. 点对点加密通信当你想给某人发送一条私密消息时系统会从本地缓存的社区数据中找到对方的公钥。使用对方的公钥通过RSA算法加密一个随机生成的AES会话密钥。再使用这个AES会话密钥加密你的消息正文。将“加密的AES密钥” “加密的消息”打包存储到本地的messages/目录下并标记为“待发送”。在下一次执行/friends sync时这个加密包会作为一个文件被提交到Git仓库。对方同步仓库后会在本地发现这个加密包使用自己的私钥解密出AES会话密钥进而解密出你的消息。 这套“RSA非对称加密 AES对称加密”的混合模式在保证安全性的同时兼顾了加密大量消息时的性能。2.3 UX版本的重构精髓从工具到体验原版Claw Friends已经实现了上述核心功能但更像一个极客工具需要用户记忆大量命令错误提示也不够友好。UX版本的重构围绕“用户体验”做了以下几项关键升级1. 上下文感知的主菜单与智能建议启动/friends命令后你看到的不是一个冰冷的命令列表而是一个经过分析后的“仪表盘”。它会评估你资料的完整度、社区活跃度并给出动态建议。例如如果你刚初始化完资料它会高亮“开始匹配”如果你的资料完整度低于50%它会建议你“编辑资料”或“智能增强”。这个功能是通过main.sh脚本分析本地状态文件实现的让工具具备了“主动思考”的能力。2. 渐进式引导与错误恢复这是我最欣赏的一点。任何操作失败都不会只抛出一个晦涩的错误码。例如如果你在未初始化时直接运行/friends match你会看到一个设计精美的错误卡片上面不仅用红色符号明确告诉你“未初始化”还会用清晰的步骤说明初始化能帮你做什么并直接给出修复命令/friends init。这种设计将“遇到错误”的挫败感转化为了“获得指引”的顺畅感。3. 视觉化的信息呈现抛弃了单调的命令行输出大量使用ASCII艺术框、进度条、颜色标记和Emoji。比如匹配结果会以“卡片”形式呈现清晰展示匹配度、共同兴趣和推荐理由协商过程会有进度条和阶段标识。这些视觉元素极大地提升了信息的可读性和交互的愉悦感。所有UI组件都模块化在ui.sh脚本中维护和扩展非常方便。4. 与GitHub的深度集成对于开发者来说手动维护一份最新的技能和兴趣列表是反人性的。UX版本的/friends profile enhance命令通过GitHub CLI (gh) 直接读取你GitHub账号的仓库语言分布、项目主题Topics以及你Star过的仓库通过一套简单的算法例如语言使用频率、主题聚合自动为你推荐标签。这不仅仅是“导入”更是“智能填充”能将资料完整度瞬间从20%提升到90%以上。3. 从零开始的完整部署与配置指南理论讲得再多不如亲手实践。下面我将带你走一遍从环境准备到成功匹配第一个好友的全流程其中包含了我踩过坑后总结的详细步骤和注意事项。3.1 环境准备与依赖安装Claw Friends UX的核心是Bash脚本因此对系统环境有基本要求。它主要依赖三个外部工具git,openssl, 和gh(GitHub CLI)。macOS (使用Homebrew)# 1. 安装Homebrew (如果尚未安装) /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 2. 安装必需依赖 brew install git brew install openssl brew install gh # 3. 验证GitHub CLI登录状态 gh auth status如果gh auth status显示未登录你需要运行gh auth login进行认证。这里有一个关键点在认证流程中它会问你是否愿意用HTTPS协议进行Git操作。我强烈建议选择“Yes”。因为后续的数据同步仓库很可能是一个私有仓库使用SSH密钥虽然可以但配置更复杂而HTTPS配合GitHub CLI的令牌管理更为稳定可靠。Linux (以Ubuntu/Debian为例)# 1. 更新包列表并安装依赖 sudo apt update sudo apt install -y git openssl # 2. 安装GitHub CLI # 首先下载并添加其签名密钥 curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of/usr/share/keyrings/githubcli-archive-keyring.gpg echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main | sudo tee /etc/apt/sources.list.d/github-cli.list /dev/null # 3. 再次更新并安装 sudo apt update sudo apt install -y gh # 4. 登录GitHub gh auth login注意在某些最小化安装的Linux服务器或Docker环境中可能默认没有安装curl或sudo。如果遇到问题请先确保这些基础工具可用。Windows (通过WSL2)在Windows上获得最佳体验的方式是使用WSL2Windows Subsystem for Linux。安装一个Ubuntu发行版然后在WSL的Linux环境中完全按照上述Linux的步骤进行操作即可。技能最终会安装在WSL的文件系统中但Claude for Desktop通常能正常调用WSL环境下的技能。3.2 三种安装方式详解与选择项目提供了三种安装方式适用于不同场景。方法一一键安装脚本强烈推荐这是最省心、错误率最低的方式。脚本install.sh封装了所有复杂逻辑。git clone https://github.com/bobosdaddy/claw-friends.git claw-friends-ux cd claw-friends-ux ./install.sh运行这个脚本后它会依次执行以下操作并在每一步给出明确提示依赖检查自动检测git,gh,openssl是否存在如果缺失会提示你安装命令在macOS上甚至会直接通过Homebrew安装。GitHub认证检查确认gh是否已登录。如果未登录会引导你启动gh auth login流程。目录定位自动检测你当前使用的AI助手Claude Desktop, Cursor, Windsurf等并将技能文件复制到对应的正确目录下例如~/.claude/skills/。后置操作询问复制完成后它会贴心地问你是否要立即运行初始化(/friends init)。对于首次安装的用户选择“是”可以无缝进入配置流程。这个脚本极大地简化了安装过程避免了因目录找错导致的技能不生效问题。我建议所有用户尤其是新手都采用这种方式。方法二手动安装适用于自定义或调试如果你希望将技能安装到非标准位置或者想研究其内部结构可以手动操作。git clone https://github.com/bobosdaddy/claw-friends.git claw-friends-ux # 假设你的Claude技能目录是 ~/.claude/skills/ cp -r claw-friends-ux ~/.claude/skills/claw-friends关键点在于复制过去的文件夹名称必须是claw-friends因为技能ID是根据目录名识别的。手动安装后你需要确保目标目录具有可执行权限chmod x ~/.claude/skills/claw-friends/scripts/*.sh。方法三项目级安装用于隔离环境如果你只在某个特定的代码项目中使用Claude并希望技能仅在该项目上下文中可用可以采用这种方式。# 在你的项目根目录下操作 git clone https://github.com/bobosdaddy/claw-friends.git claw-friends-ux mkdir -p .claude/skills cp -r claw-friends-ux .claude/skills/claw-friends这样当你在这个项目目录下启动AI助手对话时才能使用/friends命令。这适合用于为特定团队或项目配置专属的技能环境。3.3 初始化流程深度解析安装完成后在AI助手的输入框里键入/friends init就进入了正式的初始化引导。这个过程分为四步每一步都有其设计用意。第一步生成加密密钥对系统会使用openssl在~/.ocfr/keys/目录下生成一对RSA-2048密钥private.pem和public.pem。实操心得务必妥善备份~/.ocfr/这个目录你可以将其压缩加密后存放到安全的地方。如果你的私钥丢失所有用你公钥加密的消息都将无法解密且你的身份无法被恢复。虽然系统没有强制要求但这是保护你数字身份的关键。第二步创建个人资料你需要填写一份YAML格式的个人资料。主要包括username: 你在社区中的唯一标识建议使用GitHub用户名或容易记忆的ID。display_name: 显示名可以更个性化。skills: 你的技术技能列表如[rust, python, kubernetes]。interests: 你的兴趣领域如[open-source, distributed-systems, ai]。bio: 一段简短的自我介绍。 这里有个技巧skills和interests的填写直接关系到后续匹配的准确性。不要只写大而泛的标签如programming尽量具体如react,nodejs,postgresql。第三步加入社区网络这是最关键的一步。你需要输入一个Git仓库的URL这个仓库将作为你们社区的“公共电话簿”。通常项目的维护者或你的团队会提供一个这样的仓库。如果你是第一个用户或者想创建自己的小圈子可以新建一个空的GitHub私有仓库并将URL填在这里。 初始化脚本会尝试向这个仓库推送你的公开资料。如果失败比如没有写权限它会提示你手动发起一个Pull Request。这个过程确保了社区网络的去中心化治理——任何人都可以创建或加入一个网络。第四步智能导入GitHub数据可选但推荐系统会询问你是否立即运行/friends profile enhance。我强烈建议选择“是”。它会调用gh api接口分析你的GitHub数据并给出技能和兴趣的推荐列表。你只需要确认就能一键填充大部分资料非常高效。完成这四步后你的控制台会显示一个成功的ASCII艺术提示资料完整度也会从0%跃升到一个很高的值。此时运行/friends就能看到充满建议的主菜单了。4. 核心功能实战与高级技巧初始化完成后这个工具才真正开始发挥威力。下面我们深入几个核心功能看看如何用它来提升效率。4.1 智能匹配如何找到“对的人”/friends match是发现潜在好友的核心命令。其背后的匹配算法并不复杂但非常有效技能交集计算你与社区其他成员共同技能的数量和权重。兴趣相似度分析兴趣标签的重合度。资料完整度加权资料更完整的用户其标签可信度更高在匹配中会有轻微加分。排除已处理关系自动过滤掉已是好友、已发送请求或已被你屏蔽的用户。运行命令后你会看到一个类似Tinder卡片式的推荐列表每张卡片清晰展示了匹配度、共同点以及系统推荐的理由。匹配度87% ████████░░ 共同兴趣#rust #cloud-native #distributed-systems 技能互补3 项他们有你没有的技能 匹配原因你们都热爱 Rust 和云原生对方有丰富的 K8s operator 开发经验...高级用法/friends match --top 5只显示匹配度最高的前5位避免信息过载。/friends match --batch这是一个“懒人神器”。它会自动向匹配度最高的前3位用户发送好友请求。在你刚加入一个活跃社区想快速扩大网络时非常有用。当然使用前请确保你的个人资料已经足够吸引人。4.2 “自动协商”安全渐进地交换信息直接成为好友就能看到对方全部资料这显然不够隐私。Claw Friends UX设计了一个精妙的“自动协商”机制 (/friends auto username)。协商共分10轮每轮代表一个信任加深的阶段初期1-3轮交换基本的技能标签和兴趣领域。中期4-7轮分享一些公开项目链接或技术观点摘要。后期8-10轮可能涉及更具体的经验分享或非敏感的学习心得。每一轮双方的AI助手会基于当前阶段和对方已分享的信息自动生成一小段“见解”进行交换。整个过程是加密的、自动的。你可以在任何时候使用/friends auto status查看进度。这个设计模拟了人类社交中从陌生到熟悉的渐进过程在自动化的同时保留了可控性。4.3 资料维护与智能增强个人资料不是一成不变的。/friends profile系列命令提供了完整的维护能力/friends profile edit手动编辑资料YAML文件。/friends profile enhance定期运行此命令。你的GitHub动态在变化Star的新项目、创建的新仓库都会影响你的技能树。这个命令能确保你的社区形象与你最新的技术关注点同步。/friends doctor这是一个诊断命令。当遇到任何同步失败、消息解密错误等奇怪问题时首先运行它。它能检查密钥、资料文件、Git仓库状态等并给出修复建议。4.4 探索与搜索主动发现社区除了被动匹配你还可以主动探索社区。/friends explore以列表形式浏览所有社区成员。/friends explore -s rust筛选出所有技能中包含“rust”的成员。/friends explore -i open-source筛选出对“open-source”感兴趣的成员。/friends explore search进入交互式搜索模式可以组合多个条件进行查询。这个功能在你想寻找某个特定技术栈的专家进行交流时尤其有用。5. 故障排查与实战避坑指南即使设计得再完善在实际操作中仍可能遇到问题。下面是我在长期使用中总结的常见问题及其解决方案。5.1 依赖问题gh命令认证失败症状运行/friends profile enhance或/friends sync时提示GitHub API错误或认证失败。根因GitHub CLI (gh) 的登录状态失效或者使用了不支持API访问的认证方式如仅限Git操作的SSH密钥。解决运行gh auth status查看当前登录状态和令牌权限。如果未登录或权限不足运行gh auth login。在登录流程中当询问“What account do you want to log into?”时确保选择“GitHub.com”。当询问“How would you like to authenticate?”时选择“Login with a web browser”。这是最可靠的方式会授予完整的API访问权限。如果问题依旧尝试gh auth logout然后重新登录。5.2 同步冲突Git合并错误症状执行/friends sync时提示“自动合并失败”或“存在冲突”。根因你和社区其他成员几乎同时修改并推送了社区索引文件如community.yamlGit无法自动合并。解决不要慌张。冲突文件会被标记脚本会中止。手动进入本地的数据同步目录通常在~/.ocfr/sync_repo/使用git status查看冲突文件。冲突文件通常是文本文件YAML格式。用文本编辑器打开你会看到 HEAD,,这样的标记分别代表你的版本和远程版本。合并策略社区成员列表的冲突通常需要手动合并两个列表确保不重复。资料文件的冲突一般选择保留较新或更完整的版本。如果不确定可以联系冲突方通过Git提交历史找到对方用户名协商。解决冲突后执行git add .和git commit -m resolve merge conflict。回到AI助手再次运行/friends sync。避坑技巧为了减少冲突养成在修改个人资料后立即同步的习惯。同时避免长时间不同步否则拉取时可能面临大量变更增加冲突概率。5.3 消息无法解密症状收到新消息通知但查看时提示“解密失败”。根因你的本地私钥 (~/.ocfr/keys/private.pem) 丢失或损坏。对方使用了错误或过期的公钥为你加密消息。解决首先运行/friends doctor检查私钥文件是否存在且可读。如果私钥丢失且没有备份那么很遗憾之前用对应公钥加密的消息将永久无法解密。你需要重新初始化 (/friends init)这会产生新的密钥对但意味着你失去了旧的数字身份。如果是对方公钥问题你可以通过社区网络联系对方请对方更新他的公钥信息并重新发送消息。最重要的教训再次强调初始化后第一时间备份~/.ocfr/目录5.4 技能在AI助手中不显示或命令无效症状安装了技能但在AI助手的斜杠命令列表中看不到/friends或输入后无反应。根因技能文件未放置在AI助手正确的技能扫描目录下或文件权限不正确。解决确认安装目录不同AI助手的技能目录不同。Claude Desktop通常是~/.claude/skills/Cursor可能是~/.cursor/skills/。回顾你安装时选择的路径。检查目录结构确保技能目录名是claw-friends并且内部包含SKILL.md和scripts/文件夹。检查文件权限确保所有.sh脚本具有可执行权限。可以在技能根目录下执行chmod x scripts/*.sh。重启AI助手有时助手需要重启才能加载新技能。查看助手日志如果以上都正确问题可能更复杂。查看AI助手的应用日志寻找加载技能时的错误信息。5.5 性能问题社区成员过多导致同步慢症状社区发展到几百人后执行/friends sync或/friends explore时速度明显变慢。根因脚本需要处理大量的YAML文件解析和匹配计算在纯Bash环境下可能遇到性能瓶颈。优化建议利用筛选多使用/friends explore -s python这样的筛选命令而不是每次都加载全部成员列表。异步操作/friends sync可以放在后台运行。虽然脚本本身不支持后台但你可以在终端手动执行同步任务。本地缓存脚本本身已有缓存机制。如果仍感觉慢可以考虑为大型社区网络开发一个轻量级的本地索引数据库但这属于高级定制范畴了。经过以上步骤你应该已经能够顺利安装、配置并熟练使用Claw Friends UX了。这个工具的精妙之处在于它用一系列相对简单的技术Bash, Git, OpenSSL构建了一个真正实用、以隐私为核心的开发者社交层。它不试图取代LinkedIn或Twitter而是专注于解决AI助手时代的“身份上下文”问题让机器能更好地理解你并帮你连接到对的同行。