工具参考

预定义的 Profile 可快速控制 Agent 的工具访问范围：

{
  agents: {
    defaults: {
      tools: {
        profile: "coding",
        deny: ["exec"],         // 在 Profile 基础上禁用
        alsoAllow: ["message"]  // 额外允许
      }
    }
  }
}

工具按功能分组，方便批量允许/禁止：

在工作区中执行 Shell 命令，支持后台执行和超时控制。

执行主机支持三种模式：sandbox（Docker 沙箱）、gateway（网关主机）、node（远程节点）。 高危操作可通过 elevated 配置要求人工审批。

Agent 可控制隔离的浏览器实例进行网页操作：

• 支持 Chromium/Brave/Edge，自动检测
• 隔离的浏览器 Profile（openclaw/chrome/自定义）
• 支持截图、PDF 生成、Cookie 和存储管理
• 支持远程 CDP（Browserbase）和 Playwright 集成
• SSRF 防护：默认阻止访问私有网络

web_search 执行网页搜索，web_fetch 获取网页内容。两者都受工具策略控制。

通过工具向渠道发送消息。支持指定渠道、目标、媒体附件等。

{
  action: "send",
  channel: "telegram",
  to: "123456789",
  message: "Hello!",
  mediaUrl: "https://example.com/image.png"
}

不同模型能力不同，可按 Provider 单独设置工具策略：

{
  agents: {
    defaults: {
      tools: {
        byProvider: {
          "ollama/*": { deny: ["exec", "browser"] },
          "anthropic/*": { profile: "full" }
        }
      }
    }
  }
}