🐑 HolySheep CLI

English | 中文

One command to configure all AI coding tools with HolySheep API
一条命令，配置所有 AI 编程工具

🚀 Quick Start · 📦 npm · 🌐 holysheep.ai

---

🇬🇧 English

What is HolySheep CLI?

HolySheep CLI (hs) is a command-line tool that automatically configures all popular AI coding assistants to use HolySheep API — a relay service for accessing Claude, GPT, and Gemini APIs in China without a VPN.

Instead of manually editing config files for each tool, run one command and you're done.

Supported Tools

Tool	Config File	Status
Claude Code	~/.claude/settings.json	✅ Auto
Codex CLI	~/.codex/config.toml	✅ Auto
Droid CLI	~/.factory/settings.json	✅ Auto
Aider	~/.aider.conf.yml	✅ Auto
Continue.dev	~/.continue/config.yaml	✅ Auto
OpenCode	~/.config/opencode/opencode.json	✅ Auto
OpenClaw	~/.openclaw/openclaw.json	✅ Auto
Cursor	GUI (encrypted storage)	⚠️ Manual
Gemini CLI	Google protocol only	❌ Not supported

Quick Start

🔑 First, get your free API Key → holysheep.ai/register (free signup, pay-as-you-go from ¥10)

npx @simonyea/holysheep-cli@latest setup

Or install globally:

npm install -g @simonyea/holysheep-cli
hs setup

You'll be prompted for your API Key (cr_xxx), then select the tools to configure. Done!

OpenClaw Setup

OpenClaw is a powerful AI agent gateway with a web dashboard. After running hs setup:

1. HolySheep configures OpenClaw to use HolySheep API
2. The OpenClaw Gateway starts on http://127.0.0.1:18789/ by default
3. If 18789 is occupied, hs setup automatically picks the next available local port
4. Open the exact browser URL shown in the terminal and start chatting — no token required

Default OpenClaw model: gpt-5.4

Keep the gateway window open while using OpenClaw. The gateway must be running for the browser UI to work.

OpenClaw itself requires Node.js 20+. If setup fails, first check node --version.

To restart the gateway later:

openclaw gateway --port <shown-port>
# or
npx openclaw gateway --port <shown-port>

If you forget the port, check ~/.openclaw/openclaw.json (gateway.port) or run hs doctor.

Commands

Command	Description
hs setup	Configure AI tools interactively
hs login	Save your API Key locally
hs doctor	Check configuration & connectivity
hs balance	View account balance
hs tools	List all supported tools
hs reset	Remove all HolySheep configuration

API Endpoints

Usage	URL
Anthropic SDK / Claude Code	https://api.holysheep.ai (no /v1)
OpenAI-compatible / Codex / Aider	https://api.holysheep.ai/v1 (with /v1)

---

🇨🇳 中文

什么是 HolySheep CLI？

HolySheep CLI（命令 hs）是一个命令行工具，帮你一键配置所有主流 AI 编程助手接入 HolySheep API。

无需 VPN，无需手动改配置文件，运行一条命令即可接入 Claude、GPT、Gemini。

支持的工具

工具	状态	说明
Claude Code	✅ 自动	Anthropic 官方 CLI
Codex CLI	✅ 自动	OpenAI 官方 CLI
Droid CLI	✅ 自动	Factory AI 终端智能体
Aider	✅ 自动	AI 结对编程
Continue.dev	✅ 自动	VS Code/JetBrains 插件
OpenCode	✅ 自动	终端 AI 编程助手
OpenClaw	✅ 自动	AI 智能体网关 + Web 界面
Cursor	⚠️ 手动	需在 GUI 中手动配置
Gemini CLI	❌ 不支持	仅支持 Google 官方协议

快速开始

🔑 第一步：注册获取 API Key → holysheep.ai/register（免费注册，¥10 起充，按量计费）

npx @simonyea/holysheep-cli@latest setup

或全局安装：

npm install -g @simonyea/holysheep-cli
hs setup

按提示输入 API Key（cr_xxx），选择要配置的工具，完成！

OpenClaw 使用说明

OpenClaw 是一个 AI 智能体网关，提供浏览器 Web 界面，支持聊天、任务、工具调用等功能。

hs setup 配置完成后：

1. HolySheep 会自动把 OpenClaw 接到 HolySheep API
2. 默认启动在 http://127.0.0.1:18789/
3. 如果 18789 被占用，hs setup 会自动切换到下一个可用本地端口
4. 按终端里显示的准确地址打开浏览器，直接开始聊天，无需填写 token

OpenClaw 默认模型： gpt-5.4

⚠️ 保持 Gateway 窗口开启，关闭后 Gateway 停止，浏览器界面无法使用。

⚠️ OpenClaw 自身要求 Node.js 20+。如果配置失败，请先运行 node --version 检查版本。

下次启动 Gateway：

openclaw gateway --port <显示的端口>
# 或
npx openclaw gateway --port <显示的端口>

如果忘了端口，可以查看 ~/.openclaw/openclaw.json 里的 gateway.port，或直接运行 hs doctor。

默认模型： gpt-5.4（可在 OpenClaw 内切换到 Claude 模型）

命令说明

命令	说明
hs setup	交互式配置 AI 工具
hs login	保存 API Key 到本地
hs doctor	检查配置状态和连通性
hs balance	查看账户余额
hs tools	列出所有支持的工具
hs reset	清除所有 HolySheep 配置

接入地址

用途	地址
Anthropic SDK / Claude Code	https://api.holysheep.ai（不带 /v1）
OpenAI 兼容 / Codex / Aider	https://api.holysheep.ai/v1（带 /v1）

常见问题

Q: API Key 在哪里获取？
A: 在 holysheep.ai 注册后，在「API 密钥」页面创建，格式为 cr_xxx。

Q: 支持 Windows 吗？
A: 支持，需要 Node.js 16+。如果 hs 命令找不到，请重启终端，或直接用 npx @simonyea/holysheep-cli@latest setup。

Q: OpenClaw Gateway 窗口可以最小化吗？
A: 可以最小化，但不能关闭。关闭后 Gateway 停止，需要按 hs setup / hs doctor 显示的端口重新运行 openclaw gateway --port <端口> 或 npx openclaw gateway --port <端口>。

Q: 18789 端口被占用怎么办？
A: hs setup 会自动切换到下一个可用本地端口，并把准确访问地址打印出来；也可以运行 hs doctor 查看当前 gateway.port 和端口占用情况。

Q: 如何恢复原来的配置？
A: 运行 hs reset 清除所有 HolySheep 相关配置。

Q: OpenClaw 安装失败？
A: OpenClaw 需要 Node.js 20+，运行 node --version 确认版本后重试；如果全局安装失败，hs setup 也会尽量回退到 npx openclaw 继续配置。

---

Changelog

• v1.6.4 — 修复 OpenClaw 的 npx 运行时检测，避免配置后页面仍卡在 Unauthorized / 未连接状态
• v1.6.3 — OpenClaw 默认模型改为 GPT-5.4，并继续保留 Claude 模型切换能力
• v1.6.2 — 修复 OpenClaw 配置误判与 npx 回退，端口冲突时自动切换空闲端口，并补充 Doctor 诊断
• v1.6.0 — 新增 Droid CLI 一键配置，默认写入 GPT-5.4 / Sonnet 4.6 / Opus 4.6 / MiniMax 2.7 Highspeed / Haiku 4.5
• v1.5.2 — OpenClaw 安装失败（无 git 环境）时自动降级为 npx 模式继续配置
• v1.5.0 — OpenClaw gateway 无需 token，直接浏览器打开 http://127.0.0.1:18789/
• v1.4.6 — 基于实测正确配置格式，彻底修复 OpenClaw 401 认证问题
• v1.3.x — OpenClaw 一键配置支持，自动写入配置并启动 Gateway

---

License

MIT