跳到主要内容

安装与授权

使用献丑 Skill 前，需要先准备 Agent 环境、安装 CLI，并配置 Access Key。完成后，Agent 就可以在你的授权项目下提交图片、视频和 Markdown 配图任务。

第一步：准备 Agent 环境​

任选一个支持 Skill 的 Agent 环境：

  • OpenClaw
  • 飞书插件
  • KimiClaw
  • Cursor
  • 其他兼容 Agent Skill 的工具

不同工具的 Skill 安装入口不同，但核心都是让 Agent 能读取 SKILL.md 以及同目录下的参考文件。

第二步：获取 Skill​

献丑 Skill 位于 xianchou/skills 仓库。推荐直接使用仓库中的 Skill 目录：

skills/
├── README.md
├── SKILL.md
└── references/

其中 SKILL.md 是入口文件，references/ 放更细的命令、接口、Markdown 配图和常见问题说明。

第三步：安装 CLI​

Agent 最终会调用 xianchou 命令，所以本机或运行环境必须先安装 CLI：

npm install -g @xianchou/cli
xianchou --help

本地源码开发时可以在 CLI 仓库中运行：

cd cli
pnpm install
pnpm build
pnpm dev -- --help

第四步：创建 Access Key​

在献丑 Web 登录后，点击头像菜单里的 Access Key，创建并复制完整 Access Key。Access Key 是 Agent 调用献丑能力的授权凭据，请不要提交到 Git 仓库或公开文档。

第五步：配置凭据​

推荐使用 CLI 保存凭据：

xianchou auth login --key <ACCESS_KEY> --project-id <PROJECT_ID>

凭据默认保存到：

~/.xianchou/config.json

也可以使用环境变量，适合 CI、临时会话或不希望写入配置文件的运行环境：

export XIANCHOU_ACCESS_KEY=<ACCESS_KEY>
export XIANCHOU_PROJECT_ID=<PROJECT_ID>
export XIANCHOU_API_URL=https://api.xianchou.com
export XIANCHOU_CONFIG_DIR=~/.xianchou

配置检查​

配置完成后，先查询模型验证授权是否可用：

xianchou models image
xianchou models video

如果返回模型列表，就可以开始生成图片、视频或给 Markdown 配图。