安装与调用 LoomLoom
让 Agent 安装 LoomLoom 并连接你的账号，之后就可以用自然语言查找和使用 SkillApp。
安装前准备
准备一台可联网的电脑，以及能安装 Skill、调用本地工具的 Agent。本页提供 macOS、Linux 和 Windows 的安装入口。
| 安装的内容 | 用来做什么 |
|---|---|
| LoomLoom CLI | 连接平台，查询能力，提交任务并取回结果 |
| LoomLoom Skill | 指导 Agent 怎样安装、查找、创建和调用 LoomLoom 能力 |
| Agent | 通用 LoomLoom Skill 的位置 |
|---|---|
| Codex | ~/.codex/skills/loomloom（以你的实际配置为准） |
| WorkBuddy | ~/.workbuddy/skills/loomloom |
| Claude Code、OpenClaw 等 | 对应 Agent 的 Skill 根目录下的 loomloom 文件夹 |
1. 安装 LoomLoom
方式一：让 Agent 安装
按你的情况选一段提示词，复制给你正在使用的 Agent。
只使用市场里的 SkillApp（浏览器登录）
帮我安装 LoomLoom：运行 npm install -g @cogfoundry/loomloom，然后运行 loomloom login --server https://loomloom.shengsuanyun.com/loom/v1，浏览器登录胜算云后，最后运行 loomloom doctor 检查连接是否正常。
还要创建自己的 SkillApp（同时安装 LoomLoom Skill）
帮我安装 LoomLoom：运行 npm install -g @cogfoundry/loomloom，再把 LoomLoom 的 Skill 装到你自己（当前这个 Agent）里，然后运行 loomloom login --server https://loomloom.shengsuanyun.com/loom/v1，让我在浏览器登录胜算云，最后运行 loomloom doctor 检查连接是否正常。
浏览器登录不了（使用 API 密钥）
先打开 密钥页面，点击「创建 Key」，复制新建的密钥，再把【】里换成你的密钥：
帮我用胜算云 API 密钥连接 LoomLoom：先运行 npm install -g @cogfoundry/loomloom，再把 LoomLoom 的 Skill 装到你自己（当前这个 Agent）里，服务地址是 https://loomloom.shengsuanyun.com/loom/v1，密钥是【粘贴你的密钥】。配置好后运行 loomloom doctor 检查连接，回复里不要显示完整密钥。
浏览器登录时，依次完成：登录胜算云（手机号或微信扫码，未注册的手机号会自动注册）→ 点击「同意授权」→ 看到「请返回终端」后关掉页面，回到 Agent。Agent 告诉你连接正常，就装好了。
方式二：自己安装
npm
已有 npm，且 Skill 管理器支持你的 Agent 时，可以一次安装 CLI 和对应 Skill。下面以 Codex 为例，其他 Agent 的标识以管理器实际支持的选项为准。
npx @cogfoundry/loomloom@latest install --agent codex --yes
仅需 CLI 时，使用下面的命令；但这不会安装 Agent Skill。
npm install -g @cogfoundry/loomloom
loomloom --version
macOS / Linux
把路径替换为当前 Agent 的完整 Skill 目录，末尾保留 loomloom。
LOOMLOOM_SKILL_DIR="/absolute/path/to/your/agent/skills/loomloom"
curl -fsSL https://raw.githubusercontent.com/cogfoundry-labs/loomloom/main/scripts/install.sh | bash -s -- --skill-dir "$LOOMLOOM_SKILL_DIR"
默认安装在 Homebrew 可用时使用 Homebrew，否则使用官方 Release 安装方式；完成后检查安装反馈中的 CLI 和 Skill 路径。
Windows
在 PowerShell 中填写当前 Agent 的完整 Skill 目录，末尾保留 loomloom。
$LoomloomSkillDir = "C:\path\to\your\agent\skills\loomloom"
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/cogfoundry-labs/loomloom/main/scripts/install.ps1))) -SkillDir $LoomloomSkillDir
安装完成后，按反馈检查 CLI 路径和该目录中的 SKILL.md。
2. 连接你的账号
浏览器登录
没有成功健康连接账户时，让 Agent 发起登录，并在打开的浏览器中完成授权。
请帮我连接胜算云的 LoomLoom，先检查现有连接；需要登录时打开浏览器，完成后再检查连接。
自己操作时，可使用：
loomloom login --server https://loomloom.shengsuanyun.com/loom/v1
浏览器显示授权返回后，还要等 Agent 或终端确认登录检查成功。已有健康连接的用户无需重复登录。
使用 API Key
你也可以沿用快速使用中的 API Key 方式：打开密钥入口，创建并复制自己的密钥，再按 Agent 提示完成本地配置。
我要使用这个账号的胜算云 API Key 连接和使用 LoomLoom，请引导我安全配置，校验服务地址与密钥对应关系，保存后再检查。不要输出完整密钥，也不要运行付费任务。
API Key 用于认证。不要放进公开文档、截图或仓库。浏览器登录和 API Key 是两种认证路径，不要求每个用户都先创建密钥。仅登录网站不代表本地 CLI 已完成授权，仍需检查连接。
3. 检查安装与连接
让 Agent 检查 CLI、通用 Skill 和账号连接。
帮我确认 LoomLoom CLI 可用、你能读取 LoomLoom Skill，并检查当前服务和账号连接是否正常。
连接检查以 loomloom doctor --output json 的结果为准：healthy: true 表示当前连接健康。它不代表某个 SkillApp 已安装，也不代表任务已执行。
安装后找不到 CLI 时，按安装反馈检查程序是否在系统 PATH 中；Skill 读不到时，检查是否装到了当前 Agent 的目录。
4. 用一句话调用
| 你想做什么 | 对 Agent 说 |
|---|---|
| 找现成能力 | “帮我在 LoomLoom 里面找能整理商品文案的 SkillApp，比较输入、结果示例和费用。” |
| 准备一次任务 | “帮我安装并使用这个 SkillApp，先检查输入和报价，等我确认再运行。” |
| 批量处理 | “给我这个 SkillApp 的工作簿，我要把多份资料按行填写。” |
| 找回结果 | “帮我找到上次运行，把结果导入到当前对话，或下载结果工作簿和生成文件。” |
运行前仍需确认本次费用；安装与登录不会授权 Agent 直接执行付费任务。
详细操作见 查找SkillApp、安装与使用SkillApp 和 费用、报价和订阅。
5. 更新、卸载与重新配置
| 想做什么 | 处理方式 |
|---|---|
| 更新 | 让 Agent 根据原安装方式更新 CLI 和通用 Skill，再检查版本与连接 |
| 卸载 | 先说明要移除 CLI、通用 Skill 还是某个 SkillApp，再让 Agent 按原安装方式处理 |
| 换密钥 | 让 Agent 删掉本地的旧地址防止混淆。把新密钥发给 Agent，让它先验证，成功后再写入环境变量，最后确认连接健康 |
通过 npm 一次安装并记录 Agent 的用户，可以用 loomloom update --agent <安装时填写的 Agent 标识> 更新 LoomLoom；这不是所有安装方式都能使用的通用 CLI 子命令。脚本安装的完整更新与卸载方法见 官方安装指南。
出现 operation not permitted 时，先检查实际权限或 Agent 的运行限制，不能仅凭这一条报错认定网络和账号正常。