OpenClaw 本地 Agent 实战：从安装到安全执行任务#

你会学到什么#

• OpenClaw 适合解决什么问题。
• 本地 Agent 为什么要重视权限。
• 如何完成安装和初始化。
• 如何配置模型服务。
• 如何启动 Gateway 并执行第一个任务。
• 如何记录日志和控制风险。

推荐学习顺序#

本站已有三篇 OpenClaw 系列文章，可以按这个顺序阅读：

1. OpenClaw 系列（一）：它不只是聊天机器人。
2. OpenClaw 系列（二）：手把手部署 OpenClaw。
3. OpenClaw 系列（三）：进阶玩法、模型路由和安全边界。

这篇文章作为实战入口，把三篇内容串起来。

第一步：理解 OpenClaw 的定位#

OpenClaw 不是一个普通聊天应用，而是一个本地 Agent 运行环境。它会根据用户指令拆解任务，并调用工具完成操作。

你可以把它理解为：

1
消息入口 + LLM 推理 + 工具调用 + 本地执行环境 + 权限边界

这类系统的重点不是“回答得好不好”，而是“能不能安全、可控地完成任务”。

第二步：准备运行环境#

通常需要：

• Node.js。
• 一个可用模型 API。
• OpenClaw CLI。
• 本地配置目录。
• 明确的工作区路径。

安装类命令请以官方文档或你当前版本的 CLI 输出为准。不要盲目复制旧教程里的版本号。

第三步：初始化配置#

初始化后，重点检查三类配置：

1
模型配置：使用哪个模型、API Key、Base URL
2
工作区配置：允许访问哪些目录
3
工具配置：允许执行哪些动作

初学阶段建议只开放一个测试目录，例如：

1
~/OpenClaw-Workspace

不要一开始就给整个用户目录、下载目录或项目根目录写权限。

第四步：执行第一个安全任务#

第一个任务应该非常小：

1
在测试工作区里创建一个 hello.txt，内容写入：Hello OpenClaw。

这个任务可以验证：

• Agent 能收到指令。
• 模型能规划动作。
• 文件工具能执行。
• 权限边界生效。
• 日志能记录执行过程。

第五步：观察日志#

Agent 实战一定要看日志。重点关注：

• 模型如何拆解任务。
• 调用了哪个工具。
• 工具输入是什么。
• 工具输出是什么。
• 有没有重复执行。
• 有没有访问不该访问的路径。

如果日志不可见，Agent 就不可控。

第六步：逐步扩大权限#

OpenClaw 这类本地 Agent 应该按“试用员工”的方式授予权限：

1. 先给测试目录。
2. 再给只读项目目录。
3. 再给明确任务所需的写权限。
4. 高风险命令需要人工确认。
5. 不要把密钥文件暴露给 Agent。

常见风险#

最小验收标准#

完成这个案例后，你应该能做到：

• 知道 OpenClaw 和普通聊天工具的区别。
• 能解释本地 Agent 的安全边界。
• 能在测试工作区执行一个小任务。
• 能查看执行日志。
• 能判断哪些权限不应该开放。

下一步#

继续阅读本站 OpenClaw 系列三篇文章，并尝试把它和前面的 Agent 工程样板对照起来：一个是自建最小循环，一个是更完整的开源 Agent 运行环境。