hansjone/oclaw
1
0
Fork 0
mirror of https://github.com/hansjone/oclaw.git synced 2026-10-09 05:50:44 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions
oclaw/docs/LOCAL_PUBLIC_TOOLS.md

1.2 KiB
Raw Blame History

Local Public Tools

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

Included P0 tools

  • run_command
  • read_file
  • write_file
  • 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
  • bailian_webparser (DashScope WebParser compatibility tool)

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

  • read_file is risk_level=low and visible by default.
  • run_command, write_file, 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.

Path behavior defaults

  • run_command: when cwd is omitted, it runs in workspace root.
  • write_file: absolute path is used directly; relative path is written under data/workspace.