oclaw/docs/LOCAL_PUBLIC_TOOLS.md
oliver 75aec2abe4 补齐本地 public 工具的 P1/P2/P3 能力。
新增目录列举、文件/目录操作、内容搜索、cwd/env 管理与进程管理工具,并在本地适配层统一实现与测试覆盖,保持风险门控策略一致。

Made-with: Cursor
2026-04-30 23:37:39 +08:00

1 KiB

Local Public Tools

This project exposes local atomic capabilities as shared public tools for all agents.

Included P0 tools

  • local_run_command
  • local_read_file
  • local_write_file
  • local_edit_file

Included P1/P2/P3 tools

  • list_directory
  • move_file
  • delete_file
  • mkdir
  • search_files
  • get_cwd
  • cd
  • get_env
  • set_env
  • list_processes
  • kill_process

Loading path

  • Files live under runtime/tools/public/.
  • They are auto-discovered by runtime/tools/public_registry.py (*_tool factory naming).
  • Final exposure is controlled in runtime/tools/catalog.py.

Risk gating

  • local_read_file is risk_level=low and visible by default.
  • local_run_command, local_write_file, local_edit_file are risk_level=high.
  • High-risk public tools are hidden unless AIA_PUBLIC_TOOLS_ALLOW_HIGH=1.

Local backend adapter

  • Adapter path: runtime/tools/local_sdk/adapter.py.
  • Uses a self-implemented local backend (cross-platform) with a stable tool contract.