OpenClawでAzure DevOpsのWiki更新を自動化する - クラウドAIだけでは届かない場所へ

セルフホステッドAIエージェント OpenClaw を、単なるチャットAIとしてではなく、開発環境に近い場所で動く実務支援エージェントとして使えるかを検証したPoCの記録です。最初は「技術情報を収集してWikiにまとめ、Teamsに通知する」という仕組みをOpenClawで作ろうとしましたが、それだけならクラウドのPaaSで十分実現できてしまい、セルフホスト型を持ち出す理由が薄いことに気づきました。

そこで立ち返ったのが、「クラウドAIと同じことをローカルで再現するためではなく、クラウドAIだけでは直接触りにくい場所（ローカルのGitリポジトリ、CI/CIログ、閉域ネットワーク上の情報など）の近くで動けることにこそ、セルフホステッドAIエージェントの固有の価値がある」という視点です。この視点をもとに、OpenClawとHermesの比較検討、PowerShellとOpenClawの役割分担、Skillによるレポート形式の固定、Azure DevOps WikiへのETagを使った冪等な更新、Teamsへの通知設計まで、実装のポイントと実際にハマった落とし穴、業務適用の勘所をまとめています。

Transcript

1. .NETラボ（.NET技術やマイクロソフト製品について勉強するコミュニティー） OpenClawでAzure DevOpsのWiki更新 を自動化する クラウドAIだけでは届かない場所へ 2026.09.26 Yutaka.Osada
2. AGENDA 今日話すこと セルフホステッドAIエージェントを「チャットAI」としてではなく、 開発環境に近い場所で動く実務支援エージェントとして使えるかを試した話です。 01 なぜセルフホステッドAIエージェン トなのか 04 実装のポイント（役割分担・Skill設 計・Wiki更新・Teams通知） 02 OpenClawとHermesを比較した理由 05 ハマったところと業務適用の勘所 03 作ったものの全体像 06 まとめ DO WHAT MATTERS 2
3. DO WHAT MATTERS Yutaka Osada （長田 豊） • DevOps Engineer @Avanade Japan • 業務 • Azureコンポーネントを活用したサー ビス構築 • 技術検証、パフォーマンスチューニン グを得意とし、T-SQLが好き。 • 技術スタック • C#, .NET, Azure(PaaS), Azure DevOps, GitHub • Please follow me https://github.com/yutaka-art 3
4. BACKGROUND / PROBLEM 最初の案と、立ち止まった問い 最初に考えた仕組み 立ち止まった点 公開技術情報を収集 取得・要約・通知だけなら Azure AI Foundry / Functions / Logic Apps で実現できる Wikiに要約してまとめる クラウドで完結する処理に セルフホスト型を持ち出す理由が薄い Teamsへ通知 OpenClawを使うために OpenClawを使う状態になっていた DO WHAT MATTERS 4
5. TURNING POINT セルフホステッドAIエージェントの 「固有の価値」はどこにあるか クラウドAIと同じことをローカルで再現するためではなく、 クラウドAIだけでは直接触りにくい場所の近くで動ける、 その点にこそ価値がある。 ローカル Gitリポジトリ CLI / CIログ 開発端末上の ファイル DO WHAT MATTERS Issue / Pull Request 閉域ネットワーク 上の情報 5
6. OPENCLAW OVERVIEW OpenClawとは何か OSSで公開された、セルフホスト型の自律型プライベートAIエージェント クラウドではなく自分のマシン上で動き、開発環境の近くで作業できる セルフホスト実行 — 外部にデータを出さない CLIから呼び出し可能（openclaw agent） Skill（SKILL.md）で振る舞いを定義 外部LLM・ツールと連携（GitHub Copilot 等） ※ 出典: AWS Blog「Introducing OpenClaw on Amazon Lightsail to run your autonomous private AI agents」 DO WHAT MATTERS 6
7. TOOL SELECTION OpenClaw と Hermes — どちらを選ぶか 観点 OpenClaw Hermes Cron実行を見せやすい 今回の判断 定期実行 Cronもあるが今回は不要 Task Schedulerに寄せる レポートの型 Skillで出力形式を固定しや 継続実行・改善の文脈が強 Skillで日次レポート形式を すい い 固定 PowerShell連携 外側からCLI実行しやすい 自律実行の色が強い PowerShell主導にしやす い 今回のテーマへ の適性 ローカル/閉域情報を読む 説明に合う 別テーマなら面白い OpenClawを採用 ※ Hermesが合わなかったわけではない。継続実行・自己改善型エージェントとして見せるなら、Hermesの方が話を 作りやすい場面もある。今回のテーマにはOpenClawが適していた。 DO WHAT MATTERS 7
8. ARCHITECTURE 作ったものの全体像 起動 収集 生成 投稿 通知 Windows Task Scheduler Git + Azure DevOps REST API OpenClaw Skill Azure DevOps Wiki Teams Workflow Webhook PowerShell が決定的に処理 OpenClaw が読み解く 起動・収集・投稿・通知 非定型な要約と示唆の生成 Azure DevOps Local machine GitHub Task Scheduler Wiki OpenClaw GitHub Copilot Business SKILL.md gpt-5.5 Azure Repos PowerShell DO WHAT MATTERS 8
9. DIVISION OF ROLES · CORE CONCEPT AIに任せること、任せないこと PowerShell OpenClaw AIに委ねる領域 決定的に処理する領域 Git / Azure DevOps 情報取得 コード・Issue・PR・CI を統合して読み解く 結果を完全に制御できる 収集結果の JSON 化 事実と示唆（AI解釈）を分けて整理する 入力形式を固定できる Wiki 作成 / 更新 推奨アクションを優先度付きで提示する Teams 通知 不明点は推測せず「確認不可」と明記する ETag・再実行性を扱いやすい 失敗時の原因を追いやすい AIにすべてを任せるのではなく、 AIが得意な非定型な整理だけに集中させる。それが業務適用の現実解。 DO WHAT MATTERS 9
10. IMPLEMENTATION · SKILL DESIGN Skillでレポートの「型」を固定する なぜ型を固定するか 固定した出力構成 AIに「いい感じに」投げると、日によって出力の粒度や構 01 サマリ 02 コード・リポジトリ状況 03 Issue / Work Item / PR状況 Skillに入れたルール 04 CI / Build状況 · 事実とAI解釈を必ず分けて記述する 05 技術的な気づき 06 チーム向け推奨アクション 07 注意事項 造が揺れる。日次で運用するなら、毎回同じ構造で読める ことの方が価値が高い。 · PAT・環境変数・秘密情報は出力しない · 不明点は推測せず「確認不可」と明記する · 推測・捏造はしない（Do not invent facts） DO WHAT MATTERS 10
11. IMPLEMENTATION · DATA COLLECTION PowerShellで入力データを固定する 収集対象と取得元 Snapshot JSON — 構造 { Git "generatedAt": "2026-07-07T09:00:00" "targetPeriod": "last 7 days" branch / status / 直近コミット / 変更ファイル "repository": { "branch": "develop" "recentCommits": [ ... ] Azure DevOps "changedFiles": [ ... ] } Pull Requests / Build / Work Item (WIQL) "azureDevOps": { "pullRequests": [ ... ] どのAPIから何を取るかは スクリプトで完全に固定する。 「AIにAPIを叩かせる」は採用しない。 DO WHAT MATTERS "builds": [ ... ] "workItemIds": [ ... ] } } 11
12. IMPLEMENTATION · REPORT GENERATION OpenClawでMarkdownレポートを生成する Snapshot JSON /skill 指定 Markdown出力 PowerShellが生成した 入力ファイルを渡す dev-environmentsnapshot-report Skillの型に沿った 日次レポートを生成 # session-keyは実行ごとに生成（固定するとGitHub Copilot経由で暗号化コンテキストエラーが発生する） $SessionKey = "dev-snapshot-$Date-$(Get-Date -Format 'HHmmss')" openclaw agent --agent main --session-key $SessionKey --message $Prompt 固定 session-key → GitHub Copilot経由モデルで暗号化コンテキスト関連エラーが発生。実行ごと に変えることで解消。 DO WHAT MATTERS 12
13. IMPLEMENTATION · WIKI PUBLISH Azure DevOps Wikiへ作成・更新する Wiki 階層パス 親ページを順に作成 /TechCatchup GET → 存在確認 → なければ PUT で作成 ancestor エラーを防ぐ └ /2026 既存ページ更新にはETagが必要 └ /07 GET で ETag を取得し If-Match を付けて PUT └ /2026-07-07 PowerShell 5.1の注意点 ※ 親ページが存在しない場合に作成が失敗する → /TechCatchup → /2026 → /07 の順に作成・確認 DO WHAT MATTERS -UseBasicParsing を付けないと 対話プロンプトで無人実行が停止する 13
14. IMPLEMENTATION · TEAMS NOTIFICATION Teams通知は「読みに行くきっかけ」に絞る レポート全文をTeamsに流すのではなく、Wikiへのリンクカードだけを送る。 Teamsは読む場所ではなく、読みに行くきっかけとして使う。 ハマりポイント：Adaptive Card形式が要求される ✗ NG — シンプルJSON ✓ OK — Adaptive Card形式 { "text": "開発環境 定期棚卸しレポートを作成しました" } { "type": "AdaptiveCard", "version": "1.4", "body": [ TextBlock, FactSet ], "actions": [ Action.OpenUrl → Wiki ] } → Error: Property 'type' must be 'AdaptiveCard' Power Automate側が triggerBody()?['card'] を参照する場合は payload のラップ形式が変わる点にも注意。 DO WHAT MATTERS 14
15. RESULT 実行結果 確認できたフロー Wiki 作成ログ（実際のログ出力） Git / Azure DevOps 情報を収集 Creating wiki page: /TechCatchup Creating wiki page: /TechCatchup/2026 OpenClaw で Markdown レポート生成 Creating wiki page: /TechCatchup/2026/07 Creating wiki page: .../2026/07/2026-07-07 Azure DevOps Wiki に作成 / 更新 --- 2回目実行（同日）--- Teams へ Adaptive Card 通知 Wiki page already exists: .../2026-07-07 Updating existing wiki page ... Updated wiki page completed: .../2026-07-07 → 同日再実行でも ETag で既存ページを更新。冪等性を確保。 DO WHAT MATTERS 15
16. PITFALLS · LESSONS LEARNED 実装でハマったところ Task Schedulerから環境変数が読めない Wiki親ページが無いと ancestor エラー $env: はそのプロセス内だけ有効。 Task Scheduler起動時はUser環境変数として登録が必要。 .../2026-07-07 を直接作ると「ancestor pages does not exist」で 失敗。上位から順番に作成。 既存ページ更新にはETagが必要 PowerShell 5.1の文字コードと対話警告 GET で ETag を取得し PUT の If-Match ヘッダーに付与。 同日再実行の冪等性確保に必須。 日本語 ps1 は UTF-8 BOM付きで保存。 Invoke-WebRequest には -UseBasicParsing を付与。 Teams通知形式が Adaptive Card 必須 OpenClaw session-key は毎回変える { "text":"..." } では「Property type must be AdaptiveCard」。 Power Automate側のアクション次第で形式が変わる。 固定 session-key では GitHub Copilot 経由モデルで暗号化コンテ キスト関連エラーが発生。実行ごとに変更。 DO WHAT MATTERS 16
17. SUMMARY AIエージェントを業務に寄せる勘所 セルフホステッドAIエージェントは、クラウドAIの代替ではない クラウドAIだけでは直接触りにくい開発環境の近くで動ける点が固有の価値 データ取得・投稿はスクリプトで決定的に処理する 成功/失敗を追える・再実行できる・障害を切り分けられることが業務では不可欠 非定型な整理と示唆出しだけをAIに任せる Skillでレポート形式を固定し、事実とAI解釈を分けることで信頼性が上がる AIの自由度とスクリプトの決定性を組み合わせる この掛け合わせが、セルフホステッドAIエージェントの業務適用の現実解 AIに全部任せるのではなく、AIが得意な「曖昧な読み解き」と、スクリプトが得意な「確実な 処理」を組み合わせる。それが業務適用の現実解でした。 DO WHAT MATTERS 17
18. クラウドAIだけでは届かない場所へ：OpenClawで開発環境を棚卸しするPoC https://zenn.dev/yutakaosada/articles/b9e4129e14df27 THANK YOU Yutaka.Osada union.dml@gmail.com https://github.com/yutaka-art 読んでつなげる GitHub GH-900 GitHub Foundations 対応 発売中 DO WHAT MATTERS https://amzn.asia/d/09T6FSgp ▪今後の予定 10/22 Dev Days | Copilot CLI × DevOps - Avanade Japan https://avanadejapantech.connpass.com/event/406658/ 18