Shell Tool:命令执行、输出读取和长任务管理 openclaw90x

Shell Tool:命令执行、输出读取和长任务管理

Shell Tool 是 OpenClaw 从“会聊天”变成“能改项目、跑测试、查日志”的关键能力。 但 shell 也是最容易被误用的工具。 因为一条命令可能只是读取: rg "TODO" . 也可能会修改文件、删除目录、启动服务、写入数据库,甚至长期占用进程。 所以理解 Shell Tool,重点不是“能不能执行命令”,而是: 命令在哪里执行? 输出如何返...
阅读全文
手写一个最小 Agent openclaw90x

手写一个最小 Agent

前面九节,我们一直在拆 OpenClaw。 Gateway、CLI、Bridge、Workspace。 模型、工具、浏览器。 Skill、Prompt、Context。 用户输入、队列、工具执行。 Browser、Shell、Canvas。 这些概念如果只停留在文字上,还是有点散。 所以第 10 节,我们换个方式。 不直接写 OpenClaw 的完整实现。 而是手写一个“最小 A...
阅读全文
Browser、Shell、Canvas 原理 openclaw90x

Browser、Shell、Canvas 原理

学 OpenClaw 到这里,你应该已经知道一件事: 模型不会直接操作世界。 模型负责判断下一步。 OpenClaw 负责把模型的判断变成真实动作。 那真实动作发生在哪里? 最重要的三个执行表面,就是: Browser Shell Canvas Browser 连接网页世界。 Shell 连接操作系统和命令行世界。 Canvas 连接可视化界面和人工协作世界。 这三个东...
阅读全文
模型降级、重试和错误处理策略 openclaw90x

模型降级、重试和错误处理策略

真实系统里,模型调用一定会失败。 可能是: 429 rate limit 认证过期 provider 超时 模型临时不可用 上下文太大 网络波动 工具结果过长 OpenClaw 要解决的不是“永不失败”,而是“失败后知道该不该重试、换 key、换模型,还是直接告诉用户”。 先说结论:Retry 和 Failover 不是一回事 可以这样区分: Retry 同一个请...
阅读全文
上下文组装:文件、历史消息、指令和工具 schema openclaw90x

上下文组装:文件、历史消息、指令和工具 schema

很多 Agent 问题其实不是“模型不聪明”,而是上下文组装出了问题。 模型只会基于它当前看到的内容行动。 OpenClaw 的 context 文档给了一个清晰定义: Context 是一次 run 中 OpenClaw 发送给模型的所有内容。 先说结论:上下文不是记忆,而是当前窗口 Context 包括: System prompt Conversation history ...
阅读全文
OpenAI、Claude、Gemini 与 OpenAI Compatible 接入方式 openclaw90x

OpenAI、Claude、Gemini 与 OpenAI Compatible 接入方式

知道 Provider 抽象还不够。真正配置时,你会遇到四类常见路线: OpenAI Anthropic Claude Google Gemini OpenAI Compatible 它们看起来都是“填 key、选 model”,但背后的 runtime、auth、能力边界并不完全一样。 先说结论:先选 provider,再选模型,再确认 runtime 接入模型时按三步走: ...
阅读全文
Provider 抽象:为什么 OpenClaw 可以接不同模型 openclaw90x

Provider 抽象:为什么 OpenClaw 可以接不同模型

如果 OpenClaw 只能接一个模型,它就只是某个模型的客户端。 真正让它变成平台的是 Provider 抽象。 Provider 抽象回答的问题是: 不同模型 API 都不一样,OpenClaw 为什么还能用同一套 Agent loop 调它们? Provider 把模型差异挡在运行时边界外 不同 Provider 负责不同事情: 认证方式 模型目录 请求协议 工具 sc...
阅读全文
日志与可观测性:如何看懂一次失败的调用 openclaw90x

日志与可观测性:如何看懂一次失败的调用

Agent 失败时,最没用的问题是: 它为什么没回我? 更有效的问题是: 请求有没有进 Gateway? session 路由对不对? run 有没有 accepted? 模型调用有没有发出去? 工具有没有启动? 失败发生在 provider、tool、channel,还是消息投递? OpenClaw 的可观测性,就是把一次看似模糊的失败拆成可定位的层。 先说结论:先按...
阅读全文
权限模型:Shell、Browser、文件读写的安全边界 openclaw90x

权限模型:Shell、Browser、文件读写的安全边界

Agent 最危险的地方,不是它会说错话。 而是它能做事。 一旦 OpenClaw 可以执行 shell、读写文件、控制浏览器、调用外部工具,问题就从“回答是否准确”变成: 谁能让 Agent 做事? Agent 能在哪台机器上做事? 它能读写哪些文件? 它能执行哪些命令? 它能控制哪个浏览器? 失败或不确定时默认允许还是默认拒绝? 这就是权限模型要解决的问题。 本讲不把安...
阅读全文
Workspace:文件系统、项目上下文和执行边界 openclaw90x

Workspace:文件系统、项目上下文和执行边界

很多人第一次接触 OpenClaw 的 workspace,会把它理解成“Agent 的项目目录”。 这个说法没错,但太浅。 Workspace 同时承担三种角色: 默认工作目录 上下文来源 长期记忆和本地约定的承载地 但还有一个非常重要的边界: workspace 本身不是硬沙箱 如果你只记住“workspace 是目录”,你会低估它对 Agent 行为的影响。 如果你...
阅读全文
Loading...