SKILL 部署指南

如何将 SKILL 文件部署到 Claude Code 和 OpenClaw，让 AI Agent 学会使用企微功能

概述

SKILL 文件是 Markdown 格式的指令文件，用于教会 AI Agent（Claude Code / OpenClaw）如何使用企微相关功能。每个 SKILL 文件定义了一组相关命令的调用方式、参数说明和工作流程，AI Agent 读取后即可通过自然语言响应用户的请求。

SKILL 的作用

部署 SKILL 后，用户可以用自然语言操作，AI Agent 自动选择正确的命令并组装参数。例如用户说"给张三发消息"，Agent 会自动搜索联系人、获取 conversation_id、发送消息。

SKILL 文件说明

每个 SKILL 文件对应一个功能模块（如设备管理、联系人、消息等），包含以下内容：

命令格式和完整参数列表
每个参数的类型、是否必填、来源说明
典型工作流和调用顺序
错误处理指南
自然语言触发示例

部署目标

平台	目录	说明
Claude Code	`~/.claude/commands/`	Anthropic 官方 CLI 工具，通过 `/juhecli-xxx` 斜杠命令触发
OpenClaw	`~/.openclaw/skills/`	开源 AI Agent 框架，自动加载 skills 目录

文件结构与命名

Claude Code 目录

text

~/.claude/commands/
├── juhecli-device.md      # 设备管理
├── juhecli-login.md       # 企微登录
├── juhecli-user.md        # 企微用户
├── juhecli-contact.md     # 企微联系人
├── juhecli-msg.md         # 企微消息
├── juhecli-room.md        # 企微群组
├── juhecli-sync.md        # 数据同步
└── juhecli-client.md      # 客户端管理

OpenClaw 目录

text

~/.openclaw/skills/
├── juhecli-device.md      # 设备管理
├── juhecli-login.md       # 企微登录
├── juhecli-user.md        # 企微用户
├── juhecli-contact.md     # 企微联系人
├── juhecli-msg.md         # 企微消息
├── juhecli-room.md        # 企微群组
├── juhecli-sync.md        # 数据同步
└── juhecli-client.md      # 客户端管理

命名规则

文件名格式为 juhecli-<模块名>.md，两平台的文件内容完全一致，只是放置目录不同。

部署方法

方法一：手动复制（推荐）

将 SKILL 文件复制到目标平台的对应目录：

text

// 部署到 Claude Code
将 juhecli-*.md 文件复制到 ~/.claude/commands/ 目录

// 部署到 OpenClaw
将 juhecli-*.md 文件复制到 ~/.openclaw/skills/ 目录

Windows 路径

在 Windows 上，Claude Code 配置目录位于C:\Users\<用户名>\.claude\commands\。

方法二：批量部署

text

// 一次性部署所有 SKILL 文件到 Claude Code
复制所有 juhecli-*.md 到 ~/.claude/commands/

// 一次性部署所有 SKILL 文件到 OpenClaw
确保 ~/.openclaw/skills/ 目录存在，然后复制所有 juhecli-*.md 到该目录

验证部署

确认文件已就位

部署后，确认目标目录中存在对应的 juhecli-*.md 文件即可。

测试 SKILL 是否生效

text

// 在 Claude Code 中输入：
"帮我查看所有设备"

// AI Agent 应自动识别并调用 juhecli-device SKILL
// 返回设备列表给用户

示例：部署 device SKILL

text

// 步骤 1：获取 SKILL 文件 juhecli-device.md

// 步骤 2：复制到目标目录
// Claude Code: 复制到 ~/.claude/commands/
// OpenClaw: 复制到 ~/.openclaw/skills/

// 步骤 3：重启 Claude Code 或重新加载会话

// 步骤 4：测试自然语言交互
用户: "查看我的设备"
AI: [自动调用 device list]
   你有 1 个设备：
   1. 设备1 (GUID: xxx, 到期: 2026-12-31)

更新与卸载

更新 SKILL

获取最新版本的 SKILL 文件，覆盖目标目录中的旧文件即可。

卸载 SKILL

删除目标目录中对应的 juhecli-*.md 文件。

更新后需重启

更新 SKILL 文件后，需要重启 Claude Code 或 OpenClaw 使其重新加载。

故障排除

问题	排查步骤
SKILL 不生效	1. 确认文件在正确目录 2. 检查文件扩展名为 .md 3. 重启 AI Agent 平台
AI 不理解命令	1. 确认 SKILL 文件为最新版本 2. 检查初始化配置是否完成 3. 确认 app_key 有效
参数错误	1. 确认 SKILL 文件为最新版本 2. 检查 guid 是否正确 3. 重新部署 SKILL