コンテンツにスキップ

🤖 OpenClaw - セルフホスト AI アシスタントプラットフォーム

本ページでは、OpenClaw を **当サイトのゲートウェイ**経由でモデルにアクセスするよう設定する方法を説明します。インストール、設定、当サイトとの連携手順を含みます。


プロジェクト概要

OpenClaw はオープンソースのセルフホスト型個人 AI アシスタントプラットフォームで、メッセージングアプリを自分自身のハードウェアで動作する AI エージェントに接続します。開発者やパワーユーザー向けに設計され、データの制御権を委ねることなく自律型 AI アシスタントを利用できます。

OpenClaw は完全オープンソース(MIT ライセンス)です。GitHub リポジトリでソースコードの閲覧、Issue の投稿、コントリビューションが可能です。


主な機能

マルチチャネル統合

  • クロスプラットフォーム対応:飛書、Discord、Slack、Microsoft Teams など主要なインスタントメッセージングプラットフォームをサポート
  • 統一ゲートウェイ:1 つの Gateway プロセスですべてのチャネルを一元管理
  • 音声対応:macOS/iOS/Android での音声インタラクションをサポート
  • Canvas インターフェース:インタラクティブな Canvas インターフェースのレンダリングに対応

セルフホストとデータセキュリティ

  • 完全セルフホスト:自分自身のマシンまたはサーバーで動作
  • オープンで透明:MIT オープンソースライセンス、コードは完全に透明
  • データローカライズ:コンテキストとスキルはクラウドではなくローカルコンピュータに保存

AI エージェント機能

  • 常時稼働:バックグラウンドでの常駐実行と永続メモリをサポート
  • 定期タスク:cron ベースのスケジュールタスクに対応
  • セッション分離:エージェント/ワークスペース/送信者でセッションを分離
  • マルチエージェントルーティング:複数エージェントの協調動作をサポート
  • ツール呼び出し:ツール呼び出しとコード実行をネイティブサポート

1️⃣ コンソールでトークンを作成する

  1. コンソールのトークンページを開く:https://api-cs-al.naci-tech.com/console/token
  2. 「トークンを作成」をクリック。

2️⃣ OpenClaw をインストールする

必要環境:

  • Node.js 22 以上
  • AI モデル用 API キー(当サイトのトークン)
npm install -g openclaw@latest

インストール後、オンボーディングウィザードを実行:

openclaw onboard

3️⃣ OpenClaw を当サイトに接続する

設定ファイルの場所

OpenClaw の設定ファイルは ~/.openclaw/config.json にあります。オンボーディングウィザードで自動作成するか、手動で編集できます。

設定例

以下は 当サイト をモデルプロバイダーとして使用する設定例です。$API_KEY をコンソールで作成したトークンに置き換えてください:

{
  "models": {
    "providers": {
      "agtcloud": {
        "baseUrl": "https://api-cs-al.naci-tech.com/v1",
        "apiKey": "$API_KEY",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4o",
            "name": "gpt-4o",
            "api": "openai-completions",
            "input": ["text", "image"],
            "contextWindow": 128000,
            "maxTokens": 16384
          },
          {
            "id": "claude-3-5-sonnet-20241022",
            "name": "claude-3-5-sonnet",
            "api": "openai-completions",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "agtcloud/gpt-4o",
        "fallbacks": ["agtcloud/claude-3-5-sonnet-20241022"]
      }
    }
  }
}

主な設定項目の説明

設定項目 説明
models.providers.agtcloud.baseUrl 当サイトのゲートウェイ URL、/v1 を含める必要があります
models.providers.agtcloud.apiKey コンソールで作成した当サイトのトークン
models.providers.agtcloud.models モデル一覧。当サイトがサポートする任意のモデルを必要に応じて追加できます
agents.defaults.model.primary デフォルトのメインモデル。形式は provider/model-id
agents.defaults.model.fallbacks 代替モデル一覧。メインモデルが利用不可の場合に自動切替します

ヒント: 利用可能なモデル ID は当サイトのコンソールの「チャネル管理」で確認できるほか、API リファレンスを参照してください。


4️⃣ サービスを起動する

設定完了後、OpenClaw を起動します:

openclaw start

起動後、設定したチャネル(飛書、Discord など)で AI アシスタントとやり取りできます。


5️⃣ 当サイトのゲートウェイ経由かを確認する

  1. 設定したチャネルで OpenClaw にメッセージを送信します。
  2. 当サイトのコンソールに戻り、「使用ログ」で対応する呼び出しが記録され、openclaw としてグループ化されていることを確認します。

コンソールで呼び出し履歴が表示されれば、OpenClaw は当サイトのゲートウェイ経由で正常にアクセスできています。