OpenSyn OpenClaw 插件（中文）

这是当前 OpenSyn 面向 OpenClaw 的主入口。

快速安装：

openclaw plugins install opensyn
openclaw enable_opensyn
openclaw status_opensyn

默认本地路径：

• runtime 根目录：~/.opensyn
• 数据库：~/.opensyn/opensyn.db

默认 workspace 行为：

• openclaw enable_opensyn 如果不传项目路径，会直接使用当前 OpenClaw workspace
• openclaw enable_opensyn 还会完成托管 shell hook 自举，并拉起插件托管的后台 watch-linux 采集器，同时启用插件托管的宿主模型 distillation service
• 采集和存储留在本地；宿主模型提炼遵循 OpenClaw 当前模型边界，如果宿主配置的是远端模型，这一步也可能走远端
• openclaw status_opensyn 会直接返回统一的 next=... 提示，让客户马上知道下一步动作
• 只有在排障时才需要追加 --json 查看完整诊断信息

本地开发联调安装：

./scripts/openclaw-install-plugin --mode link --project-root "$PWD"

维护者手动发布到 npm 的流程：

cd extensions/open-synapse
npm view opensyn version
npm version <new-version> --no-git-tag-version
cd ../..

cargo build --manifest-path Cargo.toml -p synapse-daemon -p synapse-cli --release
mkdir -p extensions/open-synapse/runtime/bin/<platform-arch>
cp target/release/synapse-daemon extensions/open-synapse/runtime/bin/<platform-arch>/synapse-daemon
cp target/release/synapse-cli extensions/open-synapse/runtime/bin/<platform-arch>/synapse-cli
chmod +x extensions/open-synapse/runtime/bin/<platform-arch>/synapse-daemon
chmod +x extensions/open-synapse/runtime/bin/<platform-arch>/synapse-cli

cd extensions/open-synapse
npm pack --dry-run --ignore-scripts
npm whoami
npm adduser
npm publish --ignore-scripts --access public --otp <otp>

• <platform-arch> 例如 linux-x64、linux-arm64
• 如果 npm 上还没有当前版本，可跳过 npm version <new-version> --no-git-tag-version
• 如果 npm whoami 成功，可跳过 npm adduser
• 未开启 npm 2FA 时，去掉 --otp <otp>
• --ignore-scripts 用来避免再次触发仓库里的 prepack 脚本

主要文档：

• 中文手册：docs/opensyn-handbook.zh-CN.md
• English handbook: docs/opensyn-handbook.md
• 根入口：README.zh-CN.md

主要 OpenClaw CLI 命令：

• openclaw enable_opensyn
• openclaw disable_opensyn
• openclaw status_opensyn
• openclaw value_opensyn
• openclaw learnings_opensyn
• openclaw prove_opensyn
• openclaw stats_opensyn
• openclaw report_opensyn
• openclaw context_opensyn
• openclaw episodes_opensyn
• openclaw assets_opensyn
• openclaw doctor_opensyn
• openclaw repair_opensyn

推荐查看路径：

• 用 openclaw status_opensyn 确认采集和提炼是否健康
• 用 openclaw value_opensyn 看 OpenSyn 现在只是采集、已经学习，还是已经形成持续复利
• 用 openclaw learnings_opensyn 查看提炼出的 memory、skill、rule、negative example 资产
• 用 openclaw prove_opensyn 查看当前最强的本地证据和代理复用信号，包括工具级访问 telemetry，以及仍未覆盖的被动复用缺口
• 用 openclaw stats_opensyn 查看 raw events、episodes、context packs、assets 数量
• 用 openclaw report_opensyn 查看当前 workspace 的聚合报告
• 用 openclaw context_opensyn 查看最新综合 context
• 用 openclaw episodes_opensyn 查看近期任务片段
• 用 openclaw assets_opensyn 查看候选和已批准的 memory/skill/rule 资产

插件工具仍可直接调用：

• opensyn_autonomous_collection_status
• opensyn_autonomous_tick
• opensyn_collection_report
• opensyn_collected_stats
• opensyn_value_report
• opensyn_learnings_report
• opensyn_proof_report
• opensyn_current_context
• opensyn_recent_episodes
• opensyn_recent_failure
• opensyn_search_history
• opensyn_list_assets
• opensyn_approve_asset
• opensyn_sync_assets
• opensyn_submit_distillation_job
• opensyn_complete_next_distillation_job
• opensyn_submit_host_distilled_assets（兼容别名）

安全约束：

• 只允许使用 OpenClaw 当前配置模型
• OpenSyn 自身不做联网浏览，也不上传遥测
• 上下文、job、资产和投影都留在本机；宿主模型提炼遵循 OpenClaw 当前模型边界，如果宿主配置的是远端模型，这一步也可能走远端