Paperclip
Use Paperclip AI from ScienceClaw to onboard a local Paperclip instance, run health checks, and start the service that provides AI agents with indexed literature and orchestration capabilities.
Paperclip's quickstart command is:
npx paperclipai onboard --yes
Usage
Check local prerequisites
python3 {baseDir}/scripts/paperclip.py --action check --format json
Show the onboarding command without running it
python3 {baseDir}/scripts/paperclip.py --action onboard --format json
Run non-interactive onboarding
python3 {baseDir}/scripts/paperclip.py --action onboard --execute --yes --format json
By default this detaches the long-running Paperclip server and returns a PID plus a log file.
Run Paperclip health checks
python3 {baseDir}/scripts/paperclip.py --action doctor --execute --format json
Start Paperclip
python3 {baseDir}/scripts/paperclip.py --action run --execute --format json
Parameters
| Parameter | Description | Default |
|---|---|---|
--action |
Operation: check, onboard, doctor, run, or version |
check |
--execute |
Actually run the Paperclip command; omitted means dry run | false |
--detach |
Run long-lived onboard/run commands in the background |
true for onboard/run |
--foreground |
Keep long-lived commands attached to the current process | false |
--yes |
Pass --yes to paperclipai onboard |
true |
--run-after-onboard |
Pass --run to paperclipai onboard |
false |
--repair |
Pass --repair to paperclipai doctor |
false |
--bind |
Optional bind target for onboarding, such as tailnet |
- |
--work-dir |
Directory where the Paperclip CLI runs | current directory |
--timeout |
Command timeout in seconds | 600 |
--wait-seconds |
Seconds to watch a detached command before returning | 5 |
--format |
Output format: summary or json |
summary |
Output
The skill returns a JSON object with:
action: requested operationcommand: command ScienceClaw would run or did runexecuted: whether a command was executedreturncode,stdout, andstderrwhen executedpidandlog_filefor detached server runschecksfor local Node/npm/npx availability
Notes
- Requires Node.js, npm, and npx. Paperclip currently documents Node.js 20+ as the expected runtime.
onboard --yesuses Paperclip's non-interactive quickstart defaults.- Rerunning onboarding should preserve an existing Paperclip configuration; use Paperclip's own configuration commands for later edits.