# LLM Wallet：本地优先的LLM凭证管理工具 > 一个本地优先的CLI和桌面应用，用于统一管理OpenAI、Groq、Ollama等LLM推理提供商的API密钥、模型名称和端点URL，数据完全存储在本地，零云同步、零泄露风险。 - 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm) - 发布时间: 2026-04-11T06:38:04.000Z - 最近活动: 2026-04-11T06:50:47.398Z - 热度: 141.8 - 关键词: LLM, 凭证管理, CLI工具, 本地优先, API密钥, OpenAI, 开发者工具, Tauri - 页面链接: https://www.zingnex.cn/forum/thread/llm-wallet-llm - Canonical: https://www.zingnex.cn/forum/thread/llm-wallet-llm - Markdown 来源: ingested_event --- ## 背景：LLM凭证管理的混乱现状 随着大型语言模型的普及，开发者和团队往往需要同时使用多个推理提供商：OpenAI的GPT系列、Groq的高速推理、本地的Ollama、Together AI的开源模型等等。每个提供商都有自己的API密钥、端点URL和模型名称，管理这些凭证很快变成了一场噩梦。 常见的混乱场景包括： - 散落在各处的.env文件，不知道哪个项目用的是哪个密钥 - 遗忘的API密钥，导致某个服务突然失效 - 过期的端点配置，排查半天才发现是base URL写错了 - 团队协作时，凭证通过不安全的渠道（如聊天软件）传递 a-simple-llm-wallet（简称llm-wallet）正是为解决这些问题而生的本地优先凭证管理工具。 ## 项目概述：一站式凭证管理 LLM Wallet是一个本地优先的CLI工具和macOS桌面应用，用于统一管理LLM推理提供商的凭证。它支持任何兼容OpenAI API格式的提供商，所有数据都存储在本地文件系统，不上传云端，也不进行任何网络同步。 项目的核心理念是： - **统一存储**：在一个地方管理所有提供商的凭证 - **本地优先**：数据完全存储在本地，零云同步、零泄露风险 - **即时测试**：一键验证凭证是否有效 - **便捷导出**：快速生成.env文件供其他项目使用 ## 核心功能详解 ### 1. 统一凭证存储 llm-wallet允许用户将任意数量的OpenAI兼容提供商凭证存储在一个地方。每个凭证记录包含： - **名称**：便于识别的自定义名称 - **Base URL**：API端点地址 - **API Key**：访问密钥（存储时部分掩码显示） - **模型名称**：默认使用的模型 - **上下文窗口**：模型的最大上下文长度 - **模态能力**：支持的输入/输出类型（文本、视觉、音频、嵌入、图像生成） 支持的提供商包括但不限于： | 提供商 | Base URL示例 | |--------|-------------| | OpenAI | https://api.openai.com/v1 | | Groq | https://api.groq.com/openai/v1 | | Together AI | https://api.together.xyz/v1 | | Ollama（本地） | http://127.0.0.1:11434/v1 | | LM Studio（本地） | http://127.0.0.1:1234/v1 | ### 2. 连通性测试 这是llm-wallet的杀手级功能之一。添加凭证后，用户可以立即测试base URL和API key是否有效： ```bash llm-wallet test ``` 该命令会发送一个最小化的请求到端点，验证凭证配置是否正确。这比在项目中配置半天才发现连不上要高效得多。 ### 3. 交互式聊天测试 除了简单的连通性测试，llm-wallet还提供了交互式多轮聊天功能： ```bash llm-wallet chat ``` 启动后，用户可以在终端中直接与模型对话，测试模型的响应质量和功能。这对于快速评估一个新提供商或新模型非常有用。输入exit或按Ctrl+C即可退出。 ### 4. .env文件导出 这是llm-wallet最实用的功能之一。用户可以将任意凭证导出为.env文件格式，直接用于其他项目： ```bash # 导出到stdout llm-wallet export # 写入文件 llm-wallet export -o .env # 使用通用OPENAI_*名称（兼容大多数工具和框架） llm-wallet export --generic -o .env ``` 导出格式支持两种模式： **前缀模式（默认）**： ```bash # LLM Wallet export — Groq GROQ_BASE_URL=https://api.groq.com/openai/v1 GROQ_API_KEY=gsk_... GROQ_MODEL=llama3-8b-8192 GROQ_CONTEXT_WINDOW=8192 GROQ_MODALITIES=text ``` **通用模式（--generic）**： ```bash OPENAI_BASE_URL=https://api.groq.com/openai/v1 OPENAI_API_KEY=gsk_... OPENAI_MODEL=llama3-8b-8192 ``` 通用模式特别有用，因为很多工具和框架都期望OPENAI_*格式的环境变量。 ## 数据安全与隐私 llm-wallet将数据安全放在首位： ### 本地存储 所有数据存储在： ``` ~/.llm-wallet/wallet.json ``` 这是一个普通的JSON文件，用户可以自行备份或迁移。没有遥测、没有分析、没有远程同步。 ### API密钥掩码 使用`show`命令查看凭证时，API key会被部分掩码显示，防止 shoulder surfing（旁人偷窥）。 ### 卸载选项 运行`./uninstall.sh`卸载时，系统会询问是否保留钱包数据。保留意味着下次安装时凭证自动恢复。 ## macOS桌面应用 除了CLI工具，项目还提供了一个原生的macOS桌面应用，使用Tauri 2 + React构建。应用特点包括： - **轻量级**：最终应用包仅约8MB，无Electron臃肿 - **主题支持**：提供浅色/深色主题 - **原生体验**：使用macOS原生UI组件 ### 安装桌面应用 1. 前往Releases页面下载LLM.Wallet.x.x.x.dmg 2. 打开.dmg文件，将LLM Wallet.app拖到/Applications文件夹 3. 由于应用未经过Apple公证，首次运行前需要在终端执行： ```bash sudo xattr -dr com.apple.quarantine /Applications/LLM\ Wallet.app ``` 4. 之后即可正常从启动台或Finder打开 ## CLI使用示例 ### 安装 ```bash git clone https://github.com/cwang0126/a-simple-llm-wallet.git cd a-simple-llm-wallet ./install.sh ``` install.sh会自动验证Node.js 18+、安装依赖、编译TypeScript，并全局链接llm-wallet命令。 ### 添加凭证 ```bash llm-wallet add ``` 交互式提示输入名称、base URL、API key、模型名称等信息。对于本地提供商（如Ollama、LM Studio），如果输入的URL缺少/v1后缀，CLI会自动警告并纠正。 ### 列出所有凭证 ```bash llm-wallet list ``` ### 查看特定凭证 ```bash llm-wallet show ``` ### 编辑凭证 ```bash llm-wallet edit ``` API key字段留空可保持现有值不变。 ### 删除凭证 ```bash llm-wallet delete ``` 删除前会要求确认。 ## 技术架构 llm-wallet采用TypeScript开发，CLI部分基于Node.js，桌面应用使用Tauri 2框架。Tauri是一个使用Web前端技术构建桌面应用的框架，相比Electron： - **更小的包体积**：Tauri应用通常只有几MB，而Electron应用动辄上百MB - **更好的性能**：使用系统原生WebView，内存占用更低 - **更强的安全性**：Rust后端提供了内存安全保证 ## 适用场景 llm-wallet特别适合以下场景： ### 1. 多项目管理 如果你同时在多个项目中使用不同的LLM提供商，llm-wallet可以作为单一事实来源，避免在每个项目中都维护一份.env文件。 ### 2. 团队协作 虽然llm-wallet本身不解决凭证共享问题，但它提供了一种标准化的凭证管理格式。团队成员可以使用相同的工具，导出统一格式的.env文件。 ### 3. 本地开发测试 在集成新的LLM提供商之前，使用llm-wallet快速测试连通性和模型响应，可以节省大量调试时间。 ### 4. 凭证轮换 当需要更换API key时，只需在llm-wallet中更新一次，然后重新导出到各个项目即可。 ## 局限性与改进建议 当前版本的llm-wallet还有一些可以改进的地方： - **加密存储**：目前凭证以明文JSON存储，虽然本地文件系统有一定保护，但增加可选的加密存储会更安全 - **凭证同步**：虽然不主张云同步，但提供可选的加密备份/恢复功能会有帮助 - **更多平台**：目前桌面应用仅支持macOS，Windows和Linux用户只能使用CLI - **团队协作功能**：如加密共享、权限管理等 ## 总结 a-simple-llm-wallet是一个专注于解决实际问题的轻量级工具。它没有试图成为全能的AI开发平台，而是做好一件事：安全、便捷地管理LLM凭证。 对于频繁切换不同LLM提供商的开发者来说，这个工具可以显著提升工作效率。本地优先的设计理念也符合安全敏感场景的需求——你的API密钥永远不会离开你的机器。 随着LLM生态的持续发展，类似的开发者工具将变得越来越重要。llm-wallet展示了一个好的开发者工具应该具备的特质：简单、专注、安全、易用。