openclaw-agent-builder

OpenClaw Agent Builder

完全なワークスペース構造、アイデンティティファイル、スキルを備えた、特化型のopenclawエージェントを作成します。

使用する場面

特定の目的に合わせた新しいopenclawエージェントを構築する場合：

• ドメイン特化型エージェント（Android開発、SEO、コンテンツ作成など）
• マルチエージェントのルーティングシナリオ
• 個別に分離されたエージェントの人格
• ワークスペースベースのAIアシスタント

基本概念

OpenClawエージェントの構造

各エージェントは、分離された頭脳であり、以下で構成されます：

• ワークスペース：ファイル（AGENTS.md、SOUL.md、USER.md、IDENTITY.md、TOOLS.mdなど）
• 状態ディレクトリ：~/.openclaw/agents/<agentId>/agent（認証、設定）
• セッション：~/.openclaw/agents/<agentId>/sessions（チャット履歴）

ワークスペースファイル

必須：

• AGENTS.md - 運用指示、メモリ管理、動作ルール
• SOUL.md - ペルソナ、口調、コミュニケーションスタイル
• USER.md - ユーザーのコンテキストと呼びかけ方
• IDENTITY.md - エージェント名、絵文字、役割、ミッション
• TOOLS.md - ツールに関するメモと規約

任意：

• HEARTBEAT.md - ハートビートのチェックリスト（短く保つ）
• BOOT.md - ゲートウェイ再起動時の起動チェックリスト
• memory/ - 日次メモリログ（YYYY-MM-DD.md）
• MEMORY.md - 整理された長期メモリ
• skills/ - ワークスペース固有のスキル

エージェント構築のワークフロー

1. まず質問する

構築する前に、以下を確認します：

• エージェントの目的：このエージェントはどのような問題を解決しますか？
• ドメインの専門知識：どのような専門知識が必要ですか？
• コミュニケーションスタイル：プロフェッショナルですか？カジュアルですか？技術的ですか？
• ツール／連携：API、データベース、外部システムは必要ですか？
• 必要なスキル：カスタム機能やワークフローは必要ですか？

2. ワークスペース構造を作成する

# Create agent workspace
mkdir -p ~/.openclaw/workspace-<agent-name>
cd ~/.openclaw/workspace-<agent-name>

# Initialize git (recommended)
git init

3. コアファイルを作成する

IDENTITY.md - エージェントの人物像：

# IDENTITY.md

## Name
[Agent Name]

## Emoji
[1-2 relevant emojis]

## Role
[Short role description - e.g., "Android spec writer", "SEO optimizer"]

## Mission
[Concise mission statement - what the agent does and why]

SOUL.md - 性格と口調：

# SOUL.md - [Agent Name]

## Who You Are

[Description of expertise, background, strengths]

## Your Expertise

### [Domain 1]
- [Specific skill or knowledge area]
- [Another capability]

### [Domain 2]
- [Capability]

## Your Approach

### [Trait 1 - e.g., Analytical, Pragmatic]
- [How this manifests]

### [Trait 2]
- [Behavior pattern]

## Your Tone

[Communication style - concise/verbose, formal/casual, technical level]

## Your Values

1. **[Value 1]** - [Why it matters]
2. **[Value 2]** - [Explanation]

AGENTS.md - 運用指示：

# AGENTS.md - [Agent Name]

[Brief agent description and primary role]

## Primary Responsibilities

1. **[Task 1]** - [Description]
2. **[Task 2]** - [Description]

## Workflow

### On User Request: "[Trigger Pattern]"

1. **[Step 1]** [Action description]
   [Details, commands, or sub-steps]

2. **[Step 2]** [Next action]

### On User Request: "[Another Pattern]"

[Workflow steps]

## [Domain-Specific Section - e.g., "iOS Codebase Structure"]

[Relevant context, file paths, patterns]

## [Another Section - e.g., "Translation Guidelines"]

[Reference tables, mappings, rules]

## Memory

- Log [what to track] in `memory/YYYY-MM-DD.md`
- [Memory strategy specific to agent purpose]

## Tools

See `TOOLS.md` for [domain-specific tools or integrations]

## Skills

- **[skill-name]** - [Purpose]
- **[another-skill]** - [Purpose]

USER.md - ユーザーのコンテキスト：

# USER.md

## Who You Are

[User description, preferences, context]

## Your Goals

[What user wants to achieve with this agent]

## Communication Preferences

[How user prefers to interact]

TOOLS.md - ツールの規約：

# TOOLS.md

## [Domain] Tools

- **[Tool/API name]**: [Purpose and usage notes]
- **[Another tool]**: [Notes]

## Authentication

[If agent needs API keys, credentials, etc.]

## Conventions

[Domain-specific conventions or patterns]

4. スキルを追加する（任意）

ワークスペース固有のスキルを作成します：

mkdir -p skills/<skill-name>

各スキルにはSKILL.mdが必要です：

---
name: skill-name
description: What the skill does
---

# Skill Name

[Skill documentation following agentskills.io format]

## When to Use

[Trigger conditions]

## Steps

[Detailed workflow]

## Examples

[Usage examples]

5. メモリシステムをセットアップする

mkdir -p memory
touch memory/$(date +%Y-%m-%d).md

整理された知識を記録するMEMORY.mdは任意です：

# MEMORY.md

## [Category]

- [Key fact or pattern]
- [Lesson learned]

## [Another Category]

[Organized knowledge]

6. エージェントを登録する

# Add agent to openclaw
openclaw agents add <agent-name>

# Set workspace path
# Edit ~/.openclaw/openclaw.json:
{
  "agents": {
    "list": [
      {
        "id": "<agent-name>",
        "workspace": "~/.openclaw/workspace-<agent-name>"
      }
    ]
  }
}

7. バインディングを追加する（マルチエージェントのルーティング）

特定のチャネル／ユーザーをこのエージェントにルーティングします：

{
  "bindings": [
    {
      "agentId": "<agent-name>",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "direct", "id": "+1234567890" }
      }
    }
  ]
}

設計原則

エージェントのアイデンティティ

• 明確な目的：単一で、焦点の定まった責任範囲
• 独自の個性：ほかのエージェントとは異なる口調やアプローチ
• 深い専門性：特定のドメインに関する深い知識

コミュニケーションスタイル

• 簡潔さ：ドメイン上、詳細が必要な場合を除き、簡潔さを優先します
• プロフェッショナル：業界標準に合わせます
• 実行可能性：説明だけでなく、何をすべきかに焦点を当てます

メモリ戦略

• 日次ログ：重要な出来事や決定を記録します
• 整理された知識：パターンを抽出してMEMORY.mdに記録します
• コンテキストの保持：/newまたは/resetの前に状態を保存します

スキルの整理

• ワークスペーススキル：エージェント固有の機能
• 共有スキル：~/.openclaw/skills/にある共通ユーティリティ
• オーバーライドパターン：ワークスペーススキルは共有スキルやバンドル済みスキルを優先します

エージェントの例

Android仕様ジェネレーター

Purpose: Analyze iOS features, generate Android requirement specs
Style: Concise, technical, requirement-focused
Skills: ios-analyzer, android-spec-generator, github-issue-creator

SEOエキスパート

Purpose: Content optimization, keyword research, SEO strategy
Style: Data-driven, analytical, actionable
Skills: keyword-research, content-analyzer, competitor-analysis

コンテンツライター

Purpose: Blog posts, documentation, technical writing
Style: Clear, engaging, audience-aware
Skills: content-planner, seo-writer, editor

アンチパターン

❌ 避けること：

• 互いに無関係な複数のドメインを1つのエージェントに混在させる
• 目的上必要でないのに、冗長でおしゃべりなエージェントを作成する
• AGENTS.md、SOUL.md、TOOLS.md間で内容を重複させる
• ワークスペースにシークレットを保存する（~/.openclaw/credentials/を使用します）

✅ 推奨事項：

• エージェントごとに、明確で単一の焦点を保つ
• ドメインの慣例に合わせてコミュニケーションスタイルを調整する
• 責任範囲ごとに整理する（アイデンティティ／性格／運用）
• gitを使ってワークスペースをバックアップする（プライベートリポジトリ）

エージェントのテスト

# Start gateway with agent
openclaw gateway --agent <agent-name>

# Or use binding to route to agent
openclaw gateway

# Send test message via WhatsApp/Telegram/Discord
# Verify agent responds with expected personality/capability

メンテナンス

エージェントを更新する

cd ~/.openclaw/workspace-<agent-name>
git add .
git commit -m "Update [what changed]"
git push

新しいスキルを追加する

cd ~/.openclaw/workspace-<agent-name>/skills
mkdir new-skill
# Create SKILL.md

エージェントをバックアップする

# Workspace already in git
# Separately backup sessions if needed:
tar -czf sessions-backup.tar.gz ~/.openclaw/agents/<agent-name>/sessions/

リソース

• OpenClaw のマルチエージェントルーティング
• エージェントのワークスペース構成
• AgentSkills.io のフォーマット
• Skills.sh マーケットプレイス

作成前に確認すること

ユーザーに次の点を確認してください。

1. エージェントの目的と範囲
2. コミュニケーションスタイルの希望
3. 必要なインテグレーション／API
4. ルーティング戦略（専用チャネルか共有か）
5. スキル要件