openclaw 值不值得装?先看这六个坑

开源深读｜第 1 篇。GitHub 全站第一的项目，39 万星，讲讲它到底能干什么、怎么装、哪里会翻车。

一、它是什么

openclaw 是一个跑在你自己电脑上的 AI 助手。

跟你用过的网页版 AI 不一样。网页版只会打字回答，openclaw 能动手：整理文件夹、发邮件、查日程、订机票。你在微信、飞书、Telegram 里跟它说话，它在后台把活干了。

三个数字先记住：

作者是奥地利开发者 Peter Steinberger，PSPDFKit 的创始人。项目 2025 年 11 月上线，原名 Clawdbot，中间因为商标问题改过两次名，2026 年 1 月定名 openclaw。

适合谁：想让 AI 从"聊天"变成"干活"的人。会复制粘贴命令就行，不用懂编程。

不适合谁：指望装完就万事大吉的人。它要配模型、要调权限、要防着点。这不是一个开箱即用的产品，更像一套需要组装的工具。

二、三层结构，先弄清楚

openclaw 的架构可以拆成三块。

网关（Gateway） 是常驻后台的控制中枢。它管三件事：会话、消息路由、工具调度。默认只监听本机地址 127.0.0.1 的 18789 端口，浏览器打开这个地址能看到控制台。

渠道（Channels） 是你跟它说话的入口。微信、飞书、钉钉、Telegram、WhatsApp、Discord、Slack、iMessage，加起来 50 多个。你在哪个软件里顺手，就用哪个。

技能（Skills） 教它怎么干具体的活。每个技能是一个 SKILL.md 文件加脚本。官方市场 ClawHub 上有 5700 多个社区技能，从整理邮件到查 GitHub PR 都有。

这里有个容易搞混的地方：工具和技能不是一回事。

工具是手脚——读写文件、跑命令、控制浏览器、发网络请求。技能是教材——告诉 AI 什么时候该用哪个工具、按什么顺序用。

没有工具授权，技能跑不起来；没有技能，工具不知道什么时候该用。两个都得配。

还有一个设计值得单独说：SOUL.md。这是存在本地的记忆文件，记录 AI 的人设和你的使用偏好。openclaw 所有数据都在你自己硬盘上，官方服务器拿不到。

三、怎么装

前提两个：Node.js 22 以上（推荐 24），内存至少 1G。想在本机跑模型的话，内存 8G 起。

macOS 和 Linux

curl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

Windows

powershell -c "irm https://openclaw.ai/install.ps1 | iex"openclaw onboard --install-daemon

也能用 npm 装：

npm install -g openclaw@latest

onboard 是配置向导，会依次问四件事：选哪个模型供应商、填 API Key、网关绑哪个地址、接哪些消息渠道。

网关地址这一步选 loopback（127.0.0.1），别选 0.0.0.0。原因在第六节讲。

装完验证

openclaw --versionopenclaw gateway statusopenclaw doctor

doctor 是体检命令，缺依赖、端口被占用、配置文件有问题，它都会报出来。装完先跑这个。

浏览器打开 http://127.0.0.1:18789，能看到控制台就说明通了。

Docker 部署

适合放在服务器上长期跑，不依赖你的电脑开机。

services:  openclaw:    image: openclaw/openclaw:latest    restart: unless-stopped    ports:      - "127.0.0.1:18789:18789"    volumes:      - ~/.openclaw:/root/.openclaw    environment:      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}

端口那行写的是 127.0.0.1:18789:18789，不是 18789:18789。差一个前缀，前者只允许本机访问，后者把端口开到公网。这个细节很多人栽过，下面会讲后果。

四、配置和常用命令

配置文件在 ~/.openclaw/openclaw.json。

{  "gateway": {    "bind": "loopback",    "port": 18789,    "auth": { "token": "换成你自己的" }  },  "agent": {    "model": "anthropic/claude-sonnet-4-6"  },  "skills": {    "allowBundled": ["github", "email-summary"]  },  "tools": {    "allow": ["read", "write", "web_search", "web_fetch"]  }}

三个要点。

auth.token 必须改，别留默认值。这是控制台的访问凭证。

tools.allow 是白名单。只放你真正需要的能力。用不上执行命令，就别把 shell 权限开出去。

skills.allowBundled 控制启用哪些内置技能，没列出来的不会加载。

命令速查

API Key 别写在配置里

单独放 ~/.openclaw/.env，然后收紧权限：

chmod 600 ~/.openclaw/.env

配置里用 ${ANTHROPIC_API_KEY} 这种形式引用。配置文件万一泄露，密钥不会跟着走。

五、能拿来做什么

下面三个是官方文档里的典型场景，我按中文使用习惯改写。实际效果取决于你配的模型和权限范围。

整理文件

在微信里说一句："把下载文件夹里的图片移到图片目录，PDF 移到文档目录。"

它会扫描、识别类型、移动、回报结果。这类任务不需要强模型，用便宜的就够。

定时汇总

设个定时任务："每天早上九点，抓科技新闻，总结三条发我。"

需要开定时任务技能，配好新闻源。适合每天固定要看行业动态的人。

多 Agent 分流

一个微信号，工作消息交给工作助手，私人消息交给生活助手，两边记忆完全隔离。

{  "agents": {    "list": [      { "id": "work", "workspace": "~/.openclaw/workspace-work" },      { "id": "life", "workspace": "~/.openclaw/workspace-life" }    ]  }}

工作助手配便宜模型负责快速回复，生活助手配强模型处理复杂任务。成本能压下来不少。

六、六个坑

坑一：装在主力机上

openclaw 有系统级权限——读写文件、执行命令、控制浏览器。官方在文档里明确建议装在独立设备或虚拟机里。

你的主力机上有银行客户端、有工作文档、有照片。为了省事把它装在常用电脑上，出问题的时候代价太大。

坑二：端口开到公网

2026 年 1 月披露过一个远程代码执行漏洞（CVE-2026-25253）。当时全网扫描发现，超过三万个 openclaw 实例直接暴露在公网。

绑 127.0.0.1。要在外面访问，用 SSH 隧道或者 Tailscale 这类组网工具，别图省事直接开放端口。

坑三：第三方技能不审查就装

ClawHub 是社区市场，谁都能上传。装之前看三样：源码有没有可疑操作、作者是谁、star 数多少。给权限时只给这个技能真正需要的。

坑四：提示词注入

恶意网页或者邮件里藏一句隐藏指令，AI 读到之后照着执行。这类攻击不需要你有任何操作失误。

防御办法是开操作确认——高风险命令必须你点头才执行。多按一次确认，比事后追责强。

坑五：以为能白嫖

软件是免费的，模型不是。Agent 模式每次对话会调用 5 到 10 次 API，还会把完整上下文重新发一遍，比普通聊天费得多。

去模型供应商的后台设个支出上限。第一次用建议先跑一天看看烧了多少。

坑六：Windows 上装错方式

早期版本必须走 WSL2，很多教程还停在那一步。2026 年 9 月之后原生支持已经稳定，可以直接用 PowerShell 装。照着旧教程配 WSL2，反而多绕一圈。

七、源码怎么看

仓库在 github.com/openclaw/openclaw，pnpm workspace 结构。

想深入的话，先读网关里的路由逻辑，再看一个渠道插件（Telegram 那个结构最清楚），能搞清楚一条消息从进来到执行完的完整链路。

八、同类怎么选

如果你只是想有个 AI 帮忙写代码，OpenCode 或者 Claude Code 更直接，没必要上 openclaw。

openclaw 的价值在"通用助手"——它能碰你电脑上的任何东西。这也是它的风险所在。

最后

openclaw 火得有道理。它把"AI 能动手"这件事，做成了普通人装得上的东西。

但它不是装完就灵。要配模型、要调权限、要防着点。

装之前先想清楚一件事：你愿意给一个程序多少权限。

我的建议是先在虚拟机里跑一周，摸清脾气，再考虑放到常用设备上。

本文依据 openclaw 官方文档与公开资料整理，版本信息截至 2026 年 11 月。工具迭代快，具体命令以官方页面为准。AI 辅助整理。