Keet CLI

概述

在操作或改进 keet-cli 项目（用于 Keet Messenger 及 Keet ↔ OpenClaw 桥接工作流）时，使用本技能。

默认采用只读检查模式。将所有实时 Keet 个人资料数据和私密聊天内容视为敏感信息。不得泄露密钥、恢复材料、私密消息、邀请/个人资料代码，或生成的桥接状态。

使用前请务必验证项目源码：https://github.com/projectreturn/Keet-cli。

必需的安全守门机制

执行任何外部操作或状态变更操作前，必须获得用户对以下各项的明确确认：

• 精确的 Keet 个人资料/存储路径，
• 精确的目标聊天或房间，
• 精确的外发消息/操作内容，
• 该操作是否可能启动长期运行的进程，
• 推送前 Git 仓库、分支及提交差异（commit diff）的精确信息。

除非用户明确要求执行对应操作，否则禁止加入邀请、创建聊天、路由额外聊天、打印恢复/账户材料，或推送代码。

快速工作流

1. 定位项目仓库。常见默认路径：/openclaw/workspace/keet-cli。
2. 使用前验证来源可信性与本地状态：

git remote -v
git status --short --branch
npm run lint
node src/cli.js --help

3. 优先使用只读命令。
4. 在执行任何 send、bridge、daemon、invite、chat 或 Git 推送操作前，确认全部所需安全守门机制已通过。
5. 完成编辑后，在报告完成前运行 npm run lint 并检查 git diff。

只读命令

除非用户指定其他检出路径，否则均在仓库根目录下执行。

npm run lint
node src/cli.js --help
node src/cli.js inspect
node src/cli.js rooms
node src/cli.js messages --limit 10
node src/cli.js tui

仅当用户提供或确认了路径时，才覆盖 Keet 存储路径：

KEET_APP_STORAGE=/confirmed/path/to/app-storage node src/cli.js inspect

状态变更命令

仅在用户明确确认个人资料、目标聊天及具体操作后，方可执行以下命令：

node src/cli.js send '已确认的消息文本'
node src/cli.js send-file --caption '已确认的说明文字' /confirmed/file/path
node src/cli.js bridge
node src/cli.js daemon --socket .keet-cli.sock
node src/cli.js daemon-send --socket .keet-cli.sock current
node src/cli.js watch --interval 2000

对于 send-file，发送前须确认文件路径、目标聊天及说明文字；对于 watch、daemon、supervisor 或桥接模式，需向用户说明该进程是否会持续运行，以及如何终止它。

敏感数据规则

• 将 Keet 个人资料存储、账户/恢复材料、私钥、令牌、邀请/个人资料代码、桥接状态及含私密消息的日志，全部视为敏感数据。
• 禁止提交实时 Keet 个人资料存储、生成的状态文件、日志、私密聊天截图或复制的私密消息。
• 除非用户明确要求检查特定消息，否则避免打印消息内容。
• 在摘要与错误信息中，对密钥及私密消息内容进行脱敏处理（redact）。
• 在共享/群组上下文中，不得暴露用户专属的聊天名称、密钥、路径、消息内容或操作细节。

存储锁模型

Keet Desktop 与 keet-cli 不应同时访问同一份实时存储。Keet 使用设备文件/FD 锁保护数据库。

若因锁机制导致命令失败，请按以下步骤排查：

1. 检查 Keet Desktop 或其他 keet-cli 进程是否已在使用该个人资料。
2. 优先通过 daemon --socket .keet-cli.sock 显式批准一个长期运行的主控进程，并将 CLI/桥接操作统一经由 daemon-send 路由，而非启动相互竞争的会话。
3. 未经用户明确批准，不得终止用户进程。

TUI 模式

仅在确认无其他实时 Keet 主控进程使用相同存储的前提下，方可启用 TUI 模式进行交互式本地检查：

node src/cli.js tui

TUI 支持列出房间、选择房间、查看近期消息及发送消息。其中“发送”属于状态变更操作：发送前须先确认目标聊天及确切消息内容。

守护进程 / REPL 模式

仅当需要重复执行读取/发送操作，且用户已批准启动长期运行进程时，方可启用守护进程模式：

node src/cli.js daemon --room ROOM_ID --socket .keet-cli.sock

常用 REPL 命令：

/status
/messages 10
/send 已确认的消息文本
/send-md **已确认** _markdown_
/send-file /confirmed/file/path 已确认的说明文字
/rooms
/current
/use ROOM_ID
/quit

套接字（socket）自动化调用每次仅接受一条 JSON 命令：

node src/cli.js daemon-send --socket .keet-cli.sock status
node src/cli.js daemon-send --socket .keet-cli.sock send '{"text":"已确认的消息","format":"plain"}'
node src/cli.js daemon-send --socket .keet-cli.sock send-file '{"filePath":"/confirmed/file/path","caption":"已确认的说明文字"}'

当存在默认守护进程套接字时，send 和 send-file 将优先尝试通过守护进程执行；若失败，则回退至直接 Core 会话。可通过设置 KEET_CLI_NO_DAEMON=1 强制使用直接模式，或设置 KEET_CLI_DAEMON_STRICT=1 使失败时不回退而直接报错。

此举可避免独立的 watch、send 和 send-file 进程之间产生冲突。

Watch 模式

仅在用户确认个人资料与聊天范围后，方可启用 Watch 模式：

node src/cli.js watch --interval 2000

默认忽略本地/自身发出的消息。仅在调试确有需要时，才使用 --include-local 参数。

Keet ↔ OpenClaw 桥接

首次调试时，请以前台方式运行桥接：

node src/cli.js bridge
node src/cli.js bridge --daemon-socket .keet-cli.sock --config bridge.config.json

仅在用户确认需要持久化进程后，方可启用 supervisor/container 模式。

当守护进程已拥有 Keet 个人资料时，优先使用 --daemon-socket。在此模式下，桥接将复用已有守护进程，而非自行启动 Core 侧车（sidecar）。

一个安全的桥接实现必须满足以下要求：

• 默认禁用多房间路由功能，
• 仅转发配置白名单中显式批准的聊天，
• 上报邀请/成员事件但不自动加入或响应，
• 当目标聊天不明确时，以失败关闭（fail closed）方式处理，
• 除非调试需要，否则忽略自身/本地回显消息，
• 持久化足够状态，以避免重复回复并维持选定的模型模式，
• 在配置启用时，本地处理 Keet 音频消息：仅从 Keet 的本地文件链接下载、使用本地 Whisper 进行转录，并转发转录文本而非原始音频，
• 支持显式的模型切换命令，例如 lokal、online 和 modell status，
• 禁止记录私密消息内容或密钥，
• 任务完成后提供停止命令或自动终止。

发布检查清单

发布或公开前，请执行以下检查：

npm run lint
git status --short --branch
git diff --stat
git log --oneline -5

执行任何 Git 推送前，须确认将使用的仓库、分支、差异（diff）以及凭证/身份。禁止在公开技能内容中嵌入私钥路径或打印私钥。