用途:把“想用得到大脑”推进到真正可执行状态,处理首次安装、登录授权、连接诊断、额度查看、CLI 升级与领域 Skill 同步。
主要能力与用法:
- 首次安装:用 command -v getnote 检查 CLI;缺失时检查 node --version、npm --version,并执行 npm install -g @getnote/cli@latest;再执行 getnote version 确认可启动。独立的 ClawHub/OpenClaw Skill 由平台管理 CLI 依赖,不运行 scripts/install.sh。
- 授权:执行 getnote auth status,未登录时运行 getnote auth login,用户只在浏览器中确认,不索要 API Key、Cookie 或 Authorization;auth status 只显示掩码。
- 诊断:执行 getnote doctor -o json,只有 diagnostics_completed=true、ready=true、status=ready 才算完整连接;degraded 表示核心可用但有警告,partial 多为 --offline 跳过远端检查。未就绪先处理 issues[].blocking=true,再按 next_actions[] 修复,需确认的动作先征得同意。
- 领域 Skill 同步:在 Codex、Claude Code、Cursor 等本地 Agent 中执行 getnote setup 同步 5 个领域 Skill。
- 验收:先用 getnote notes --limit 1 -o json 做无写入验收,用户同意后才创建测试笔记。
- 日常命令:auth login/status/logout、doctor -o json、capabilities -o json、setup、quota -o json、version、update --check、update。参数不确定时读取 --help。
- 更新闭环:getnote update --check 有新版或需刷新 Skills 时执行 getnote update,命令会升级 CLI 并由新版 CLI 自动运行 setup 和 doctor;仅升级 CLI 用 --cli-only。ClawHub/OpenClaw 托管的独立 Skill 由平台更新。
适用场景:安装登录得到大脑、排查“为什么不能用”、查看 AI 对话额度、升级 CLI、为本地 AI 同步领域 Skill。
限制与判定:所有命令以退出码为第一判断,非 0 即失败;-o json 的错误返回 success=false、data=null、error.code/message/reason/retryable 和可选 request_id,HTTP 200 不等于成功。不展示或记录完整凭证;用户未明确要求时不退出登录;授权超时或验证码过期时重新发起登录,不复用旧 code。失败时保留步骤、原因和 request_id。quota 按 data.read/write/write_note 下 daily/monthly 的 limit/used/remaining/reset_at 说明,不自行换算或合并桶。platforms[] 仅表示检测到应用或命令,不能证明 Skill 已安装,需用 integrations[].skill_status/ready 判断。具体收费、价格与平台支持范围资料未提供。