面向社会科学研究的智能体工作台:把研究项目、证据账本、完整性门禁、可恢复工作流和本地面板接到内置运行时上。它不替代统计软件,也不会把未经核验的引用、结果或审稿意见写成事实。
许可证:CC BY-NC 4.0
需要 Node.js >=22.19.0。
npm install -g psyclaw@latest中国大陆可用镜像或安装脚本:
npm install -g psyclaw@latest --registry=https://registry.npmmirror.com
# 或
PSYCLAW_CN=1 curl -fsSL https://exekiel179.github.io/psyclaw/install.sh | sh# Windows
irm https://exekiel179.github.io/psyclaw/install.ps1 | iex确认入口:
psyclaw --help直接运行 psyclaw 会启动交互工作台;首次无模型配置时会进入配置流程。API Key 只写入用户级 ~/.psyclaw/agent/auth.json,不要写进命令参数、项目或 Git 仓库。
mkdir my-study && cd my-study
psyclaw init "社交支持与研究生心理健康的关系" --paradigm survey-observational
psyclaw初始化会创建 .psyclaw/data/raw/(只读保护区)、data/clean/、literature/pdfs/、notes/、outputs/。对话中也可用 /init <研究目标>;用 Shift+Tab 在 chat → analysis → academic 间切换。未 /init 时保持普通对话,不强制研究门禁。
psyclaw evidence add notes/source.md --level user| 需求 | 命令 |
|---|---|
| 启动 / 续接会话 | psyclaw · psyclaw -c |
| 初始化项目 | psyclaw init <goal> --paradigm <profile> 或 /init |
| 登记证据 | psyclaw evidence add <path> --level user|fulltext |
| 更新 | psyclaw check-updates · psyclaw update |
| 科研面板 | 对话中 /panel |
| 模式切换 | Shift+Tab(chat / analysis / academic) |
| 学术 ARS | /ars · /ars <任务> · /ars doctor |
| Skill / Plugin / MCP | /skill · /plugin · /mcp |
| 遥测 | psyclaw telemetry off|on|status(默认开启,可关) |
更多对话命令见 psyclaw --help 与 使用白皮书。
研究者
贡献者(实现契约,非日常使用说明)
pnpm install && pnpm build && npm link
psyclaw --help源码树中请用 Git 同步,不要跑 psyclaw update(会拒绝覆盖本地修改)。
发布(维护者):
RELEASE_MESSAGE="release: describe the change" pnpm release:push标签推送后由 GitHub Actions(Node 22 + Trusted Publishing)发布 npm。
若出现 ModuleNotFoundError: No module named 'psyclaw.cli',说明仍指向旧 Python 入口。用 Get-Command psyclaw -All / which -a psyclaw 定位后移除旧入口,再安装当前 npm 包:
npm uninstall -g psyclaw
npm install -g psyclaw@latest仅卸载程序:npm uninstall -g psyclaw
同时清除用户配置与会话:再删除 ~/.psyclaw(不会删除研究项目目录)。