TL;DR:Windows 上装 OpenClaw 不难,但每一步都有坑。配置不是命令行参数,是交互式向导。Web 工具默认没开,模型会静默降级到训练数据假装联网。

为什么写这篇

AgentAnatomy 连载第一天。先把 OpenClaw 跑起来,有第一手感受再读源码——空谈架构没意思。

部署过程

环境:Windows 10,Node 24.14,Git Bash。

安装没问题:

1
npm install -g openclaw@latest

8 分钟,481 个包。第一个坑:配置 API key。文档写的是:

1
openclaw config set api-key YOUR_KEY

实际报错 value/json mode requires <value>。正确做法是跑 openclaw config 进交互式向导,选 Model → DeepSeek,在里面填 key。命令行那条根本不对。

配完启动 Gateway:

1
openclaw gateway start

又报错:Gateway service missing,要先跑 openclaw gateway install。装完再 start,起来了,但日志有一条 model-pricing bootstrap failed: TimeoutError,pricing 服务超时。不影响用,但留着心里有点不踏实。

浏览器打开 127.0.0.1:18791 显示 Unauthorized。找了半天才发现要跑:

1
openclaw dashboard

它自动带 token 打开。这条命令在 openclaw --help 里才看得到,文档没有重点提。

实际使用

让它在 Workspace 创建一个 txt 文件,秒完成,文件操作没问题。

然后让它搜今天的 AI 新闻。它调用了 web_fetch,但返回的是”截至2024年”的内容。原因:配置时 Web tools 那步跳过了,默认没启用,fetch 失败后模型静默降级到训练数据,用户完全感知不到。这个设计有点问题,失败就应该明确报错。

Workspace 的文件

E:\openclaw-workspace 里自动生成了:AGENTS.md、SOUL.md、USER.md、TOOLS.md、IDENTITY.md。这是 Agent 的行为和记忆定义,后面会细读,今天先记住它们在这。

和 SAGE-Code 的关联

OpenClaw 把 Agent 状态外化成文件,而不是藏在内存里。文件可读、可版本控制、可手动干预。SAGE-Code 的记忆设计可以借鉴这个思路。

我的判断

Windows 体验比预期粗糙:报错不友好,命令和文档有出入,Web 工具失败不报错只静默降级。但核心的文件操作和 Gateway 架构跑通了,值得继续读源码。

别对 Windows 上的 OpenClaw 体验抱太高期望。

参考