企业员工使用手册

3. 登录并安装企业技能中心

在工作平台完成登录并安装「互远 AI 企业技能中心」安装器技能

1. 适用角色

  • 企业员工

2. 前置条件

  1. 你已完成 2. 账号注册与加入企业,并已拿到 员工 API 密钥(界面常称为「个人登录秘钥」,形态为 hue_sk_...)。
  2. 本机或工作平台环境已安装 Node.js 与 npm(一键安装脚本会用它安装/升级 @huyuan-ai/cli)。
  3. 你使用的平台支持终端命令或 PowerShell(例如飞书虾 / OpenClaw 终端、WorkBuddy 对话或 Windows PowerShell)。

密钥获取页(安装脚本交互时也会提示):https://skills.xds365.com/company/keys

3. 登录企业技能库

登录成功后,一键安装脚本会调用 huyuan-ai-cli huyuan-skill init,自动安装默认技能 huyuan-ai-skill-installer(界面显示「互远AI技能仓库安装器」),无需再单独执行 huyuan-ai-cli huyuan-skill install。向导中可选择技能运行时:agents(OpenClaw/通用,~/.agents/skills)或 workbuddy~/.workbuddy/skills);也可事先设置环境变量 HUYUAN_SKILL_RUNTIME=workbuddy

3.1 平台 1:飞书虾 & OpenClaw(龙虾)

OpenClaw 入口:https://openclaw.feishu.cn/home

方式一:打开飞书虾终端

  1. 在顶部导航栏点击 终端

飞书虾终端入口示例

  1. 在终端中执行:
curl -fsSL "https://skills.xds365.com/install.sh" | bash
  1. 按提示粘贴 上一步获取的员工 API 密钥,完成校验与登录。

飞书虾终端安装与登录示例

  1. 成功时终端会显示企业名称、密钥有效期,并自动安装 huyuan-ai-skill-installer

安全提示:员工 API 密钥是企业专属访问凭证,请妥善保管,不要泄露给外部人员,也不要在群聊或代码仓库中明文传播。

3.2 平台 2:Workbuddy

方式 1:对话中新建任务

在 WorkBuddy 新建任务后,发送以下内容(自然语言 + 安装命令):

安装 irm "https://skills.xds365.com/install.ps1" | iex

WorkBuddy 对话安装示例

WorkBuddy 可能因安全沙箱无法直接执行 iex,此时会改用手动安装 CLI、登录并安装技能。若未自动完成,请改用下方 方式 2 在 PowerShell 中执行。

按提示粘贴员工 API 密钥;获取页:https://skills.xds365.com/company/keys

方式 2:PowerShell 中执行

在 Windows PowerShell(建议 5.1 及以上)中执行:

irm "https://skills.xds365.com/install.ps1" | iex

WorkBuddy PowerShell 安装示例

若提示执行策略受限,可在当前会话临时放宽后重试:

Set-ExecutionPolicy -Scope Process Bypass

若出现乱码或 # 类报错,多为脚本编码或执行策略问题;请确认使用 PowerShell 5.1+,并保持当前会话已执行上方的 Set-ExecutionPolicy

3.3 登录后验证

在终端执行:

huyuan-ai-cli whoami

应返回当前企业与员工身份信息;执行 huyuan-ai-cli huyuan-skill paths 可确认技能安装根目录与 skillRuntime

4. 使用「互远 AI 企业技能中心」

说明:「互远 AI 企业技能中心」指企业远程技能库整体能力;登录后已安装的 huyuan-ai-skill-installer 是访问该技能库的 CLI 助手。本节演示如何查看远程仓库中有哪些技能。

4.1 在飞书虾中查看远程技能

将以下内容发送给飞书虾:

帮我查看一下互远AI 远程仓库有哪些技能

或显式指定安装器技能:

使用技能 huyuan-ai-skill-installer,帮我查看一下互远AI 远程仓库有哪些技能

飞书虾查看远程技能列表示例

返回表格中的 slug 可用于后续安装指定技能(见下一篇文档)。

4.2 快速安装(对话代劳)

你也可以将 员工 API 密钥 直接发给飞书虾或 WorkBuddy,由其代为执行安装脚本并完成登录(效果与终端 / PowerShell 一键安装类似)。密钥仅限本人使用,请勿在群聊中明文发送。

5. 结果验证

  • huyuan-ai-cli whoami 返回当前账号信息。
  • 飞书虾 / 工作平台对话中可列出远程技能仓库(至少包含 huyuan-ai-skill-installer 等可见技能)。
  • 本地默认路径已存在安装器技能目录(例如 ~/.agents/skills/huyuan-ai-skill-installer 或 Windows 下 C:\Users\<你>\.agents\skills\huyuan-ai-skill-installer)。

6. 常见问题

6.1 登录失败或身份为空

请检查员工 API 密钥是否复制完整(以 hue_sk_ 开头)、是否在有效期内。勿误用企业密钥(huyuan-ai-...);员工场景应使用个人员工 API 密钥。确认后重新执行安装脚本。

6.2 Windows 下 irm | iex 报错

检查 PowerShell 版本与执行策略;若报 # 或中文乱码,请在本会话执行 Set-ExecutionPolicy -Scope Process Bypass 后重试安装命令。

6.3 安装后列表没有技能

请联系企业内负责同事确认该技能是否已授权到你的企业或账号,以及可见范围(全公司 / 私有)是否包含你。

6.4 安装后列表没有变化

请重启当前会话或刷新技能列表,再执行一次 whoami 或重新查询远程仓库。

7. 下一步