ペーパークリップ

使用法

0.サーバーにSSHで接続します

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

ssh root@<SERVER_IP>

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

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

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

su - paperclip

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

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

対話型セットアップを実行します。

paperclipai onboard

これにより、インスタンスが最初に使用できるように構成されます。

3. ペーパークリップを開始します

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

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 ローカル ブラウザでペーパークリップ 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 paperclip@<SERVER_IP>
• root としてログインしている場合は、Paperclip コマンドを実行する前に必ずアプリケーション ユーザーに切り替えてください。 su - paperclip
• 走る onboard 最初のセットアップ時のみ
• 使用 configure 後で変更のために