什么是 HIPC Config Manager？

HIPC Config Manager 是一个基础工具，旨在处理 HIPC 生态系统的敏感访问凭据。它作为主要的看门人，确保任何尝试与 HIPC 业务服务（如查询计算机列表或收集运行时统计信息）交互的 AI 智能体都拥有有效且格式正确的密钥。通过在 Openclaw Skills 框架内使用此工具，开发人员可以确保鲁棒的错误处理和凭据安全。

该技能在本地持久化数据，提供了一种无缝的方式来检查、设置和验证密钥，而无需冗余的用户提示。它的设计旨在通过在执行任何下游数据操作之前强制执行强制性的预检查阶段，来防止工作流中断。

下载入口:https://github.com/openclaw/skills/tree/main/skills/377739442/hipc-config-manager

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

HIPC Config Manager 应用场景

• 在执行远程管理任务之前自动验证 API 凭据。
• 通过自然语言命令安全地存储和更新 HIPC 密钥。
• 验证密钥格式（例如前缀检查）以防止生产环境中的运行时错误。
• 在开发和生产环境之间切换以进行 HIPC 服务测试。

1. AI 智能体发起 check 操作，以验证本地配置文件中是否存在有效的 hipc_secret。
2. 如果密钥缺失，工作流将停止并提示用户提供必要的凭据。
3. 收到密钥后，该技能将执行基于正则的格式验证（确保符合 Digital_String 模式）。
4. 验证通过的凭据将保存到本地 hipc_config.json 文件中，以便持久访问。
5. 未来的请求将使用 check 状态来授权执行特定的业务技能。

HIPC Config Manager 配置指南

要将此组件集成到您的 Openclaw Skills 环境中，请确保您拥有所需的脚本目录并执行以下命令结构：

# 检查现有配置
python scripts/main.py --action=check

# 为生产环境设置新的 API 密钥
python scripts/main.py --action=set --secret="YOUR_KEY_HERE" --env="prod"

HIPC Config Manager 数据架构与分类体系

该技能管理一个本地 JSON 文件以维持状态。数据结构如下：

技能名称：hipc_config_manager HIPC 配置管理

技能描述

此技能是 HIPC 系列技能的核心前置组件，用于管理 API 密钥（hipc_secret）的生命周期。它具备检查、设置和格式校验三种能力，确保在执行任何业务查询前，系统拥有合法且格式正确的访问凭证。

?? 强制前置检查 (Critical Pre-check)

在调用任何 HIPC 业务技能（如查询电脑列表、统计数据）之前，你必须先调用本技能！

1. 第一步：调用 hipc_config_manager，设置参数 action="check"。
2. 判断：
   • 如果返回 status: "error"（即密钥缺失），立即停止后续业务操作，直接向用户发送一条消息，提示需要配置密钥。
   • 严禁在密钥缺失的情况下调用其他 HIPC 技能。
   • 严禁陷入死循环检查，检查失败一次后必须反馈给用户。
   • 只有当返回 status: "success" 时，才允许继续执行用户请求的业务逻辑。

核心逻辑与依赖

本技能通过读写本地文件 hipc_config.json 来持久化存储密钥。

1. **检查模式 (check)**：
   • 读取 hipc_config.json 文件。
   • 验证 hipc_secret 字段是否存在且非空。
2. **设置模式 (set)**：
   • 接收用户提供的 secret 和 env。
   • 格式校验：在保存前，脚本会自动校验密钥格式（必须符合 数字_字符串 的格式，例如 35097_y2GX...）。
   • 如果格式错误，脚本将返回错误信息，不会写入文件。
   • 如果格式正确，将其写入 hipc_config.json 文件，覆盖旧值。

参数定义

• action (String, 必填):
  • 操作类型，决定脚本的行为。
  • 可选值："check"（检查配置）或 "set"（保存配置）。
• secret (String, 可选):
  • 仅在 action="set" 时必填。
  • 用户提供的 HIPC API 密钥字符串。
• env (String, 可选):
  • 环境，决定脚本用哪个环境
  • 仅在 action="set" 时使用，指定要配置的环境。
  • 默认值为 "prod"。
  • 可选值："prod"（生产环境）或 "dev"（开发环境/测试环境）。

调用示例

场景 A：业务前置检查（配置存在）

• 用户：“查一下电脑列表”
• AI 思考：先检查环境配置是否就绪。
• 动作：调用 hipc_config_manager，参数 action="check"。
• 结果：返回 status: "success"。
• 后续：AI 继续调用 hipc_computer_list 技能。

场景 B：业务前置检查（配置缺失）

• 用户：“昨天的运行时长是多少”
• AI 思考：先检查环境配置。
• 动作：调用 hipc_config_manager，参数 action="check"。
• 结果：返回 status: "error"。
• 后续：AI 不调用统计技能，直接回复用户：“检测到您尚未配置 HIPC 密钥，无法查询数据。请提供您的密钥。”

场景 C：用户主动配置密钥（格式正确）

• 用户：“我的密钥是 35097_y2GX52eDGNdgaM，帮我保存一下”
• AI 思考：用户提供了密钥，需要调用设置模式。
• 动作：调用 hipc_config_manager，参数 action="set", secret="35097_y2GX52eDGNdgaM", env="prod"。
• 结果：密钥被写入文件，返回 status: "success"。
• 后续：AI 回复用户：“密钥已保存！现在可以开始查询了。”

场景 D：用户配置密钥（格式错误）

• 用户：“帮我保存密钥，是 sk-123456”
• AI 思考：用户提供了密钥，调用设置模式。
• 动作：调用 hipc_config_manager，参数 action="set", secret="35097_y2GX52eDGNdgaM", env="prod"。
• 结果：脚本检测到格式错误（缺少 数字_ 前缀），返回 status: "error"。
• 后续：AI 回复用户：“您提供的密钥格式不正确。HIPC 密钥通常以 数字_ 开头（例如 35097_xxxxx），请检查后重新提供。”

执行命令

python scripts/main.py --action={{action}}{{#if secret}} --secret={{secret}}{{/if}}{{#if env}} --env={{env}}{{/if}}