AgentScope 配置验证器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install agentscope-config-validator
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 agentscope-config-validator。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

AgentScope 配置验证器是 Openclaw Skills 提供的一款工具，用于检查 AgentScope 2.0 项目目录。它会检查 pyproject.toml 中是否包含 agentscope 依赖项，查找 .env 配置和 OPENAI_API_KEY，验证示例智能体是否能够正常导入，并报告缺失的可选依赖项。
在启动智能体之前运行验证器，即可通过简洁的 Markdown 报告和通过/失败结果，发现常见配置缺漏。它旨在帮助开发者调试 AgentScope 项目设置，无需手动逐项检查要求。

应用场景

在运行智能体之前验证 AgentScope 2.0 项目的设置。
pyproject.toml
是否声明了
agentscope
依赖项。
查找缺失的
.env
文件或未设置的
OPENAI_API_KEY
。
确认示例智能体模块能够正常导入。
在调试配置问题时识别缺失的可选依赖项。
检查模型相关设置，包括可选的
AGENTSCOPE_MODEL
环境变量。

工作原理

使用 --project 参数指定 AgentScope 项目目录。
脚本读取 pyproject.toml 并检查其中是否包含 agentscope 依赖项。
它会查找 .env 配置，并在缺少 OPENAI_API_KEY 时发出警告。
它会检查示例智能体，并验证它们是否能够正常导入。
它会检查是否缺少可选依赖项，并生成一份简短的 Markdown 报告，列出通过/失败结果。

配置指南

前提条件：需要 python3，以及设置在 OPENAI_API_KEY 中的 OpenAI 或兼容 API 密钥。AGENTSCOPE_MODEL 为可选项，可用于指定默认模型名称。
从技能文件夹运行验证器，并将示例路径替换为你的项目目录：
python3 scripts/validate_project.py --project /path/to/agentscope/project
技能元数据将 OPENAI_API_KEY 列为必需的环境变量。验证器会报告配置检查结果；所提供的说明未指定单独的安装命令。
AgentScope 配置验证器 数据架构与分类体系
验证器会检查目标 AgentScope 项目中的文件和设置；技能文档未指定生成的数据存储或持久化输出文件。
项目内容 验证目的
pyproject.toml 检查是否包含 agentscope 依赖项。
.env 检查环境配置，并在缺少 OPENAI_API_KEY 时发出警告。
示例智能体文件 验证示例智能体是否能够正常导入。
可选依赖项 报告可能缺失的依赖项。
OPENAI_API_KEY 用于 OpenAI 或兼容 API 密钥的必需环境变量。
AGENTSCOPE_MODEL 用于指定默认模型名称的可选环境变量。
Markdown 报告 验证运行结果的简短通过/失败报告。

高级特性

一次运行即可检查多项配置：项目依赖项、环境设置、示例智能体导入情况和可选依赖项。
支持通过 --project CLI 选项验证调用者指定路径中的项目。
生成简洁的 Markdown 通过/失败报告，便于快速排查问题。
OPENAI_API_KEY
作为声明的必需环境变量，并识别可选的
AGENTSCOPE_MODEL
配置。
这款 Openclaw Skills 验证器被文档描述为项目检查工具；源资料未说明钩子、自动修复或多智能体编排功能。

name: agentscope-config-validator description: Validate AgentScope 2.0 project configuration files for correctness, completeness, and common mistakes. Use this whenever the user wants to check an agentscope project setup, debug config issues, or review pyproject.toml and model settings before running agents. version: 0.1.0