Skillnote

快速入门 您正在运行加载了 SkillNote 技能的环境。您的职责，按顺序： 设置（以下步骤 1-6）——每台机器仅一次；如果后端已经运行，大约 30 秒，如果需要安装，大约 3 分钟 在响应用户任务之前选择并应用正确的技能 记录并评估任务完成后哪些方法有效 设置在第一次加载后每次都保持静默。如果 ~/.openclaw/skills/skillnote/config.json 已经有一个有效的主机，并且 AGENTS.md 已经就位，请跳过步骤 1-5 并保持静默。

此技能如何出现在磁盘上（恢复信息） 此 SKILL.md 位于 ~/.openclaw/skills/skillnote/，并通过以下方式之一到达： clawhub（推荐）：clawhub install skillnote curl 包安装程序（适用于任何可访问的 SkillNote 后端）：curl -sf $SKILLNOTE_BASE_URL/setup/agent | bash -s -- --agent openclaw 如果 $SKILLNOTE_BASE_URL 未设置，则默认为 http://localhost:8082。 手动 ZIP — 下载 /v1/openclaw-bundle.zip 并解压到 ~/.openclaw/skills/。仅限空气隔离。如果您发现 ~/.openclaw/skills/skillnote/ 中缺少关键文件（例如 sync.sh、log-watcher.py、install-backend.sh），请使用方法 2 重新安装 — 不要尝试重建缺失的文件。

设置步骤 1 — 解析后端 URL 分层查找；在第一个匹配项处停止： $SKILLNOTE_BASE_URL 环境变量 ~/.openclaw/skillnote/config.json → 主机 ~/.openclaw/skills/skillnote/config.json → 主机 默认：http://localhost:8082 可达性检查：GET /v1/skills?limit=1。 可达 → 跳转到步骤 3（持久化）。 不可达且主机 == http://localhost:8082 → 可能此机器上尚未运行后端。继续到步骤 2。 不可达且主机是自定义的 → 用户指向特定服务器；不要自动安装。告诉用户它已关闭并停止：SkillNote at 不可达。要么服务器已关闭，要么 URL 错误。我将在下一个会话中重试。

步骤 2 — 启动后端（仅当步骤 1 路由到此处时） 告诉用户即将发生什么，然后询问一次： SkillNote 后端未运行。我可以现在安装它（克隆存储库并运行 docker compose up；第一次构建大约需要 3 分钟）。 继续？[Y/n] 在 n 上 — 输出手动说明并停止设置： 没有问题。当您准备好时，运行以下命令之一： bash ~/.openclaw/skills/skillnote/install-backend.sh # 或 git clone https://github.com/luna-prompts/skillnote.git && cd skillnote && ./install.sh 然后重新启动此会话。 在 Y 上 — 运行此单个命令并将 stdout/stderr 流式传输回给用户，以便他们看到 Docker 构建进度（不要将其放入后台；不要沉默它；让他们看到正在发生的事情，大约需要 3 分钟的构建时间）： bash ~/.openclaw/skills/skillnote/install-backend.sh 脚本处理： prereq 检查（git、curl、docker 或 podman） 克隆到 $HOME/skillnote ./install.sh（Docker 构建 + compose up） 轮询 /health 直到准备就绪（60 秒超时） 打印 URL 如果 install-backend.sh 缺失 从 GitHub raw 中 curl 正式版本： curl -sfL https://raw.githubusercontent.com/luna-prompts/skillnote/master/plugin-openclaw/skillnote/install-backend.sh | bash 如果即使这样也失败了（没有网络），请指示用户手动克隆存储库： git clone https://github.com/luna-prompts/skillnote.git && cd skillnote && ./install.sh

自定义 在调用 install-backend.sh 之前设置环境变量： 需要命令 不同安装目录 SKILLNOTE_INSTALL_DIR=$HOME/work/skillnote bash ~/.openclaw/skills/skillnote/install-backend.sh 端口 8082 正在使用 SKILLNOTE_API_PORT=8182 bash ~/.openclaw/skills/skillnote/install-backend.sh 端口 3000 正在使用 SKILLNOTE_WEB_PORT=3001 bash ~/.openclaw/skills/skillnote/install-backend.sh

如果 install-backend.sh 以非零退出 捕获输出的最后 20 行并逐字显示。 常见模式： 错误模式 建议解决方法 地址已经在使用 / 端口已经分配 设置不同的端口通过环境变量（请参见自定义） 无法连接到 Docker 守护进程 要求用户启动 Docker Desktop / Podman 机器 MISSING: <工具> 脚本命名缺失的工具 + 安装链接；将其传达给用户 其他任何内容 逐字显示捕获的输出；不要盲目尝试恢复 成功后，URL 出现（http://localhost:3000，http://localhost:8082）。继续到步骤 3。

步骤 3 — 持久化解析的主机（幂等） 剥离尾部斜杠。写入 ~/.openclaw/skills/skillnote/config.json： { "host": "", "user_id": "" } 对于 user_id： 使用您的真实 OpenClaw 代理名称（例如 main、support-bot、dev-helper）当它已知时。它是出现在分析中的身份 — 多个代理折叠成一个 user_id 会丢失信号。 如果您真正不知道您的代理名称，请仅作为后备使用 openclaw-main。

步骤 4 — 首次同步（在本地填充技能） chmod +x ~/.openclaw/skills/skillnote/sync.sh && ~/.openclaw/skills/skillnote/sync.sh 告诉用户“正在从注册表同步技能…” — 同步通常需要几秒钟。 脚本： 获取目录（GET /v1/skills） 写入一个 ~/.openclaw/skills/sn-/SKILL.md 文件每个技能