0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

TeraTermマクロ×ローカルLLMで「自然言語でLinuxサーバを操作する」エージェントを作った

0
Posted at

TeraTerm × ローカルLLM で「自然言語で Linux サーバを操作する」エージェントを作る

TeraTerm マクロと Ollama(ローカルLLM)を組み合わせて、自然言語で対話しながら Linux サーバのメンテナンスを進める環境の構築手順です。

作るものは 2 ファイルだけです。

  • agent_step.ps1
    • Ollama / ローカルLLM へ問い合わせ、次に実行すべきコマンドを 1 行だけ返す PowerShell スクリプト
  • agent_loop.ttl
    • TeraTerm から Linux サーバへ接続し、コマンド実行を制御する TeraTerm マクロ

検証環境は 以下の通りです。

  • TeraTerm 5.2
  • PowerShell 7.6.2
  • Ollama 0.31.1

概要

TeraTerm で SSH 接続した Linux サーバに対して、自然言語でタスクを指示できます。

例:

  • nginx が起動しているか確認して、止まっていたら起動して
  • ディスク使用量が多いディレクトリ上位5件を調べて
  • OS 名、カーネル、メモリ情報をまとめて
  • /var/log 配下で直近1時間に更新されたログを一覧して

処理の流れは以下の通りです。

  1. ユーザーが自然言語で作業内容を入力する
  2. TeraTerm マクロが task.txt に書き出し、PowerShell ヘルパーを起動する
  3. PowerShell がローカルLLMへ問い合わせる
  4. LLM が次に実行すべき Linux コマンドを 1 行返す
  5. TeraTerm がコマンド実行前に確認ダイアログを表示する
  6. ユーザーが承認すると Linux サーバへ送信する
  7. 実行結果を term_out.txt に記録し、LLM が読み取って次のコマンドを生成する
  8. LLM が DONE を返したらそのタスクは完了
  9. 「続けて別のタスクを実行しますか?」と聞かれるので、続ける場合は 1. に戻る

ポイントは、LLM とサーバの間をファイル経由で受け渡ししていることです。TeraTerm マクロには HTTP クライアントがないため、exec で PowerShell を起動し、生成されたテキストファイルをポーリングで拾う構成にしています。


全体構成

[ユーザー]
    │ 自然言語でタスク入力
    ▼
[TeraTerm マクロ (agent_loop.ttl)]
    │ task.txt を書く / exec で起動
    ▼
[PowerShell 7 (agent_step.ps1)]
    │ HTTP POST
    ▼
[Ollama (localhost:11434)]
    │ 次のコマンド 1 行
    ▼
[next_cmd_N.txt]
    │ マクロがポーリングで検知
    ▼
[確認ダイアログ] → 承認 → [Linux サーバへ送信]
    │
    ▼
[term_out.txt] → 次のステップで LLM へフィードバック

作業フォルダに生成されるファイルは以下の通りです。

ファイル 役割
task.txt ユーザーが入力したタスク(TeraTerm が書く)
history.json LLM との会話履歴。タスクごとにリセットされる
term_out.txt 直前のコマンドの実行結果(TeraTerm のログ機能で取得)
next_cmd_N.txt LLM が生成した N ステップ目のコマンド
ps_error.log PowerShell 側で例外が出たときだけ生成される

必要なもの

以下を Windows PC に用意します。

項目 検証したバージョン 補足
Windows 11 - Windows 10 でも動作します
TeraTerm 5.2 マクロは Shift-JIS で保存します(後述)
PowerShell 7.6.2 検証は 7.6.2 のみです
Ollama 0.31.1 ローカルLLM 実行環境
Linux サーバ - 必ず検証用サーバから始めてください
SSH 接続情報 - IPアドレス / ユーザー名 / パスワードまたは秘密鍵

文字コードは .ttl は Shift-JIS、.ps1 は UTF-8 (BOM付き)

ファイル 文字コード 改行
agent_loop.ttl Shift-JIS (cp932) CRLF
agent_step.ps1 UTF-8(BOM付き) CRLF

TeraTerm 5.x は UTF-8 マクロに対応しているという情報もありますが、手元の 5.2 では .ttl を UTF-8 (BOM 付き) で保存すると正常に動作しませんでした。Shift-JIS で保存したら解決しました。

.ps1 を Shift-JIS にする場合の注意
PowerShell 7 は BOM の無いファイルを UTF-8 として読みます。つまり Shift-JIS で保存した .ps1 は、日本語のコメントと日本語メッセージが内部的に文字化けした状態で実行されます。

コード部分はすべて ASCII なので動作には影響しませんが、ps_error.log に出るエラーメッセージの日本語も化けます。ログの日本語まで正しく出したい場合は、.ps1 だけ UTF-8 (BOM 付き) で保存してください。BOM があれば PowerShell 5.1 / 7 のどちらでも正しく読まれます。

Ollama のインストール

公式サイトから Windows 版をダウンロードします。

https://ollama.com/download/windows

インストール後、新しく PowerShell を開き、以下を実行します。

ollama --version

今回は 0.31.1 を使いました。

実行結果
ollama version is 0.31.1

バージョンが表示されれば正常です。表示されない場合は、インストール前から開いていた PowerShell に PATH が反映されていないだけのことが多いので、開き直してください。

モデルの取得

Linux コマンド生成向けのモデルとして、以下を使用します。

ollama pull qwen2.5-coder:7b

PC の性能が低い場合は、軽量モデルを使うこともできます。

ollama pull qwen2.5-coder:3b

取得済みモデルは以下で確認できます。

ollama list

いろいろと試していたので、いろんなモデルが入っていました。

実行結果
NAME                       ID              SIZE      MODIFIED
qwen2.5-coder:7b           dae161e27b0e    4.7 GB    4 hours ago
qwen2.5-coder:14b          9ec8897f747e    9.0 GB    2 months ago
qwen3-coder-next:latest    ca06e9e4087c    51 GB     2 months ago
qwen3.6:27b                a50eda8ed977    17 GB     2 months ago
qwen3:8b                   500a1f067a9f    5.2 GB    3 months ago
qwen3-coder:30b            06c1097efce0    18 GB     3 months ago
gemma4:26b                 5571076f3d70    17 GB     3 months ago
gpt-oss:120b               a951a23b46a1    65 GB     3 months ago
llama3.2:3b                a80c4f17acd5    2.0 GB    8 months ago

Ollama API の動作確認

PowerShell で以下を実行します。

(Invoke-WebRequest -Method POST `
  -Body '{"model":"qwen2.5-coder:7b","prompt":"say hello","stream":false}' `
  -Uri http://localhost:11434/api/generate).Content | ConvertFrom-Json

JSON の応答が返れば、Ollama の API が利用可能です。

実行結果
model                : qwen2.5-coder:7b
created_at           : 2026/07/11 4:00:14
response             : Hello! How can I assist you today?
done                 : True
done_reason          : stop
context              : {151644, 8948, 198, 2610…}
total_duration       : 3389525800
load_duration        : 3208186500
prompt_eval_count    : 31
prompt_eval_duration : 67513000
eval_count           : 10
eval_duration        : 106395000

load_duration が 3.2 秒ほどかかっている点に注目してください。初回はモデルのロードで待たされます。 後述するマクロ側のタイムアウトに引っかかることがあるので、実行前に一度 ollama run qwen2.5-coder:7b で常駐させておくと安定します。

作業フォルダの作成

以下のフォルダを作成します。

C:\temp\ttagent\

このフォルダに以下の2ファイルを配置します。

C:\temp\ttagent\agent_step.ps1
C:\temp\ttagent\agent_loop.ttl

PowerShell ヘルパーの作成

C:\temp\ttagent\agent_step.ps1 として、UTF-8(BOM付き) で保存します。

agent_step.ps1
#---------------------------------------------------------------------
# TeraTerm LLM Agent - PowerShell ヘルパー
#
# 検証環境: PowerShell 7.6.2
# 文字コード: UTF-8 (BOM付き) / 改行: CRLF
#   agent_loop.ttl と揃えて Shift-JIS で保存しています。
#   コード部分はすべて ASCII なので動作に影響はありませんが、
#   PowerShell 7 は BOM の無いファイルを UTF-8 として読むため、
#   このファイル内の日本語コメントと日本語メッセージは
#   内部的には文字化けした状態で扱われます(動作には影響しません)。
#   ps_error.log の日本語まで正しく出したい場合は
#   UTF-8 (BOM 付き) で保存し直してください。
#---------------------------------------------------------------------
param(
    [Parameter(Mandatory=$true)][string]$WorkDir,
    [Parameter(Mandatory=$true)][int]$Step,
    [string]$Model    = "qwen2.5-coder:7b",
    [string]$Endpoint = "http://localhost:11434/api/chat"
)

$ErrorActionPreference = "Stop"

$histPath = Join-Path $WorkDir "history.json"
$outLog   = Join-Path $WorkDir "term_out.txt"
$taskPath = Join-Path $WorkDir "task.txt"
$errPath  = Join-Path $WorkDir "ps_error.log"
$nextCmd  = Join-Path $WorkDir ("next_cmd_{0}.txt" -f $Step)

$utf8NoBom = New-Object System.Text.UTF8Encoding($false)

# cp932(Shift-JIS) エンコーディングを取得する。
# 注意: [System.Text.Encoding]::Default は
#       PowerShell 5.1 (.NET Framework) では ANSI(cp932)
#       PowerShell 7   (.NET Core)       では UTF-8
# となり意味が変わるため、Default に頼らず明示的に 932 を取得する。
$cp932 = $null
try {
    [System.Text.Encoding]::RegisterProvider([System.Text.CodePagesEncodingProvider]::Instance)
} catch {
    # .NET Framework では不要。失敗しても問題ない。
}
try {
    $cp932 = [System.Text.Encoding]::GetEncoding(932)
} catch {
    $cp932 = [System.Text.Encoding]::Default
}

#---------------------------------------------------------------------
# ユーティリティ
#---------------------------------------------------------------------

# TeraTerm の filewriteln は cp932、端末ログは UTF-8 のことが多く、
# 固定でどちらかを指定すると日本語が壊れる。バイト列から自動判定する。
function Read-TextAuto([string]$Path) {
    if (-not (Test-Path $Path)) { return "" }
    $bytes = [System.IO.File]::ReadAllBytes($Path)
    if ($bytes.Length -eq 0) { return "" }

    # BOM 付き UTF-8
    if ($bytes.Length -ge 3 -and $bytes[0] -eq 0xEF -and $bytes[1] -eq 0xBB -and $bytes[2] -eq 0xBF) {
        return [System.Text.Encoding]::UTF8.GetString($bytes, 3, $bytes.Length - 3)
    }

    # 例外を出す UTF-8 デコーダで検証。失敗したら cp932 とみなす
    try {
        $strict = New-Object System.Text.UTF8Encoding($false, $true)
        return $strict.GetString($bytes)
    } catch {
        return $cp932.GetString($bytes)
    }
}

# 端末ログから ANSI エスケープ・CR・プロンプト行を除去
function Clean-TermOutput([string]$Text) {
    if ([string]::IsNullOrEmpty($Text)) { return "" }

    # CSI / OSC などのエスケープシーケンス
    $Text = $Text -replace "`e\[[0-9;?]*[a-zA-Z]", ""
    $Text = $Text -replace "`e\][^`a]*`a", ""
    $Text = $Text -replace "`e[()][0-9A-B]", ""
    $Text = $Text -replace "`r", ""

    $lines = @($Text -split "`n" | Where-Object {
        $t = $_.Trim()
        ($t -ne "") -and ($t -ne "TTAGENT>") -and (-not $t.StartsWith("TTAGENT>"))
    })

    # 巨大な出力で LLM の入力が溢れないよう末尾 200 行 / 8000 文字に制限
    if ($lines.Count -gt 200) { $lines = $lines[-200..-1] }
    $out = ($lines -join "`n").Trim()
    if ($out.Length -gt 8000) { $out = $out.Substring($out.Length - 8000) }
    return $out
}

# ConvertFrom-Json は PSCustomObject を返すため、ハッシュテーブルに揃える
function Normalize-Messages($Raw) {
    $list = New-Object System.Collections.ArrayList
    foreach ($m in @($Raw)) {
        [void]$list.Add(@{ role = [string]$m.role; content = [string]$m.content })
    }
    # PowerShell は return でコレクションを展開してしまうため、
    # カンマ演算子でラップして ArrayList のまま返す(.Add() を使うのに必須)
    return ,$list
}

#---------------------------------------------------------------------
# 本体
#---------------------------------------------------------------------
try {

    # 直近のコマンド出力を取得
    $termOut = Clean-TermOutput (Read-TextAuto $outLog)

    # 会話履歴を読み込む、または初期化
    if (Test-Path $histPath) {
        $messages = Normalize-Messages ((Read-TextAuto $histPath) | ConvertFrom-Json)
    } else {
        $task = (Read-TextAuto $taskPath).Trim()
        if ($task -eq "") { throw "task.txt が空です: $taskPath" }

        $system = @"
You are operating a Linux server over a non-interactive SSH terminal.

Reply with EXACTLY ONE shell command to run next, and nothing else.
No explanation, no markdown, no backticks, no leading prompt characters.

Rules for the command:
- It must terminate on its own. Never use interactive programs
  (vi, vim, nano, top, less, more, man, watch, tail -f, ssh, su).
- Pipe anything that might page through 'cat' or add a non-interactive flag.
- Keep it to a single line. Chain with '&&' or ';' if truly needed.
- Prefer read-only inspection commands unless the task requires changes.

When the task is fully complete, reply with the single token: DONE

Task: $task
"@
        $messages = Normalize-Messages @(@{ role = "system"; content = $system })
    }

    # 念のため ArrayList であることを保証(要素1件のときの展開対策)
    if ($messages -isnot [System.Collections.ArrayList]) {
        $tmpList = New-Object System.Collections.ArrayList
        foreach ($m in @($messages)) { [void]$tmpList.Add($m) }
        $messages = $tmpList
    }

    # 前回コマンドの出力を LLM に渡す
    if ($termOut.Length -gt 0) {
        [void]$messages.Add(@{ role = "user"; content = "Output of the previous command:`n$termOut" })
    } else {
        [void]$messages.Add(@{ role = "user"; content = "No output yet. Provide the first command." })
    }

    # Ollama API 呼び出し
    # PowerShell 7 は文字列ボディを UTF-8 で送るが、5.1 は既定エンコーディングで
    # 送るため日本語が壊れる。どちらでも動くよう UTF-8 バイト列に変換して渡す。
    $bodyJson  = @{
        model    = $Model
        messages = @($messages)
        stream   = $false
        options  = @{ temperature = 0.1 }
    } | ConvertTo-Json -Depth 20

    $bodyBytes = [System.Text.Encoding]::UTF8.GetBytes($bodyJson)

    $resp = Invoke-RestMethod `
        -Uri $Endpoint `
        -Method Post `
        -Body $bodyBytes `
        -ContentType "application/json; charset=utf-8" `
        -TimeoutSec 600

    if ($null -eq $resp.message -or $null -eq $resp.message.content) {
        throw "Ollama の応答に message.content がありません: " + ($resp | ConvertTo-Json -Depth 5)
    }

    $content = ([string]$resp.message.content).Trim()

    # <think> ... </think> を除去(reasoning 系モデル対策)
    $content = $content -replace '(?s)<think>.*?</think>', ''

    # コードフェンスを除去
    $content = $content.Trim()
    $content = $content -replace '(?s)^```[a-zA-Z]*\s*', '' -replace '(?s)\s*```$', ''

    # 最初の非空行のみ採用
    $first = ($content -split "`r?`n" | Where-Object { $_.Trim() -ne "" } | Select-Object -First 1)
    if ($null -eq $first) { throw "LLM が空の応答を返しました。" }
    $content = $first.Trim()

    # 先頭のプロンプト文字や "$ " を除去
    $content = $content -replace '^(TTAGENT>|\$|#)\s*', ''
    $content = $content.Trim()

    # DONE の揺れを吸収("DONE." / "done" など)
    if ($content -match '^\s*DONE[\s\.\!]*$') { $content = "DONE" }

    if ($content -eq "") { throw "整形後のコマンドが空になりました。" }

    # 会話履歴を保存(BOM なし UTF-8。BOM 付きだと ConvertFrom-Json が失敗しうる)
    [void]$messages.Add(@{ role = "assistant"; content = $content })
    $histJson = @($messages) | ConvertTo-Json -Depth 20
    [System.IO.File]::WriteAllText($histPath, $histJson, $utf8NoBom)

    # 次に実行するコマンドを書き出す
    # マクロが filesearch で検知するので、一時ファイル経由で原子的に置く
    $tmp = "$nextCmd.tmp"
    [System.IO.File]::WriteAllText($tmp, $content, $utf8NoBom)
    Move-Item -Force $tmp $nextCmd
}
catch {
    # 失敗を必ず可視化する。これが無いとマクロ側が無限に待ち続ける
    $msg = @"
[$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')] Step $Step
$($_.Exception.Message)

$($_.ScriptStackTrace)
"@
    [System.IO.File]::WriteAllText($errPath, $msg, $utf8NoBom)

    # マクロを待たせ続けないよう、DONE を書いて停止させる
    [System.IO.File]::WriteAllText($nextCmd, "DONE", $utf8NoBom)
    exit 1
}

設計上のポイント

  • try / catch で全体を囲む
    失敗しても必ず next_cmd_N.txt に DONE を書きます。これが無いと、マクロ側がファイルの生成を永久に待ち続けて固まります。原因は ps_error.log に残ります。
  • LLM の出力を厳しく整形する
    コードモデルは指示に反してコードフェンスを付けたり、説明を添えたりします。フェンス除去・最初の1行だけ採用・先頭のプロンプト文字除去、をまとめて行っています。
  • 端末ログの掃除と上限
    ANSI エスケープを落とし、末尾 200 行 / 8000 文字に制限しています。制限しないと、ステップが進むほど入力が膨張して 7B クラスのモデルが破綻します。
  • 対話型コマンドの禁止をシステムプロンプトで明示
    top や less が返ってこないと、マクロの wait が永久に止まります。ここは実用上かなり効きました。
  • [Encoding]::Default を使わない
    PowerShell 5.1 と 7 で意味が変わるためです。詳細は後述の「ハマりどころ」に書きます。

PowerShell ヘルパーの単体テスト

マクロを組む前に、ヘルパー単体で動くことを確認しておくと切り分けが楽です。

作業フォルダに task.txt を作成します。

task.txt
OSの情報を確認して

PowerShell 7 で以下を実行します。

cd C:\temp\ttagent
Remove-Item history.json,next_cmd_*.txt,ps_error.log,term_out.txt -ErrorAction SilentlyContinue
.\agent_step.ps1 -WorkDir "C:\temp\ttagent" -Step 1
Get-Content next_cmd_1.txt

next_cmd_1.txt が生成され、中身に Linux コマンドが入っていれば成功です。

next_cmd_1.txt
uname -a

注意
再テストするときは、必ず history.json を削除してください。残っていると前回の会話の続きとして扱われ、いきなり DONE が返ってきたりします。

また -WorkDir に渡すパスの末尾にバックスラッシュを付けないでください。理由は後述の「ハマりどころ」に書きます。

TeraTerm マクロの作成

C:\temp\ttagent\agent_loop.ttl として、Shift-JIS (cp932) で保存します。

agent_loop.ttl
;=====================================================================
; TeraTerm LLM Agent
; TeraTerm + PowerShell 7 + Ollama
;
; 接続を維持したまま、タスクを繰り返し投入できる版
;
; 検証環境: TeraTerm 5.2 / PowerShell 7.6.2
; 文字コード: Shift-JIS (cp932) / 改行: CRLF
;   TeraTerm 5.2 の ttpmacro は UTF-8 のマクロを正しく扱えないため、
;   このファイルは必ず Shift-JIS で保存すること。
;=====================================================================

;--- 設定 ----------------------------------------------------------
; WORKDIR  : TTL 内でのパス連結用(末尾に \ が必要)
; WORKDIRQ : コマンドライン引数用(末尾の \ は閉じ引用符をエスケープ
;            してしまうため、必ず付けないこと)
WORKDIR  = 'C:\temp\ttagent\'
WORKDIRQ = 'C:\temp\ttagent'

; PowerShell 7 の実行ファイル名。5.1 を使う場合は 'powershell' にする。
PSEXE   = 'pwsh'

MODEL   = 'qwen2.5-coder:7b'
PROMPT  = 'TTAGENT>'
MAXSTEP = 20
timeout = 60

HELPER = WORKDIR
strconcat HELPER 'agent_step.ps1'

TASKF = WORKDIR
strconcat TASKF 'task.txt'

OUTLOG = WORKDIR
strconcat OUTLOG 'term_out.txt'

HISTF = WORKDIR
strconcat HISTF 'history.json'

ERRLOG = WORKDIR
strconcat ERRLOG 'ps_error.log'

;--- 起動前チェック ------------------------------------------------
; ヘルパーが無ければ即座に知らせる(無限待ちの防止)
filesearch HELPER
if result = 0 then
    messagebox HELPER 'ヘルパーが見つかりません'
    end
endif

;--- SSH 接続設定 --------------------------------------------------
; 環境に合わせて編集すること
connect '192.168.0.10:22 /ssh /2 /auth=password /user=USER /passwd=PASSWORD'

;--- プロンプトを固定 ---------------------------------------------
wait '$' '#'
sendln 'export PS1="TTAGENT>"'
; sendln のエコー自体に TTAGENT> が含まれ wait が誤マッチするため、
; 一度受信バッファを捨ててから空 Enter で本物のプロンプトを取り直す
pause 1
flushrecv
sendln ''
wait PROMPT

;=====================================================================
; タスク投入ループ(ここから繰り返し)
;=====================================================================
:newtask

;--- 前タスクの状態をリセット --------------------------------------
; history.json を残すと前のタスクの続きを実行してしまうため必ず削除
filesearch HISTF
if result <> 0 then
    filedelete HISTF
endif

filesearch OUTLOG
if result <> 0 then
    filedelete OUTLOG
endif

filesearch ERRLOG
if result <> 0 then
    filedelete ERRLOG
endif

; next_cmd_*.txt をまとめて削除(TTL にワイルドカード削除が無いため総当り)
CLEANI = 0
:cleanloop
CLEANI = CLEANI + 1
if CLEANI > MAXSTEP then
    goto cleandone
endif
sprintf2 CLEANF '%snext_cmd_%d.txt' WORKDIR CLEANI
filesearch CLEANF
if result <> 0 then
    filedelete CLEANF
endif
goto cleanloop
:cleandone

;--- タスク入力 ----------------------------------------------------
; 注意: inputbox の直後に result を見てはいけない。
; inputbox は result を更新しないため、直前の filesearch の
; 戻り値(0)が残っており、キャンセル扱いで終了してしまう。
; 入力の有無は inputstr の長さで判定すること。
inputbox 'LLM にやらせたいタスクを入力してください:' 'Tera Term LLM Agent'
TASK = inputstr

strlen TASK
if result = 0 then
    ; キャンセル、または空入力
    yesnobox 'タスクが入力されませんでした。マクロを終了しますか?' 'Tera Term LLM Agent'
    if result = 1 then
        goto quit
    endif
    goto newtask
endif

; 既存の task.txt を空に切り詰める
; (存在しないと filetruncate がエラーになるので filecreate で先に作成)
filesearch TASKF
if result = 0 then
    filecreate tf TASKF
    fileclose tf
endif
filetruncate TASKF 0
fileopen tf TASKF 1
filewriteln tf TASK
fileclose tf

STEP = 0

;=====================================================================
; ステップ実行ループ
;=====================================================================
:loop
STEP = STEP + 1
if STEP > MAXSTEP then
    messagebox '最大ステップ数に達しました。' 'Agent'
    goto taskend
endif

;--- 今回のステップの出力先を用意 ---------------------------------
sprintf2 NEXTCMD '%snext_cmd_%d.txt' WORKDIR STEP

; 残骸があると PowerShell の完了を待たずに古い内容を読むため削除
filesearch NEXTCMD
if result <> 0 then
    filedelete NEXTCMD
endif

;--- PowerShell ヘルパー起動 --------------------------------------
; 引用符の入れ子で壊れやすいので sprintf2 で一括生成する。
; WORKDIRQ(末尾 \ なし)を使うこと。
sprintf2 COMMAND 'cmd /c %s -NoProfile -ExecutionPolicy Bypass -File "%s" -WorkDir "%s" -Step %d -Model "%s"' PSEXE HELPER WORKDIRQ STEP MODEL

; デバッグ時はここのコメントを外すと実際に渡す文字列を確認できる
; messagebox COMMAND 'exec する内容'

exec COMMAND  'hide'

;--- next_cmd_<STEP>.txt の生成待ち -------------------------------
WAITED = 0
:waitfile
filesearch NEXTCMD
if result = 0 then
    pause 1
    WAITED = WAITED + 1
    ; 600 秒待っても出てこない場合は PowerShell が落ちたとみなす
    if WAITED > 600 then
        messagebox 'PowerShell の応答がありません。ps_error.log を確認してください。' 'Agent'
        goto taskend
    endif
    goto waitfile
endif

; 書き込み完了を待つ(Move-Item 直後の読み取り競合を避ける)
pause 1

fileopen nf NEXTCMD 0 1
filereadln nf CMD
fileclose nf

;--- 空応答の保護 --------------------------------------------------
strlen CMD
if result = 0 then
    messagebox 'LLM が空の応答を返しました。' 'Agent'
    goto taskend
endif

;--- 完了判定 ------------------------------------------------------
strcompare CMD 'DONE'
if result = 0 then
    messagebox 'タスク完了。' 'Agent'
    goto taskend
endif

;--- 実行前確認 ----------------------------------------------------
CONFIRM = '次のコマンドを実行しますか?'#13#10#13#10
strconcat CONFIRM CMD
yesnobox CONFIRM 'コマンド確認'
if result <> 1 then
    messagebox 'このタスクを中止しました。' 'Agent'
    goto taskend
endif

;--- コマンド実行とログ取得 ----------------------------------------
logopen OUTLOG 0 0
flushrecv
sendln CMD
wait PROMPT
logclose

goto loop

;=====================================================================
; タスク終了時:続行するか確認
;=====================================================================
:taskend
yesnobox '続けて別のタスクを実行しますか?' 'Tera Term LLM Agent'
if result = 1 then
    ; 接続は維持したまま次のタスクへ
    flushrecv
    goto newtask
endif

;=====================================================================
:quit
; disconnect は「自動ウィンドウクローズ」設定次第で TeraTerm ごと
; 閉じてしまうため、既定では呼ばずにマクロだけ終了する。
; セッションはそのまま手動で使える。切断したい場合は次行を有効にする。
; disconnect 0
end

TeraTerm マクロの編集箇所

以下は必ず自分の環境に合わせて変更します。

作業フォルダ

2 つセットで書き換えてください。 WORKDIR は末尾にバックスラッシュが必要、WORKDIRQ は付けてはいけません。

WORKDIR  = 'C:\temp\ttagent\'
WORKDIRQ = 'C:\temp\ttagent'

PowerShell の実行ファイル

PowerShell 7 を使う場合は pwsh、Windows PowerShell 5.1 を使う場合は powershell にします。

PSEXE = 'pwsh'

pwsh が PATH に無いとマクロが失敗します。事前にコマンドプロンプトで pwsh -Version が通ることを確認してください。通らない場合は、フルパスを書いても構いません。

PSEXE = '"C:\Program Files\PowerShell\7\pwsh.exe"'

使用するモデル

MODEL = 'qwen2.5-coder:7b'

SSH 接続先

connect '192.168.0.10:22 /ssh /2 /auth=password /user=USER /passwd=PASSWORD'

鍵認証を使う場合は、例えば以下のようにします。マクロにパスワードを平文で書かずに済むので、こちらを推奨します。

connect '192.168.0.10:22 /ssh /2 /auth=publickey /user=USER /keyfile=C:\keys\id_rsa'

マクロファイルの取り扱いに注意
connect 行にはパスワードが平文で残ります。マクロを Git に上げたり、そのまま共有したりしないでください。

実行方法

TeraTerm を起動し、以下のメニューからマクロを実行します。

コントロール → マクロ

そして、以下のファイルを選択します。

C:\temp\ttagent\agent_loop.ttl

または、コマンドラインから直接実行します。

& "C:\Program Files\teraterm5\ttpmacro.exe" "C:\temp\ttagent\agent_loop.ttl"

実行時の流れ

マクロを起動すると、以下の流れで動作します。

  1. TeraTerm が Linux サーバへ SSH 接続する
  2. Linux のプロンプトを TTAGENT> に固定する
  3. 前回実行時の history.json / term_out.txt / next_cmd_*.txt を掃除する
  4. タスク入力ダイアログが表示される
  5. 自然言語で作業内容を入力する
  6. PowerShell が起動し、LLM が次に実行するコマンドを生成する
  7. TeraTerm に確認ダイアログが表示される
  8. 内容を確認して「はい」を押す
  9. コマンドが Linux サーバ上で実行され、結果が term_out.txt に保存される
  10. LLM が結果を読み、次のコマンドを生成する(6. に戻る)
  11. LLM が DONE を返すと「タスク完了。」が表示される
  12. 「続けて別のタスクを実行しますか?」で「はい」を選ぶと、接続を維持したまま 3. に戻る

PowerShell のウィンドウが毎ステップ一瞬だけ表示されますが、これは cmd /c の正常な動作です。

入力例

タスク入力ダイアログには、以下のように入力できます。

このサーバのOS名、カーネルバージョン、メモリ容量を確認して
ディスク使用量が多いディレクトリを上位5件調べて
nginx が起動しているか確認して、停止していれば起動して
/var/log 配下で直近1時間以内に更新されたログファイルを一覧して

ハマりどころ

ここが今回一番苦労した部分です。同じ構成を作る方の役に立つと思うのでまとめておきます。

1. TTL のシングルクォート内でバックスラッシュはエスケープされない

最初、こう書いていました。

WORKDIR = 'C:\\Users\\toshi\\teraterm_ai'

TTL のシングルクォート文字列は \\ をエスケープ処理しないため、これは C:\\Users\\toshi\\teraterm_ai というそのまま壊れたパスになります。さらに末尾のバックスラッシュが無いので、strconcat した結果が ...teraterm_aiagent_step.ps1 になり、PowerShell が起動すらしませんでした。

マクロは無言でファイルの生成を待ち続けるので、原因にたどり着くまで時間がかかりました。

2. コマンドライン末尾のバックスラッシュが閉じ引用符をエスケープする

これが一番わかりにくかった不具合です。

-WorkDir "C:\temp\ttagent\" -Step 1 -Model "qwen2.5-coder:7b"

\" は「エスケープされた引用符」と解釈されるため、WorkDir の値が

C:\temp\ttagent" -Step 1 -Model

まで飲み込まれ、-Step が消滅します。結果、PowerShell が

コマンド パイプライン位置 1 のコマンドレット agent_step.ps1
次のパラメーターに値を指定してください:
Step:

と入力待ちで停止していました。WORKDIR と WORKDIRQ を分けているのはこのためです。

3. inputbox は result を更新しない

キャンセル判定のつもりでこう書いたところ、OK を押しても必ず終了するようになりました。

inputbox 'タスクを入力してください:' 'Agent'
if result = 0 then
    goto quit
endif

inputbox は result を更新しません。そのため直前の filesearch が残した 0 が読まれ、常にキャンセル扱いになります。入力の有無は strlen inputstr で判定してください。

4. PowerShell の return はコレクションを展開する

function Normalize-Messages($Raw) {
    $list = New-Object System.Collections.ArrayList
    # ...
    return $list      # ← 要素1件だと中身の Hashtable そのものが返る
}

これで、後続の $messages.Add(@{...}) が Hashtable の Add(key, value) を呼びに行き、

"Add" のオーバーロードで、引数の数が "1" であるものが見つかりません。

というエラーになりました。return ,$list とカンマ演算子でラップすれば展開を防げます。

5. [Encoding]::Default は PowerShell 5.1 と 7 で意味が違う

これは知らないと相当ハマります。

[System.Text.Encoding]::Default
PowerShell 5.1 (.NET Framework) ANSI(日本語環境では cp932)
PowerShell 7 (.NET Core) UTF-8

TeraTerm の filewriteln は cp932 で書き込むため、5.1 の感覚で Default を使うと、PowerShell 7 では cp932 のバイト列を UTF-8 として解釈して盛大に化けます。GetEncoding(932) を明示的に取得してください。

なお .NET Core では、GetEncoding(932) を使う前に CodePagesEncodingProvider の登録が必要な場合があります。スクリプトでは try/catch で囲んで、どちらの環境でも通るようにしています。

6. Invoke-RestMethod のボディは UTF-8 バイト列で渡す

PowerShell 7 は文字列ボディを UTF-8 で送るので問題ありませんが、5.1 は既定エンコーディングで送るため日本語のタスク文が Ollama に化けて届きます。両対応にするなら、明示的にバイト列へ変換するのが確実です。

$bodyBytes = [System.Text.Encoding]::UTF8.GetBytes($bodyJson)
Invoke-RestMethod -Body $bodyBytes -ContentType "application/json; charset=utf-8" ...

7. TeraTerm 5.2 のマクロは Shift-JIS でないと動かない

TeraTerm 5.x は UTF-8 対応が進んでいますが、手元の 5.2 では .ttl を UTF-8 (BOM 付き) で保存すると正常に動作しませんでした。Shift-JIS で保存したら解決しました。

.ps1 については、PowerShell 7 は BOM の無いファイルを UTF-8 として読むため、Shift-JIS の .ps1 は日本語部分が化けた状態で解釈されます。コードがすべて ASCII なのでhift-JISで保存しても動きはしますが、正確には「化けても困らないから動いている」という状態です。

.ps1 は BOM さえ付いていれば PowerShell 5.1 / 7 のどちらも正しく読むので、日本語コメントやログを正しく扱いたいなら .ps1 だけ UTF-8 (BOM 付き) にするのが本来は正解です。

8. wait がコマンドのエコーに誤マッチする

sendln 'export PS1="TTAGENT>"'
wait PROMPT

送信したコマンド自体がエコーバックされ、その中に TTAGENT> が含まれるため、wait は本物のプロンプトが出る前に抜けてしまいます。以降の同期が 1 つずれる原因になります。flushrecv してから空 Enter でプロンプトを取り直すのが確実です。

9. disconnect で TeraTerm ごと閉じる

disconnect は「自動ウィンドウクローズ」設定次第で TeraTerm 本体を終了させます。今回はマクロだけ終了させ、セッションは手動操作用に残す方針にしました。

注意点

この仕組みは、LLM が生成した Linux コマンドを実サーバで実行するため、誤操作のリスクがあります。

必ず以下を守ってください。

  • 最初は検証用サーバで試す
  • 本番サーバでは慎重に使う
  • コマンド確認ダイアログを外さない
  • rm -rf など破壊的なコマンドが提案されたら承認しない
  • SSH ユーザーの権限は最小限にする
  • sudo を無制限に許可しない
  • MAXSTEP で実行回数の上限を設ける

特に 3 番目が要です。ローカルLLM は指示を取り違えることが普通にあります。確認ダイアログは「安全装置」ではなく「唯一の安全装置」だと考えてください。

よくあるトラブル

ollama が見つからない

インストール前から開いていた PowerShell では PATH が反映されていない場合があります。新しい PowerShell を開き直してください。

next_cmd_1.txt が生成されない / マクロが固まる

まず ps_error.log を確認してください。 ヘルパーは例外を catch してここに書き出します。ファイルが存在すれば、PowerShell 側で失敗しています。

ps_error.log すら生成されない場合は、PowerShell が起動できていません。以下を確認します。

  • pwsh が PATH に通っているか(pwsh -Version)
  • Ollama が起動しているか(ollama list が通るか)
  • モデルを pull 済みか
  • agent_step.ps1 のパスが正しいか
  • 実行ポリシーで止まっていないか

マクロの exec COMMAND の直前で、実際に渡している文字列を確認するのが一番早いです。

messagebox COMMAND 'exec する内容'

単体テストも有効です。

pwsh -NoProfile -ExecutionPolicy Bypass -File "C:\temp\ttagent\agent_step.ps1" -WorkDir "C:\temp\ttagent" -Step 1

初回だけタイムアウトする

マクロは 600 秒待って応答が無ければ諦めます。モデルのロードに時間がかかる環境では、初回だけこれを超えることがあります。

事前にモデルを常駐させておくと安定します。

ollama run qwen2.5-coder:7b

待機上限(if WAITED > 600)を引き上げても構いません。

TeraTerm がプロンプト待ちで止まる

top や less のような対話型コマンドが実行されると、プロンプトが返らず wait が永久に待ちます。システムプロンプトで禁止していますが、モデルが指示を無視することはあります。

確認ダイアログでそういったコマンドが出てきたら「いいえ」を選んでください。止まってしまった場合は、TeraTerm 上で q や Ctrl+C を送ると復帰できることがあります。

プロンプト検出そのものが怪しい場合は、実際の表示を目視で確認してください。

sendln 'export PS1="TTAGENT>"'
wait PROMPT

日本語が文字化けする

原因は主に 3 つです。

  1. agent_loop.ttl を UTF-8 で保存した
    TeraTerm 5.2 では Shift-JIS で保存し直してください。ダイアログの日本語が化けるのはこれが原因です。
  2. ps_error.log の日本語だけが化ける
    agent_step.ps1 を Shift-JIS (BOM 無し) で保存していると、PowerShell 7 が UTF-8 として読むため、スクリプト内の日本語メッセージが化けます。動作自体には影響しません。ログの日本語も正しく出したい場合は、.ps1 を UTF-8 (BOM 付き) で保存し直してください。
  3. サーバ側のロケールと TeraTerm の端末文字コードが不一致
    TeraTerm の「設定 → 端末」で受信の文字コードを確認してください。

なお term_out.txt と task.txt の読み込みは、スクリプト内の Read-TextAuto がバイト列を見て UTF-8 / cp932 を自動判定するので、こちら側の調整は基本的に不要です。

sudo で止まる

sudo 実行時にパスワード入力待ちになると、マクロが止まります。

対策としては以下があります。

  • sudo を使う作業を避ける
  • 検証環境でのみ NOPASSWD を設定する
  • sudo パスワード入力処理を TeraTerm マクロに追加する

改善案

破壊的コマンドの明示的な禁止

システムプロンプトには既に「原則として読み取り専用を優先する」という指示を入れていますが、より強く縛るなら禁止コマンドを列挙するのが効果的です。

Never suggest destructive commands such as rm -rf, mkfs, dd, shutdown, reboot,
userdel, groupdel, chmod -R 777, or commands that overwrite important system files.

マクロ側でのブラックリスト

より確実なのは、LLM の指示ではなくマクロ側で弾く方法です。確認ダイアログの前に、strmatch で危険なパターンを検出して自動的に中止する処理を挟めます。LLM の出力に依存しないので、こちらのほうが安全性は高くなります。

実行ログの保存

term_out.txt はステップごとに上書きされます。監査目的で全履歴を残したい場合は、logopen の追記フラグを使うか、ステップごとに別名で保存する形に変えるとよいです。

まとめ

この構成では、以下の役割分担になります。

部品 役割
TeraTerm Linux サーバへ SSH 接続し、コマンドを送信する
TTL マクロ 実行ループ、ログ取得、承認ダイアログを制御する
PowerShell 7 Ollama API との通信、履歴管理、出力の整形を担当する
Ollama ローカルLLM を実行する
Linux サーバ 実際の操作対象

ローカルLLM だけで完結するので、サーバの構成情報が外部に出ないのが利点です。一方で 7B クラスのモデルは指示を取り違えることもあるため、確認ダイアログは必ず残したまま使ってください。

まずは検証サーバで、以下のような安全なタスクから試すのがおすすめです。

このサーバのOS情報を確認して
現在のディスク使用量を確認して
現在ログインしているユーザーとホスト名を確認して
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?