メインコンテンツへスキップ

はじめに

このチュートリアルでは、OpenClaw Manager で Feishu ボットを作成・設定する手順を説明します。設定完了後、Feishu Bot が APIMart の AI モデルを使用して、Feishu 内でユーザーとインテリジェントな会話を行えるようになります。
前提条件: OpenClaw Manager のデプロイが完了し、Manager が起動中で管理画面にアクセスできることをご確認ください。

ステップ 1:Feishu 企業カスタムアプリを作成

  1. Feishu オープンプラットフォームにアクセスし、ログイン後 企業カスタムアプリを作成 をクリック
企業カスタムアプリを作成
  1. アプリ名と説明を入力し、アプリアイコンをアップロード
アプリ情報を入力

ステップ 2:アプリ権限を設定

  1. アプリ詳細ページに入り、左メニューの 権限管理 をクリック
  2. 一括有効化 をクリックし、以下の JSON 設定を貼り付け:
{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:user.email:readonly",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "cardkit:card:write"
    ]
  }
}
権限を設定
  1. 確認をクリック

ステップ 3:認証情報を取得

  1. 左メニューの 認証情報と基本情報 をクリック
  2. App ID(形式:cli_xxxxxxxxxx)と App Secret をコピー
認証情報を取得
App Secret を安全に保管してください。他人に漏らさないでください。

ステップ 4:Manager でインスタンスを作成

  1. OpenClaw Manager 管理画面を開く(http://127.0.0.1:51942
  2. + 新規インスタンス をクリック
  3. インスタンス名を入力 — 例:my-feishu-bot
インスタンス名を入力
  1. AI モデルを選択 — 使用するモデルを選択
モデルを選択
  1. APIMart API Key を入力sk- で始まる API キーを入力
API Key を入力
  1. チャネルを選択Feishu を選択
  2. 認証情報を入力 — App ID と App Secret を対応するフィールドに貼り付け
Feishu チャネルを設定
  1. 作成 をクリックしてインスタンス作成を完了

ステップ 5:イベントサブスクリプションを設定

インスタンス作成後、Feishu オープンプラットフォームでイベントサブスクリプションを設定する必要があります:
  1. Feishu オープンプラットフォームに戻り、アプリ詳細に入る
  2. 左メニューの イベントとコールバック をクリック
  3. サブスクリプション方式 を「ロングコネクション」に設定
サブスクリプション方式を選択
  1. イベントを追加 をクリックし、im.message.receive_v1(メッセージ受信)を検索して追加
イベントを追加

ステップ 6:バージョン作成と公開

  1. 左メニューの バージョン管理とリリース をクリック
  2. バージョンを作成 をクリック
  3. バージョン番号と更新内容を入力
  4. 審査に提出し、管理者の承認を待つ
バージョンを作成して公開
重要: 権限やイベントサブスクリプションを変更するたびに、新しいバージョンを作成して再公開する必要があります。

ステップ 7:ペアリングコード連携

アプリが承認・公開された後:
  1. Feishu でボット名を検索
  2. 任意のメッセージを送信(例:「こんにちは」)
  3. ボットが 8 桁のペアリングコード(例:DFE62DTD)を返信
ペアリングコードを取得
  1. Manager の新規インスタンスウィザードに戻り、「ペアリングコードを入力」ステップでコードを入力し、「承認」をクリック
ペアリングコードを入力
  1. コードが承認されたら、「完了」をクリック
ペアリング承認成功
  1. Feishu に戻り、再度メッセージを送信すると、ボットが AI 生成のコンテンツで応答
ボットと会話

よくある質問

Q1: ボットがメッセージに応答しない?

解決方法:
  1. イベントサブスクリプションに im.message.receive_v1 が追加されているか確認
  2. サブスクリプション方式が「ロングコネクション」(Webhook ではなく)になっているか確認
  3. 新しいバージョンを作成して公開済みで、承認が通っているか確認
  4. Manager でインスタンスのステータスが「実行中」であることを確認

Q2: 権限不足エラー?

解決方法:
  1. すべての権限が有効になっているか確認(ステップ 2 を参照)
  2. 権限変更後は、新しいバージョンを作成して再公開する必要があります
  3. 管理者の承認を待つ

Q3: ペアリングコードの承認に失敗?

解決方法:
  • Gateway が実行中であることを確認
  • ペアリングコードは大文字小文字を区別します、慎重に確認してください
  • コードは Gateway 再起動後に無効になります、ユーザーに新しいメッセージを送信してもらってください

OpenClaw Manager デプロイガイドに戻る

Manager のインストール、デプロイ、インスタンス管理の完全ガイドを確認