Avisyn

Avisyn は Avisyn 公式のユーザー向け Skill プラグインです。Claude Code、Codex、OpenClaw に対応し、自然言語コマンドでモデル、トークン、グループ、残高を管理し、Avisyn の使い方も直接質問できます。

Avisyn-skills とは？

Avisyn-skills は、Avisyn 公式の AI エディター Skill プラグインです。Skills は軽量な拡張プロトコルで、AI コーディングアシスタント（Claude Code、Codex、OpenClaw、Cursor、Windsurf、Cline など）がエディター内で Avisyn の API を直接呼び出し、モデルの照会、トークン管理、残高確認に加えて、Avisyn のデプロイ、設定、API 利用方法などの質問にもコーディング環境から離れることなく対応できます。

GitHub リポジトリ：github.com/QuantumNous/skills

OpenClaw でも利用でき、エージェントのワークフロー内で /Avisyn コマンドを使ってモデル照会やトークン管理、残高確認を直接実行でき、Avisyn の使い方もそのまま質問できます。

Skills を使う理由

日常の AI 開発では、エディターと Avisyn 管理ダッシュボードの間を頻繁に行き来する必要があります — 利用可能なモデルの確認、API トークンの作成、残高のチェック、グループ割当の調整など。これらのコンテキストスイッチはコーディングの流れを中断します。

Avisyn-skills が解決する課題：

コンテキストスイッチゼロ：Claude Code、Codex、OpenClaw などの AI IDE で自然言語コマンドを直接入力 — ブラウザや管理パネル不要
組み込みヘルプ：Avisyn のデプロイ、設定、グループ、API 呼び出し形式などをその場で質問できます
セキュリティファースト：キーは平文で表示されません。トークンのコピーと注入はすべてセキュアチャネルで実行（sk- プレフィックスのキーはターミナル出力やログに表示されません）
インストール即使用：npx コマンド一行でインストール完了。ランタイム自動検出（Bun / Node.js / Deno）
マルチエディター互換：Skills プロトコルを実装するすべての AI エディター・コーディングアシスタントで使用可能

対応 AI エディター

Avisyn-skills は以下の AI コーディングツールで利用できます：

AI エディター / コーディングアシスタント	種類	備考
Claude Code	ターミナル AI プログラミングアシスタント	Anthropic 公式 CLI
OpenClaw	セルフホスト型 AI アシスタントプラットフォーム	Skills に対応し、対話内で `/Avisyn` コマンドを直接実行可能
Cursor	AI ネイティブコードエディター	VS Code ベース
Windsurf	AI コードエディター	Codeium 製
Cline	VS Code AI 拡張機能	オープンソース AI コーディングエージェント
Codex CLI	ターミナル AI プログラミングアシスタント	OpenAI 公式 CLI

Skills プロトコルをサポートするすべてのツールで Avisyn-skills を使用できます。

コマンドリファレンス

以下は Avisyn-skills が提供する全コマンドです。これらのコマンドは Avisyn REST API を通じて、Avisyn インスタンス上のリソースを照会・管理します。

照会コマンド

コマンド	説明	用途
`/Avisyn models`	利用可能な AI モデルを一覧表示	Avisyn インスタンスに設定された全モデル（OpenAI、Claude、Gemini など）を確認
`/Avisyn groups`	ユーザーグループを一覧表示	アカウントのグループとクォータ・倍率設定を確認
`/Avisyn balance`	アカウント残高を表示	現在のユーザーの残高と使用量をリアルタイム照会

トークン管理コマンド

コマンド	説明	用途
`/Avisyn tokens`	API トークンを一覧表示	作成済みの全トークンを確認（キーはマスク表示、例：`sk-reHR**********OspA`）
`/Avisyn create-token <name> [--group=xxx]`	新しい API トークンを作成	アプリやプロジェクトごとに独立した API キーを生成
`/Avisyn switch-group <token_id> <group>`	トークンのグループを変更	モデルアクセス権限と倍率を調整するためにグループを変更
`/Avisyn copy-token <token_id>`	キーをクリップボードにコピー	実キーをシステムクリップボードに安全にコピー（ターミナルには表示されません）
`/Avisyn apply-token <token_id> <file>`	設定ファイルにキーを注入	プレースホルダー置換によりプロジェクト設定ファイル（例：`.env`）にトークンキーを安全に書き込み

ヘルプコマンド

コマンド	説明	用途
`/Avisyn help <question>`	Avisyn について質問	Avisyn のデプロイ、設定、API 呼び出し形式などのヘルプ情報を取得

インストールと設定

Avisyn-skills をインストール

npx でワンラインインストール：

npx skills add https://github.com/QuantumNous/skills --skill Avisyn

GitHub リポジトリから最新の Skill 定義を取得し、エディター環境にインストールします。

環境変数を設定

Avisyn-skills は Avisyn インスタンスに接続するために 3 つの環境変数が必要です。シェルプロファイルに追加してください：

# ~/.bashrc または ~/.zshrc
export Avisyn_BASE_URL=https://<your-Avisyn-domain>
export Avisyn_ACCESS_TOKEN=your-access-token
export Avisyn_USER_ID=1

変数	説明	例
`Avisyn_BASE_URL`	Avisyn サービス URL	`https://api.example.com`
`Avisyn_ACCESS_TOKEN`	管理者またはユーザーのアクセストークン	「個人設定 → アカウント管理 → セキュリティ設定 → システムアクセストークン」から取得
`Avisyn_USER_ID`	ユーザー ID	`1`（管理者のデフォルトは 1）

プロジェクトルートに .env ファイルを作成する方法もあります。キー漏洩防止のため .env を .gitignore に追加してください。

使い始める

インストール後、Skills 対応の AI エディターで /Avisyn コマンドを入力するだけです。例：

/Avisyn models と入力して利用可能なモデルを確認
/Avisyn balance と入力して現在の残高をチェック
/Avisyn create-token my-app と入力して my-app という新しいトークンを作成
/Avisyn help グループやトークンはどう設定しますか？ と入力して Avisyn の使い方を質問
OpenClaw でも /Avisyn models や /Avisyn balance などをそのまま利用できます

ランタイム要件

以下のいずれかの JavaScript ランタイムが必要です（起動時に自動検出）：

ランタイム	バージョン	推奨度
Bun	最新版	推奨（最速）
Node.js	>= 18	広くサポート
Deno	最新版	オプション

セキュリティ

Avisyn-skills は API キーを保護するための多層セキュリティを内蔵しています：

トークン一覧ではマスクされたキーのみ表示（例：sk-reHR**********OspA）— 実キーはターミナル出力に表示されません
copy-token はキーをシステムクリップボードにのみコピーし、出力には表示しません
apply-token はプレースホルダー置換でキーを注入し、生のキー内容を公開しません
すべての sk- プレフィックスキー値は実行フロー全体を通じて厳格に保護されます

詳細情報

Avisyn-skills は現在も活発に開発中で、コマンドや機能はアップデートにより変更される可能性があります。最新の情報と変更ログはリポジトリの README を参照してください：

GitHub リポジトリ：github.com/QuantumNous/skills
Avisyn 公式サイト：www.Avisyn.ai
Avisyn GitHub：github.com/QuantumNous/new-api

目次