> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 从市场发现与安装技能

> 搜索 ClawHub 兼容注册表、切换国内/国际镜像，一键安装并启用技能，对话中即可使用。

# 技能发现与市场镜像

## 你能得到什么

* **设置 → 技能 → 发现**：搜索内置与社区技能，一键安装。
* **技能市场镜像**：可选 **国际 (clawhub.ai)**、**中国 (讯飞 SkillHub)** 或 **自定义 URL**。保存前自动探测——不可达的注册表会 toast 提示且不会写入配置。
* **安装即启用**：成功后显示「已安装并启用」，写入目录启用列表——默认情况下无需改 agent 技能白名单。

## 操作步骤

<Steps>
  <Step title="打开发现页">
    进入 **设置 → 技能 → 发现**。
  </Step>

  <Step title="选择镜像（可选）">
    在发现页顶部打开 **技能市场镜像**，选择国际或中国镜像，或填写自定义 ClawHub 兼容地址。仅当注册表返回有效 JSON 时才会保存成功。
  </Step>

  <Step title="搜索并安装">
    输入关键词搜索，在卡片上点击 **安装**，等待成功 toast。
  </Step>

  <Step title="在对话中使用">
    新建或继续对话。已启用技能通过渐进式加载可用——除非你为 Agent 配置了显式技能白名单。
  </Step>

  <Step title="按需开启内置市场工具（可选）">
    在 **设置 → Agent → 能力 → 内置工具** 中，`skill_market` / `skill_manage` **默认关闭**——需要外部市场搜索或技能管理时再打开，节省 Turn1 token。使用 `/learn` 学习新技能时会自动启用管理工具。
  </Step>
</Steps>

<Note>
  **显式白名单**：若 Agent 配置了非空技能白名单，Discover 安装会自动将新技能加入该白名单，下一条消息即可在对话中使用。安装 API 传 `mount_to_agent: false` 可跳过目录启用与白名单采纳。
</Note>

## 配置技能环境变量

调用外部服务的技能会通过 `primary_env` / `requires.env` 声明密钥（如 `GOOGLE_API_KEY`）。配置方法：

1. 打开 **设置 → 技能**，点击技能卡片展开**详情面板**。
2. 在**环境变量**区域填写并保存。

配置统一存入**技能配置中心**——而不是写死在 SKILL.md 文件里。每次构建 Agent 时，Myrm 都会自动将已保存的配置与当前已安装技能**对账**：

* **已安装技能** → 环境变量在运行时正确注入。
* **已卸载/移除的技能** → 环境变量自动清理，无残留、无「幽灵密钥」。
* **改名技能** → 配置自动跟随新运行时名。

密钥以环境变量形式注入，永远不会出现在对话上下文中。

## 相关文档

* [技能创建](/docs/zh/tutorials/skill-creation) — 把对话沉淀为可复用技能
* [技能进化](/docs/zh/core-concepts/skill-evolution) — 安装后的自动改进与审批