hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-09 03:13:19 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
57 commits 1 branch 0 tags 46 MiB
Find a file
oliver 37522f492a feat: plan agent v2, global chat mode, and user-mode v2 flag sync 
- Add runtime/plan_agent_v2 package and shims; gateway/direct_loop/WS wiring

- Admin chat: interaction mode and specialist only in user menu; session API stores memory_mode and execution_mode only

- POST /admin/api/chat/user-mode mirrors plan_agent_version to AIA_EXPERT_PLAN_AGENT_V2_ENABLED (v2 to 1, v1 to 0)

- Composer cleanup (hidden mode select, no reasoning toggle in meta bar); tests and _local/system.env.example

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-02 18:41:45 +08:00
.github/workflows 重构仓库目录为统一的 runtime 分层并清理历史 openclaw 残留。 2026-04-25 01:24:23 +08:00
_hooks_selftest_workspace 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
_local feat: plan agent v2, global chat mode, and user-mode v2 flag sync 2026-05-02 18:41:45 +08:00
desktop 重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。 2026-04-26 08:34:33 +08:00
docs feat: plan agent v2, global chat mode, and user-mode v2 flag sync 2026-05-02 18:41:45 +08:00
interfaces feat: plan agent v2, global chat mode, and user-mode v2 flag sync 2026-05-02 18:41:45 +08:00
platform feat: plan agent v2, global chat mode, and user-mode v2 flag sync 2026-05-02 18:41:45 +08:00
prompts 完成运行时与启动链路的全面相对路径整改，统一以仓库根为路径基准并移除 oclaw 双层硬编码。 2026-04-26 09:22:42 +08:00
runtime feat: plan agent v2, global chat mode, and user-mode v2 flag sync 2026-05-02 18:41:45 +08:00
scripts 重构主控编排与运行时预热链路，统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。 2026-04-26 08:34:33 +08:00
tests feat: plan agent v2, global chat mode, and user-mode v2 flag sync 2026-05-02 18:41:45 +08:00
.gitignore feat: plan agent v2, global chat mode, and user-mode v2 flag sync 2026-05-02 18:41:45 +08:00
.gitmodules 初始化：独立 oclaw 仓库首提交 2026-04-24 22:31:22 +08:00
__init__.py 重构仓库目录为统一的 runtime 分层并清理历史 openclaw 残留。 2026-04-25 01:24:23 +08:00
oclaw.json 实现附件处理链路的统一引用化与可检索增强，避免大文件/多模态内容直接撑爆上下文并提升工具可用性。 2026-04-26 15:25:50 +08:00
pytest.ini 重构仓库目录为统一的 runtime 分层并清理历史 openclaw 残留。 2026-04-25 01:24:23 +08:00
README.md 收敛微信 sidecar 到官方单链路并同步文档与回归测试。 2026-04-29 01:10:25 +08:00
requirements.txt feat: plan agent v2, global chat mode, and user-mode v2 flag sync 2026-05-02 18:41:45 +08:00

README.md

Oclaw Architecture Root

This repository is fully consolidated under oclaw/.

Quickstart (Open Source)

Prerequisites

  • Python 3.11+
  • Node.js 22+ (required by the official Weixin plugin)

1) Bootstrap venv (Windows)

powershell -ExecutionPolicy Bypass -File .\scripts\bootstrap_venv.ps1

2) Start gateway (background)

powershell -ExecutionPolicy Bypass -File .\scripts\start_gateway.ps1 -SkipInstall -Background

Open:

  • Admin: http://127.0.0.1:8787/admin
  • Chat: http://127.0.0.1:8787/chat

If port 8787 is stuck/occupied, force-stop:

powershell -ExecutionPolicy Bypass -File .\scripts\stop_gateway.ps1 -Force

3) Weixin (Personal WeChat): install → login → start

powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\weixin_install.ps1
powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\weixin_login.ps1
powershell -ExecutionPolicy Bypass -File .\runtime\operations\scripts\weixin_start.ps1

Notes:

  • weixin_install.ps1 does not require global openclaw CLI installation; runtime deps are installed locally in sidecar workspace.
  • .\scripts\start_all.ps1 -Background now skips missing Weixin/WhatsApp sidecars gracefully (warn + continue), so Admin/Chat can still boot on fresh installs.
  • Admin supports channel dispatch controls for Weixin/WhatsApp (bind specialist / comprehensive), with default generalist.

Full runbook (recommended): see docs/RUNBOOK.md → “开源快速安装（从零到跑起来）”.

Minimal onboarding guide: docs/OPEN_SOURCE_QUICKSTART.md.

Layers

  • runtime/: core execution loop, routing, skill runtime, hook runtime
  • interfaces/: transport adapters (HTTP/WS)
  • gateway/: method handlers and protocol bridging
  • application/: use-cases and orchestration services
  • infrastructure/: runtime-facing integrations/adapters
  • platform/: shared platform capabilities (llm, persistence, config, files)
  • tools/: tool registry, MCP adapters, public/system tools
  • skills/: installable skills and runtime manifests

Naming Rule

  • Use oclaw consistently in paths, symbols, and docs.
  • Avoid introducing legacy aliases or old naming variants.

Attachment Replay Config

  • Attachment-related limits are configured in oclaw.json under:
    • plugins.entries.memory-wiki.auto.attachments.tabular
  • Replay limits:
    • image_result_replay_cap_chars (default 4000, range 600..30000)
    • video_result_replay_cap_chars (default 4000, range 600..30000)
    • Used to cap historical query_image_attachment / query_video_attachment(task=transcript) text replay in model context.
  • Video transcript chunk defaults:
    • video_transcript_chunk_size (default 1600)
    • video_transcript_chunk_overlap (default 200)
  • Unified archive budget defaults (zip/tar/tgz/gz):
    • archive_max_depth (default 2)
    • archive_max_file_count (default 200)
    • archive_max_entry_bytes (default 10485760)
    • archive_max_total_uncompressed_bytes (default 52428800)
    • Archive parse errors now expose stable error_code values (for UI mapping and retries).
  • Effective priority for replay-cap values:
    • DB setting AIA_IMAGE_TOOL_RESULT_REPLAY_CAP_CHARS
    • DB setting AIA_VIDEO_TOOL_RESULT_REPLAY_CAP_CHARS
    • Environment variable AIA_IMAGE_TOOL_RESULT_REPLAY_CAP_CHARS
    • Environment variable AIA_VIDEO_TOOL_RESULT_REPLAY_CAP_CHARS
    • oclaw.json value
    • Built-in default

See docs/ENVIRONMENT_VARIABLES.md for full runtime variable reference.