Paperclip

使用法

0. サーバーに SSH する

root としてサーバーに接続します：

ssh root@<SERVER_IP>

パスワードを使用してログインします。

1. アプリケーションユーザーに切り替える

すべての Paperclip 操作は、専用ユーザーで実行する必要があります：

su - paperclip

Paperclip を root で実行しないでください。

2. 初回セットアップ（オンボーディングウィザード）

対話式セットアップを実行します：

paperclipai onboard

これにより、インスタンスが初回使用向けに設定されます。

3. Paperclipを起動

アプリケーションを起動します：

paperclipai run

ログアウト後も継続して動作させるには、次のようなツールを使用してください： tmux

4. デフォルトサービス

起動後（再設定しない限り）、システムは以下を公開します：

• APIサーバー → http://127.0.0.1:3100/api
• ヘルスチェック → http://127.0.0.1:3100/api/health
• UI → http://127.0.0.1:3100

これらはデフォルト設定です。設定中にバインディング、ポート、またはドメインを明示的に変更しない限り、この設定が適用されます。

5. 便利なコマンド

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. UI へのセキュアなアクセス（SSH トンネリング）

ローカルマシンから次のコマンドを実行します：

ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>

サーバー上の以下のパスに保存された認証情報を使用してログインします：

/root/.cloudzy-creds

に移動 http://127.0.0.1:3100 ローカルブラウザで Paperclip の UI にアクセスします。

Paperclip がサーバー上で動作していることを確認してください。動作していない場合、UI と API にアクセスできません。

重要なパス

• ホームディレクトリ: /home/paperclip
• 設定: /home/paperclip/.paperclip/instances/default/config.json
• ログ/データ: /home/paperclip/.paperclip/
• NVMディレクトリ: /home/paperclip/.nvm/

注釈

• 実行しないでください paperclipai root でコマンドを実行しないでください（常に paperclip ユーザー)
• ザ paperclip ユーザー認証情報は次の場所に安全に保存されています： /root/.cloudzy-creds
• 次のユーザーとして直接ログインすることもできます： paperclip SSH を使用したユーザー SSH： ssh paperclip@<SERVER_IP>
• root でログインしている場合、Paperclip コマンドを実行する前に必ずアプリケーションユーザーに切り替えてください： su - paperclip
• 実行 onboard 初回セットアップ時のみ
• 使用 configure 変更時は後で実行