Pickbit 客户端使用指南

从 Pickbit 发布页下载与你系统匹配的安装包，安装桌面客户端是使用 Pickbit 的第一步。客户端负责安装 Hermes Agent、配置模型，并提供对话、技能、网关等图形界面。

• macOS：.dmg（支持 Apple Silicon 与 Intel）
• Windows：.exe（Windows 10 / 11）
• Linux：.AppImage、.deb 或 .rpm

Windows 首次运行可能遇到 SmartScreen 提示，选择「仍要运行」即可。安装完成后启动 Pickbit，将进入欢迎与初始化流程。

首次打开 Pickbit 后，应用会依次经过启动页、欢迎页、Hermes 安装与提供商配置，最后进入主工作区。本地模式下，Agent 与数据默认存放在 ~/.hermes。

1. 1启动页：展示品牌标识，同时在后台检查本机安装状态。
2. 2欢迎页：点击「开始使用」，进入 Hermes 组件安装（约需 2 GB 磁盘空间）。
3. 3安装前确认：应用会说明将写入 ~/.hermes，并提示是全新安装、版本更新，还是替换无效目录。
4. 4安装进度：按步骤拉取 Hermes 核心与依赖；失败时可展开日志、复制诊断信息，或按页面提示改用终端安装后返回重试。
5. 5安装完成：点击「继续」进入「设置你的 AI 提供商」页面。

Setup 页面标题为「设置你的 AI 提供商」。选择一种接入方式并填写必要信息，保存后即可开始对话。配置会写入 ~/.hermes 下的 .env 与 config.yaml。

• OpenRouter（推荐）：一个 Key 接入 200+ 模型
• Anthropic：直连 Claude 系列
• OpenAI：直连 GPT 系列
• Google（Gemini）、xAI（Grok）、Nous Portal
• 本地 / OpenAI 兼容：LM Studio、Ollama、vLLM、llama.cpp 等任意兼容端点

1. 1选择提供商卡片。
2. 2云端 API：粘贴 API Key（页面提供「还没有 Key？点此获取」跳转）。
3. 3本地服务：填写 Base URL 与模型名称；本地通常无需 Key，但请先确认 LM Studio / Ollama 等服务已启动。
4. 4点击「继续」保存并进入主界面。

完成 Setup 后进入主工作区。左侧为主导航，右上角齿轮打开「设置」模态（设置不在侧栏列表中）。以下为各入口用途：

• 对话：流式聊天、工具执行进度与积分用量展示
• 发现：浏览 Agent、MCP、Skills、工作流等社区目录并安装
• 办公室：Claw3D 可视化工作空间
• 看板：任务看板与执行状态
• 技能：管理已安装技能，浏览并安装内置技能
• 任务：创建与管理定时任务（Cron）及消息投递
• 连接：配置微信、钉钉、飞书等消息平台接入

「对话」是日常使用最频繁的界面。首次进入会看到 Agent 自我介绍与使用提示；左侧可切换 Agent、浏览历史会话或新建 Agent。

1. 1在输入框用自然语言描述任务，发送后 Agent 会流式回复并展示工具调用进度。
2. 2点击会话列表可恢复历史对话；支持搜索过往会话。
3. 3打开 Agent 详情侧栏可编辑人格（SOUL.md）、管理记忆条目、查看已启用工具。
4. 4输入 /help 可查看应用内斜杠命令列表；例如可用命令快速切换模型或清理上下文。

Pickbit 通过 Skills 扩展 Agent 能力；「发现」页提供社区目录，与「技能」页的已安装列表互补。

1. 1技能 → 浏览：搜索并安装内置技能目录中的条目。
2. 2技能 → 已安装：查看、卸载当前 Agent 已装载的技能。
3. 3添加技能：可通过「通过对话创建」让 AI 分步引导生成技能，或「从 GitHub 导入」粘贴仓库链接。
4. 4发现：按分类浏览 Agent、MCP、Skills、工作流，一键安装到当前环境。

通过消息网关，你可以在微信、钉钉、飞书、Telegram、Discord 等平台远程向桌面 Agent 下发任务并接收回复，实现 7×24 远程指挥。

1. 1打开「设置 → Pickbit」，确认「消息网关」处于运行中；若已停止，先点击启动。
2. 2进入侧栏「连接」，在平台列表中打开需要的 IM / Webhook 渠道。
3. 3按各平台说明填写 Token、Webhook 等配置项（失焦后自动保存）。
4. 4在手机或 IM 客户端向 Pickbit 发送消息，即可远程触发桌面 Agent 工作。

支持的平台包括 Telegram、Discord、Slack、WhatsApp、Signal、Matrix、钉钉、飞书、企业微信、微信、邮件、短信、Webhooks、Home Assistant 等（以客户端列表为准）。

点击主界面右上角齿轮打开设置。左侧分栏涵盖账号、引擎、模型、网络与日志等；上次打开的分栏会被记住。

• 我的账号：Platform 登录与资料（可选）
• 通用：主题、语言、输出目录、应用更新、隐私与通知
• 用量统计：积分与调用用量
• Pickbit：消息网关启停、引擎更新、Doctor、配置健康、MoA
• 迁移与备份：数据备份、还原与迁移工具
• 工具：启用 / 禁用各 toolset，跳转发现安装 MCP
• 连接模式：本地 / 远程 / SSH（高级）
• 模型 / 提供商：模型目录与 API Key 管理
• 网络：代理与 IPv4 偏好
• 日志：查看 gateway.log、agent.log、errors.log

日志文件位于 ~/.hermes/logs/。遇到安装或网关异常时，可先查看 errors.log，再结合设置内的复制日志功能反馈问题。

• 安装一直失败：检查网络能否访问 Gitee，确认已安装 Git（macOS 可安装 Xcode 命令行工具），并保证磁盘空间充足。
• 安装完成但检测不到 Pickbit：等待数秒后重试，或重新运行安装流程。
• Launchpad 两个 Pickbit 图标：删除多余 Pickbit.app 副本，仅保留应用程序文件夹内一份。
• Gateway 无法启动或端口冲突：默认占用 8642 端口，请关闭占用该端口的其他 Hermes / Pickbit 实例后重启应用。
• 聊天报 API Key 错误：到「设置 → 提供商」核对 Key，或运行配置健康检查同步 .env 与 config.yaml。
• IM 连不上：确认消息网关为「运行中」，并核对各平台 Token / Webhook 是否填写完整。