4. 安装并使用技能
安装业务技能并在飞书虾、WorkBuddy 对话或终端中完成调用、验证与自动更新
1. 适用角色
- 企业员工
2. 前置条件
- 你已完成 3. 登录并安装企业技能中心。
- 登录脚本已自动安装默认技能
huyuan-ai-skill-installer（界面显示「互远AI技能仓库安装器」），无需再单独执行安装命令安装该技能。 - 若尚未查看过远程技能列表，可先阅读上一篇 4.1 在飞书虾中查看远程技能，确认目标技能的 slug 后再安装。
3. 安装业务技能
登录企业技能库后，可通过对话或终端安装各类 AI 技能（业务技能）。互远 AI 企业技能中心指企业远程技能库整体能力；huyuan-ai-skill-installer 是访问该技能库、代为执行安装与列表查询的助手技能。
3.1 默认与推荐技能
查看技能列表
在飞书虾 / WorkBuddy 的输入框发送：
帮我查一下互远AI技能仓库的技能有哪些即可查看当前账号可见的全部技能列表。返回表格中的 slug 可用于后续安装；界面示例见 第 3 篇 §4.1。
默认已安装（登录时自动完成）
| 显示名 | slug | 用途 |
|---|---|---|
| 互远AI技能仓库安装器 | huyuan-ai-skill-installer | 查看远程技能列表、安装与更新其他技能 |
按需推荐（示例）
| 显示名 | slug | 用途 |
|---|---|---|
| 日志生成 | huyuan-ai-daily-work-log | 通过对话整理今日工作日志 |
| 日志提交 | huyuan-ai-daily-work-log-submit | 将工作日志写入飞书多维表格 |
| 技能创建 | huyuan-ai-skill-creator | 创建、编辑和优化 Agent Skills |
其他技能请按岗位需要从远程仓库中选择安装，不必一次安装全部。
3.2 在飞书虾 / OpenClaw（龙虾）中安装
OpenClaw 入口：https://openclaw.feishu.cn/home
- 若不知道要安装的 slug，先按上一篇 查看远程技能列表，在返回表格中记下目标 slug。
- 将安装请求发送给飞书虾，例如安装「日志生成」技能：
帮我安装技能 huyuan-ai-daily-work-log也可使用中文名称（Agent 会结合安装器技能解析）：
帮我安装「日志生成」技能- 安装完成后，用下列话术确认远程列表中已出现该技能（与第 3 篇用语一致）：
帮我查看一下互远AI 远程仓库有哪些技能或显式指定安装器：
使用技能 huyuan-ai-skill-installer，帮我查看一下互远AI 远程仓库有哪些技能列表截图与说明见 第 3 篇 §4.1。
提示：若需日报完整流程，建议依次安装
huyuan-ai-daily-work-log与huyuan-ai-daily-work-log-submit，每安装一个技能后先验证列表再装下一个。
3.3 WorkBuddy 中安装
在 WorkBuddy 新建任务后，发送与飞书虾相同的安装话术（见 §3.2 示例）。若因安全沙箱无法代装，请改在 Windows PowerShell 或本机终端完成登录与安装，参见 第 3 篇 · Workbuddy。
3.4 CLI 备选（高级）
本机已登录且 huyuan-ai-cli whoami 能返回身份信息时，可在终端执行：
huyuan-ai-cli huyuan-skill install <slug>示例：
huyuan-ai-cli huyuan-skill install huyuan-ai-daily-work-log- 将
<slug>替换为远程列表中的技能标识（与 §3.2 表格一致）。 - 若提示身份或权限不符，请先执行
huyuan-ai-cli whoami确认密钥有效，并参阅 第 3 篇常见问题。 - 建议按优先级逐个安装并在对话中验证，不要一次性安装全部技能。
3.5 基础配置完成
当你已具备 安装器 以及当前工作所需的 业务技能 后，飞书虾 / OpenClaw 的基础技能配置即告完成。更多企业专属技能与权限说明，请联系企业内管理员。
4. 使用技能
安装完成后，在飞书虾、WorkBuddy 或其他支持 Agent Skills 的对话环境中即可调用已安装技能。
4.1 显式调用
在与 Agent 的对话中输入：
使用技能 <名称或 slug>将 <名称或 slug> 替换为技能中文名或 slug（如 日志生成、huyuan-ai-daily-work-log）。显式调用适合任务边界清晰、需要指定技能行为的场景。
4.2 自然语言触发
部分场景可直接描述需求，由 Agent 路由到合适技能，例如：
- 「帮我写今日工作日志」→ 可能触发
huyuan-ai-daily-work-log - 「帮我把日志写入飞书多维表格」→ 可能触发
huyuan-ai-daily-work-log-submit - 「帮我查看一下互远AI 远程仓库有哪些技能」→ 通过安装器列出可见技能
复杂或多步骤任务仍建议使用 §4.1 的「使用技能」显式指定，以减少误触发。
4.3 示例
| 输入示例 | 预期效果 |
|---|---|
| 使用技能 日志生成 | 触发 huyuan-ai-daily-work-log，整理工作日志 |
| 使用技能 huyuan-ai-daily-work-log | 同上（按 slug 指定） |
| 使用技能 日志提交 | 触发 huyuan-ai-daily-work-log-submit，写入飞书多维表格 |
| 使用技能 huyuan-ai-daily-work-log-submit | 同上（按 slug 指定） |
| 使用技能 huyuan-ai-skill-creator | 进入技能创建与优化流程 |
| 帮我查看一下互远AI 远程仓库有哪些技能 | 列出当前账号可见的远程技能（安装器） |
5. 结果验证
- 执行 §3.2 中的列表查询话术，返回表格中包含你刚安装的 slug。
- 至少完成一次 §4.1 或 §4.3 中的「使用技能」调用，并得到符合预期的输出（例如日志草稿、写入成功提示或技能列表）。
- （可选）终端执行
huyuan-ai-cli whoami仍返回有效身份信息；本地存在对应技能目录（如~/.agents/skills/<slug>）。
6. 常见问题
6.1 提示无权限安装技能
请联系企业内负责同事确认该技能是否已授权到你的企业或账号，以及可见范围是否包含你。亦可参阅 第 3 篇 · 安装后列表没有技能。
6.2 技能安装成功但调用失败
先重启当前会话（或新建对话）后，用 使用技能 <slug> 重新调用。若仍失败，检查该技能是否要求额外参数（如飞书表格 ID、日期范围）或外部依赖（飞书登录、网络权限）。
6.3 安装后列表没有变化
请重启会话或刷新技能列表，再执行一次列表查询或 whoami。详见 第 3 篇 · 安装后列表没有变化。
6.4 一次安装太多技能难以排查
按 §3.4 建议逐个安装：每装一个技能 → 列表确认 → 对话中试调用一次 → 再装下一个。
7. 技能自动更新
远程技能库会持续发版。你可以通过飞书虾 / WorkBuddy 的定时任务，让 Agent 在每天固定时间自动检查并更新本机已安装技能，并通过私信收到更新摘要。
7.1 前置条件
- 你已完成 3. 登录并安装企业技能中心，且终端执行
huyuan-ai-cli whoami能返回有效身份信息。 - 你已按 §3 安装至少一个业务技能（除默认安装器外）。
- 你使用的飞书虾 / OpenClaw 或 WorkBuddy 支持创建定时任务。
7.2 复制以下话术创建定时任务
将下面整段复制到飞书虾对话，或在 WorkBuddy 新建任务后粘贴发送：
请帮我创建一个定时任务，名称为 huyuan-skill-daily-update，每天早上 3:00（北京时间）执行。
任务内容：
1. 执行 huyuan-ai-cli huyuan-skill check 检查所有已安装技能的可更新情况
2. 如果有可更新的技能，全部执行 huyuan-ai-cli huyuan-skill update <slug> 进行更新
3. 整理更新结果（哪些更新了、从什么版本到什么版本、有无失败）
4. 通过私信发送更新结果给我飞书虾 / OpenClaw：OpenClaw 入口 https://openclaw.feishu.cn/home，在对话中粘贴上述话术即可。
WorkBuddy：新建任务后粘贴同一话术。若 Agent 因沙箱无法执行 CLI，请先在 Windows PowerShell 或本机终端完成登录，参见 第 3 篇 · WorkBuddy。
建议：每位用户仅保留一个名为
huyuan-skill-daily-update的定时任务，避免同一时刻重复触发更新。
7.3 结果验证
- 任务创建后的次日 3:00（北京时间）之后，你应收到一条私信，摘要说明：无可更新技能，或已更新技能的 slug 与版本变化（from → to），以及失败项（如有）。
- （可选）在终端手动执行
huyuan-ai-cli huyuan-skill check，确认本地版本与远程一致。
7.4 常见问题
7.4.1 私信显示「无可更新技能」
说明本机已安装技能均为最新版本，无需操作。你可继续等待下一周期自动检查。
7.4.2 部分技能更新失败
私信摘要中会列出失败 slug 及原因。常见原因：该技能已下架或你无安装权限、网络异常。请确认远程列表中该技能仍可见（参见 第 3 篇 §4.1），再手动执行：
huyuan-ai-cli huyuan-skill update <slug>7.4.3 check 或 update 提示密钥无效
员工 API 密钥可能已过期或被删除。请重新登录，参见 3. 登录并安装企业技能中心。请勿在群聊中明文发送密钥。
7.4.4 如何停用自动更新
在飞书虾或 WorkBuddy 中暂停或删除名为 huyuan-skill-daily-update 的定时任务即可。技能中心侧无需额外操作；需要时可再次粘贴 §7.2 话术重新创建。
7.4.5 WorkBuddy 无法代执行 CLI
改在本机 PowerShell 或终端完成登录与 CLI 操作（见 第 3 篇），或仅在飞书虾 / OpenClaw 中配置定时任务。
7.5 CLI 手动检查与更新（可选）
除定时任务外，你也可在终端手动维护，参见 §3.4：
huyuan-ai-cli huyuan-skill check
huyuan-ai-cli huyuan-skill update <slug>8. 下一步
- 若你正在打包发布技能，可选用
_huyuan_skillhub_meta.json自动登记分类标签与展示名，详见 5. 打包发布技能与同事安装 · §4.4。 - 继续阅读 5. 打包发布技能与同事安装。
- 需要回顾登录与查看远程列表，请回看 3. 登录并安装企业技能中心。