
2026/01/28 3:08
「ClawdbotがMoltbotに改名」
RSS: https://news.ycombinator.com/rss
要約▶
日本語訳:
## Summary ガイドでは、Clawdbot/Moltbot プロジェクトを Windows、macOS、Android、および iOS で構築・テスト・リリースする方法を説明しています。 主なポイントは次のとおりです。 - **Repository layout**: ソースコードは `src/` に、テスト (`*.test.ts`) は同じく `src/` 内に配置し、ドキュメントは `docs/` に、ビルド済み出力は `dist/` に、プラグイン/拡張機能は `extensions/*` 配下に置きます。 - **Global installation**: `sudo npm i -g clawdbot@latest`(または `moltbot@latest`)を実行し、設定ファイルで `gateway.mode=local` を有効にします。 - **Core commands**: ゲートウェイを起動するには `nohup clawdbot gateway run …` を使用し、状態確認は `clawdbot channels status --probe` で行い、リッスン中のポートとログを tail します。 - **Development tooling**: Node 22+ が必要です。依存関係は `pnpm install`(または `bun install`)でインストールし、開発 CLI は `pnpm clawdbot …` または `pnpm dev` で起動、ビルドは `pnpm build` を実行します。 - **Testing**: `pnpm test`、ライブテスト (`CLAWDBOT_LIVE_TEST=1`)、Docker ライブテスト (`pnpm test:docker:*`)、エンドツーエンドチェックを使用します。 - **Release conventions**: リリースは `vYYYY.M.D` でタグ付けし、npm の `latest` dist‑tag を公開、関連ファイル(package.json、Android Gradle、iOS/macOS Info.plist、docs)内のバージョン番号を更新します。 - **Security practices**: 認証情報は `~/.clawdbot/credentials/` に、セッションは `~/.clawdbot/sessions/` に保存し、実際の電話番号やライブ設定値はコミットせず、ドキュメントとテストではプレースホルダーを使用します。 - **macOS gateway handling**: メニューバーアプリとして起動し、Mac アプリまたは `scripts/restart-mac.sh` で再起動、状態確認は `launchctl print gui/$UID | grep clawdbot`、ログ閲覧は `./scripts/clawlog.sh` を利用します。 - **Plugin installation**: プラグインディレクトリ内で `npm install --omit=dev` を実行し、ランタイム依存関係を `dependencies` に置き、`workspace:*` は避けます。コア専用の依存は `devDependencies` または `peerDependencies` に配置します。 - **Naming conventions**: 製品/アプリ/ドキュメント名は **Clawdbot/Moltbot** を使用し、CLI コマンドおよび設定キーはすべて小文字(`clawdbot`, `moltbot`)に統一します。 - **Agent‑specific notes**: Signal の「update fly」を利用する場合は `fly ssh console -a flawd-bot …` を使用し、macOS のログにはパスワードレス sudo が必要です。 `node_modules` を手動で編集しないようにします。 これらのステップを踏むことで、一貫したバージョン管理、認証情報の安全な取り扱い、複数プラットフォームでの信頼性あるデプロイ、およびスムーズな CI/CD パイプラインが実現します。
本文
リポジトリガイドライン
- リポジトリURL
- Clawdbot:
https://github.com/clawdbot/clawdbot2+ - Moltbot:
https://github.com/moltbot/moltbot33
- Clawdbot:
1️⃣ プロジェクト構造とモジュール編成
| レイヤー | パス |
|---|---|
| ソースコード | (CLIの接続は 、コマンドは ) |
– Webプロバイダー | |
– インフラストラクチャ | |
– メディアパイプライン | |
| テスト | 同所に配置: |
| ドキュメント | (画像、キュー、Pi設定など) |
| ビルド出力 | |
2️⃣ プラグイン / 拡張機能
- ワークスペースパッケージとして
内に配置。extensions/* - プラグイン専用の依存関係は、各拡張の 自身の
に入れる。package.json - コアが利用しない限り、ルート
へは追加しない。package.json
インストール
# プラグインディレクトリ内で実行 npm install --omit=dev # 実行時依存は dependencies に入れる
は避け、代わりにworkspace:*
/clawdbot
をmoltbot
またはdevDependencies
として使用。peerDependencies- ランタイムは jiti エイリアスで
を解決。plugin-sdk
インストーラ
- 同一リポジトリの兄弟プロジェクト
から../molt.bot
でホスト。https://molt.bot/*public/install.shpublic/install-cli.shpublic/install.ps1
3️⃣ メッセージングチャネル
リファクタリング(ルーティング、ホワイトリスト、ペアリング、コマンドゲートイング、オンボーディング、ドキュメント)を行う際は、すべての組み込み + 拡張チャネル を考慮すること。
コアチャネルドキュメント
docs/channels/
4️⃣ VM 操作 (exe.dev
)
exe.dev| ステップ | コマンド |
|---|---|
| SSHアクセス | → (SSHキーは事前設定済み) |
| フラッキーなSSH | ウェブターミナルまたは Shelley を使用し、長時間操作には tmux セッションを保持。 |
| グローバルインストール | () |
| 設定 | ; を確認。 |
(Moltbot は同様の手順で
を使用)moltbot
5️⃣ Discord
- 原文トークンのみを保存(プレフィックスは不要)。
再起動
pkill -9 -f clawdbot-gateway || true nohup clawdbot gateway run --bind loopback --port 18789 \ --force > /tmp/clawdbot-gateway.log 2>&1 &
確認:
clawdbot channels status --probe ss -ltnp | rg 18789 tail -n 120 /tmp/clawdbot-gateway.log
(Moltbot に関しても同様のコマンドを使用)
6️⃣ ビルド、テスト & 開発
| ツール | 備考 |
|---|---|
| Node | ランタイム基盤:22+(Node + Bun パスは常に動作するように) |
| 依存インストール | / (ロックファイルとパッチを同期) |
| Pre‑commit | (CI と同じチェック) |
| TS 実行は Bun 推奨 | または |
| 開発中の CLI 実行 | または (または ) |
Node はビルド出力()をサポートし続ける | |
| Mac 用パッケージング(開発) | – 現在のアーキテクチャにデフォルトで対応 |
7️⃣ 型チェック / ビルド
(tsc)。pnpm build- ファイルは簡潔に保ち、"V2" のコピーではなくヘルパーを抽出。
- <700 LOC/ファイル を目安(ガイドラインであって厳格ではない)。
- 命名:docs/heading は Clawdbot、CLI・パッケージ・パス・設定キーは
。clawdbot
(Moltbot も同様)
8️⃣ リリースチャネル & テスト
| 項目 | 備考 |
|---|---|
| 安定版リリース | タグ ; npm dist‑tag は 。 |
| 命名 | ソース名と を一致させ、e2e は 。 |
| プッシュ前テスト | または 。 |
| ライブテスト |
- Clawdbot:
CLAWDBOT_LIVE_TEST=1 pnpm test:live - Moltbot:
(プロバイダーのライブテストも含む)。 | | Docker ライブテスト |LIVE=1 pnpm test:live
,pnpm test:docker:live-models
。 | | オンボーディング E2E |pnpm test:docker:live-gateway
。 |pnpm test:docker:onboard
9️⃣ セキュリティ & 設定のヒント
- Webプロバイダーのクレデンシャル:
(または~/.clawdbot/credentials/
)。~/.moltbot/... - Pi セッション:
。~/.clawdbot/sessions/ - 実際の電話番号・動画・ライブ設定値をコミットしないでください。
- ドキュメント/テスト/例ではプレースホルダーを使用。
🔧 トラブルシューティング & エージェントメモ
| テーマ | キーポイント |
|---|---|
| リブランド/マイグレーション | (または )を実行。 |
| Fly 更新 | ; その後マシン再起動。 |
| GitHub Issue/PR | タスクの最後に完全URLを印刷。 |
| CLI進行状況 | (, )を使用。 |
| ステータス出力 | テーブル + ANSI安全ラッピングは 。 |
| Gateway 再起動 (Mac) | Moltbot Mac アプリまたは を使用し、`launchctl print gui/$UID |
| macOS ログ | で統合ログを取得。 |
📦 バージョン情報の場所
- CLI:
package.json - Android:
(apps/android/app/build.gradle.kts
,versionName
)versionCode - iOS/macOS:
(Info.plist
,CFBundleShortVersionString
)CFBundleVersion - Docs:
,docs/install/updating.mddocs/platforms/mac/release.md
⚠️ 一般的なガードレール
- 外部メッセージングサーフェスへストリーミングや部分応答を送らない。
を直接編集しないでください;更新時に上書きされます。node_modules
のある依存は、厳密バージョン(pnpm.patchedDependencies
,^
なし)で指定すること。~- パッチングは明示的な承認が必要であり、デフォルトでは行わない。