SO-101のキャリブレーションが失敗するときの原因は、ほぼ「モーターの電圧違い」「wrist_roll(手首回転)の位置ずれ」「コマンドの引数の種類違い」の3つに当てはまります。 キャリブレーションとは、ロボットの各関節に「ここが0度、ここが可動域の端」を一つずつ記憶させる作業のことです。この記事では、LeRobot公式リポジトリ(huggingface/lerobot)のGitHub Issueで原因と直し方が確認できた事例だけを扱います。
この記事で分かること
- 「Input voltage error」でモーターが見つからないときは、リーダー用(5V系)とフォロワー用(12V系)のモーターを取り違えていないか確認する
- wrist_rollで「Magnitude ... exceeds 2047」のエラーが出る・リーダーとフォロワーで手首のゼロ点が合わないのは既知の不具合で、PR #3373で修正されている
- リーダーアームは`--robot.type`ではなく`--teleop.type`で指定する。選択肢にso101_leaderが出てこないのは引数の種類違いが原因
対象読者:SO-101組み立てガイドの手順どおり組んだのに、キャリブレーションでエラーや動作不良にあたった人
執筆:ゆるふわフィジカルAI編集部 最終更新日:2026年11月8日
まず症状を確認する
| 症状 | 多い原因 | 対処 |
|---|---|---|
lerobot-setup-motors中に「Input voltage error」「Motor 'xxx' was not found」 | リーダー用(5V系)とフォロワー用(12V系)のモーターを取り違えている | ギア比の印字でモーターを見分け、電源を正しい組に接続し直す |
lerobot-calibrate中に「Magnitude 2073 exceeds 2047」のようなエラーで落ちる | wrist_rollが真ん中(生の値で約2048)付近にない状態で開始した | wrist_rollを手で真ん中付近に回してから開始、または最新版のlerobotに更新する |
| テレオペでリーダーとフォロワーの手首の向きが合わない | 較正を始めた位置がそのまま「0」になる設計。開始位置がずれていた | 両アームのグリッパーの向きを揃えてから較正をやり直す |
--robot.typeの選択肢にso101_leaderが出てこない | リーダーはrobotではなくteleop(遠隔操作デバイス)として扱われる | --teleop.type=so101_leaderで指定する |
次の章から、それぞれの原因と直し方を詳しく見ていきます。
症状1: モーターが見つからない・「Input voltage error」が出る
SO-101は、リーダーアームとフォロワーアームで推奨電圧の異なるモーターを使い分けます。見た目がほぼ同じため、取り違えて接続してしまう報告がGitHub Issueに複数あります1。
リーダー用
- 推奨電圧は5V系
- ギア比がモーター側に印字されている
- 12V電源に繋ぐと起動時にInput voltage errorが出ることがある
フォロワー用
- 推奨電圧は12V系
- 見た目はリーダー用とほぼ同じ
- 5V電源では正しく動かない
Issue #2387では、ID 2(shoulder_lift)のモーターだけが「Input voltage error」で停止し、その後のキャリブレーションが「Missing motor IDs: 2」で止まったと報告されています。報告者とメンテナ(imstevenpmwork氏)のやり取りによると、リーダー用モーターに12V電源をつないでいたことが原因でした。5V電源に切り替えたところ解決したと複数の報告者が追記しています1。
見た目では判別しづらい
リーダー用とフォロワー用のモーターは外見がほぼ同じです。Issue上では「ギア比の印字」で見分けられると報告されていますが、組み立て済みで印字を確認しづらい場合もあります。配線を一度抜いて差し直すだけで直ったという報告もあるので、電圧を見直す前にまず試す価値があります1。
症状2: wrist_rollのキャリブレーションで落ちる・手首の向きが合わない
もう一つ多いのが、手首の回転軸(wrist_roll)に関する不具合です。Issue #3193では、lerobot 0.5.1時点で2つの問題が報告されています2。
ValueError: Magnitude 2073 exceeds 20471つ目は、lerobot-calibrate実行時にwrist_rollが生の位置で約2048付近にないと、上記のようなエラーで落ちるというものです。原因は、較正処理が「全モーターが中央(約2048)付近にある」という前提で動くためで、画面にはwrist_rollを事前に中央へ回しておく案内が出ません。2つ目は、リーダーとフォロワーでwrist_rollのゼロ点が対応せず、手首のテレオペがずれるという問題です。
Issue上のやり取りによると、1つ目のクラッシュはメンテナ(Maximellerbach氏)によるPR #3373で修正され、2026年4月14日にIssueがクローズされています2。2つ目のゼロ点ずれについては、「較正を始める時点で両アームのグリッパーの向きを揃えておけば起きない」という回答がメンテナから示されています。開始位置がそのまま関節の「0」として記録されるため、開始時の姿勢合わせが重要という理屈です。ただし、手首に物理ストッパーがある個体では、較正後も180度近いずれが残ったという報告も続いています2。
公式の案内では
lerobotを最新版に更新していれば1つ目のクラッシュは起きないはずです。それでも手首の向きがずれる場合は、較正を始める前に両アームのグリッパーを同じ向きに揃えることを試してください。Issue上ではこれでも直らない個体の報告があり、その場合はFeetechのデバッグツールでモーターの生の値を確認しながら新しいIssueを立てるよう、メンテナが案内しています2。
症状3: --robot.typeの選択肢にso101_leaderが出てこない
較正コマンドを打つときに、リーダーアームを--robot.type=so101_leaderで指定しようとして、選択肢に存在しないというエラーに当たることがあります。
Issue #1595では、フォロワー側の較正は--robot.type=so101_followerで成功したのに、リーダー側で同じ形式を使ったところエラーになったと報告されています。原因は単純で、リーダーアームはロボット本体(robot)ではなく、操作する側のデバイス(teleop)として扱われるためです3。
# ❌ リーダーをrobotとして指定するとエラーになる
python -m lerobot.calibrate --robot.type=so101_leader --robot.port=/dev/ttyACM1
# ✅ リーダーはteleopとして指定する
python -m lerobot.calibrate --teleop.type=so101_leader --teleop.port=/dev/ttyACM1報告者自身が「--robot.typeではなく--teleop.typeにすべきだった」とコメントして解決しており、メンテナからの追加説明はIssue上に残っていません3。SO-101組み立てガイドやLeRobot Tutorialのコマンド例でも、フォロワーは--robot.*、リーダー(テレオペ側)は--teleop.*という書き分けになっているので、見比べてみてください。
詰まったときに確認する順序
電圧を確認
リーダー=5V系/フォロワー=12V系
wrist_rollを中央に
開始前に手で真ん中へ
引数を確認
リーダーはteleop、フォロワーはrobot
よくある質問
Q. SO-101のキャリブレーションで「Input voltage error」が出たらどうすればいいですか?
A. リーダー用(5V系)とフォロワー用(12V系)のモーターを取り違えて接続していないか確認してください。GitHub Issueの報告では、電源を正しい組に接続し直すことで解決した例が複数あります。配線を抜いて差し直すだけで直った例もあるので、まず試す価値があります。
Q. wrist_rollのキャリブレーションで「Magnitude ... exceeds 2047」というエラーが出ます。
A. lerobot 0.5.1時点で報告されていた既知の不具合で、wrist_rollが中央付近にない状態で較正を始めると発生します。この問題はメンテナのPR #3373で修正済みなので、まずlerobotを最新版に更新してください。更新できない場合は、較正を始める前にwrist_rollを手で中央付近まで回してから実行してください。
Q. リーダーアームのキャリブレーションで--robot.typeの選択肢にso101_leaderが出てきません。
A. リーダーアームはロボット本体(robot)ではなく、操作する側のデバイス(teleop)として扱われます。--robot.type=so101_leaderではなく、--teleop.type=so101_leaderで指定してください。フォロワーは--robot.*、リーダーは--teleop.*という書き分けになります。
まとめ
- 「Input voltage error」はリーダー(5V系)とフォロワー(12V系)のモーター取り違えが多い原因。電圧と配線を見直す
- wrist_rollのクラッシュはPR #3373で修正済み。まず最新版に更新し、それでもずれる場合は較正開始前に両アームの向きを揃える
- リーダーアームは
--teleop.typeで指定する。--robot.typeでは選択肢に出てこない - どの症状も、GitHub Issue上でメンテナや他の利用者が確認した範囲の対処であり、全個体で解決するとは限らない
📚 もう少し詳しく(背景)気になる人向け・タップで開く
SO-101のようなオープンハードウェアのアームは、設計図とソフトウェアがコミュニティに公開されている一方で、組み立てる人ごとにモーターの個体差・配線の癖・サーボの中央位置のずれが生じやすいという特徴があります2。この記事で扱った3つの症状も、Issue上の報告を見ると「ほぼ同じ症状でも、直し方は配線のやり直しだったり、サーボの中央位置の再設定だったりとばらつきがある」ことが読み取れます。
既製品の産業用アームと違い、個体ごとの調整が必要になる場面があるのは、低コストで自作できることの裏返しとも言えます。詰まったときは、まずこの記事の3パターンに当てはまるか確認し、当てはまらない場合はエラーメッセージそのものでGitHub Issueを検索するのが近道です。
次の一歩 🌸
キャリブレーションの前提になる組み立て手順はSO-101組み立てガイド、キャリブレーション後の模倣学習の進め方はLeRobot Tutorialへ。テレオペでデータを集める実務はテレオペとデータ収集入門、インストール自体でつまずいた場合はLeRobotのインストールでつまずくときも参考にしてください。
参考資料・出典
- Issue #2387: so101Leader Calibration issuehuggingface/lerobot公式リポジトリのIssue。リーダー用モーターへの12V電源接続によるInput voltage errorと、電圧を5Vに切り替えて解決した複数の報告
- Issue #3193: so101 wrist_roll calibration broken in new versionhuggingface/lerobot公式リポジトリのIssue。wrist_rollキャリブレーションのクラッシュ(PR #3373で修正)とゼロ点不一致の報告・メンテナの回答
- Issue #1595: Unable to Calibrate so101leader armhuggingface/lerobot公式リポジトリのIssue。--robot.typeではなく--teleop.typeで指定すべきという解決報告
ゆるふわポータルでは、一次情報・公的資料にもとづき、専門用語をできるだけやさしく翻訳することを心がけています。内容に誤りや古い情報がある場合は、お問い合わせからご連絡ください。
執筆:ゆるふわフィジカルAI編集部 最終更新日:2026年11月8日
Footnotes
-
huggingface/lerobot Issue #2387「so101Leader Calibration issue」。リーダー用モーターへの12V電源接続によるInput voltage errorを報告。5V電源への切り替えで解決したとの複数報告があり、メンテナ(imstevenpmwork氏)が電圧バリアントの違いを原因として説明(2026年7月closed)。 ↩ ↩2 ↩3
-
huggingface/lerobot Issue #3193「so101 wrist_roll calibration broken in new version」。wrist_rollのキャリブレーションクラッシュとゼロ点不一致を報告。クラッシュはPR #3373で修正(2026年4月closed)、ゼロ点不一致については開始位置の合わせ方に関するメンテナの回答あり。 ↩ ↩2 ↩3 ↩4 ↩5
-
huggingface/lerobot Issue #1595「Unable to Calibrate so101leader arm」。
--robot.typeにso101_leaderの選択肢がないエラーを報告。リーダーはteleopとして指定すべきという投稿者自身のコメントで解決(2025年7月closed)。 ↩ ↩2
ゆるふわフィジカルAI