OpenClaw 不会咬人:一本从零到实战的指南

你的AI助手不再是聊天机器人了，它更像是你的室友。而且它刚刚学会了你把文件放在哪里。OpenClaw并不难用，它就像一个有感情的文件夹。

OpenClaw究竟是什么呢？

我就直说了吧。

OpenClaw 是由 Peter Steinberger 开发的开源、可自行托管的 AI 代理。它最初于 2025 年 11 月以“Clawdbot”之名诞生，后因 Anthropic 公司对商标问题提出异议而更名为“Moltbot”，几天后最终定名为“OpenClaw”。龙虾标志在每次更名中都保留了下来，因为显然甲壳类动物是自主计算的精神象征。

关键在于：OpenClaw 并非一种新的人工智能模型。它并不与 Claude 或 GPT 竞争。它是一款软件，为这些模型赋予了双手、双眼，以及在对话间隙记住你身份的能力。

不妨这样理解。ChatGPT就像一个装在罐子里的大脑。你跟它对话，它回应你，然后你一关掉标签页，它就把你忘得一干二净。OpenClaw则把这个“大脑”直接接入你的电脑。文件、终端、浏览器、即时通讯应用、定时任务，所有的一切。

我邻居家的孩子总结得比任何文档页面都好：“所以它就像 Siri，但它真的能做事？”

是的，正是如此。

当你的AI助手帮你报税时，其他人还在告诉你天气预报。

你为什么要关心这个问题？

三个字：真的管用。

普通的聊天机器人就像和一个失忆的聪明朋友聊天。每次对话都得从零开始。你得重新解释你的项目、你的偏好、你的名字。真是累人。

OpenClaw 则完全不同。它将所有内容都存储在你的本地计算机上，包括你的对话、偏好设置和正在进行的项目。即使你周二向它报告了上周五提到的一个 bug，它也能记住。当你的服务器凌晨 3 点崩溃时，它甚至在你查看监控面板之前就能通过 Telegram 通知你。

我写这部分的时候，笔记本电脑的风扇一直在尖叫，这很贴切，因为 OpenClaw 也会占用你实际的硬件资源。它不在云端，而是在你的硬盘上，占用你的内存，读取你的文件，偶尔还会做一些让你忍不住惊呼“等等，我没让你这么做啊”的事情。

到 2026 年 2 月，该项目在 GitHub 上的星标数超过 20 万，成为开源历史上增长速度最快的代码库之一。硅谷和中国的公司开始采用它。斯坦伯格被 OpenAI 聘用。整个项目也转为开源基金会。

而且它完全基于 Markdown 文件运行。

“这是一只宠物龙虾”

好吧，事情是这样的。大家都把OpenClaw说得好像是科幻电影里那种可怕的自主系统。其实不是。它只是一只宠物龙虾。

留在我身边。

养宠物龙虾需要一个鱼缸。你的电脑（或者虚拟专用服务器）就是鱼缸。OpenClaw 则运行在本地，它就驻留在你的硬件上。
宠物龙虾需要食物。这就是你的 LLM API 密钥。OpenClaw 本身没有智能。你需要喂它 Claude、GPT、DeepSeek，甚至可以通过 Ollama 喂它本地模型。模型越智能，龙虾就越智能。
宠物龙虾需要规则。这指的是SOUL.md一个纯文本文件，你在里面写下它应该如何表现。“要专业。未经允许不得删除文件。早上7:30给我发送晨间简报。”龙虾每次醒来都会阅读这个文件。
宠物龙虾有记忆力。这就是它memory/的记忆文件夹。它每天都会写一篇日记。所有重要的事都会记录下来MEMORY.md。它记得你。它记得你的项目。它记得你讨厌饼图。
宠物龙虾可以学习各种小把戏。这些就是技能。Markdown 指令文件可以教你的龙虾如何做特定的事情：管理你的 Gmail、整理 Obsidian 笔记、监控服务器健康状况或在社交媒体上发布内容。
宠物龙虾有心跳。真的。OpenClaw 也配备了心跳系统。它每隔 30 分钟（可配置）就会唤醒，检查状态HEARTBEAT.md，并决定是否需要为你执行某些操作。无需你发出指令。

就是这样。这就是OpenClaw。

一只龙虾，在水箱里，有规则、有记忆、有技巧，还有心跳。

OpenClaw 架构

当你向 OpenClaw 代理发送消息时，底层实际发生的情况如下。我会一步一步地讲解，保证每一步都很简单易懂。下图是OpenClaw 消息流：

每次你给你的龙虾发短信，大约2秒钟就会发生这种情况。

让我用通俗易懂的话来解释一下。

第一步：你发送消息。可以是 Telegram、Discord，也可以是内置的网页界面。这都无关紧要。OpenClaw 拥有适用于 WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Microsoft Teams、Google Chat 等平台的适配器。每个适配器都会将你的消息转换为标准格式。

步骤 2：网关进行路由。网关是 OpenClaw 的控制平面，默认运行在 18789 端口。它会确定哪个代理应该处理您的消息，加载正确的会话，然后将其转发出去。

步骤 3：代理运行时启动。关键就在这里发生。运行时会读取您的工作区文件（AGENTS.md、SOUL.md、TOOLS.md），加载所有相关的技能，搜索内存以获取过往对话的上下文，并构建一个庞大的系统提示。然后，它会将所有这些信息发送到您配置的 LLM。

第四步：LLM 进行思考。无论是 Claude、GPT、DeepSeek 还是其他任何你选择的算法，它都会读取所有上下文信息并生成响应。如果需要执行某些操作（例如运行命令、打开浏览器或读取文件），它会请求调用相应的工具。

步骤 5：工具执行。运行时会拦截工具调用并实际执行它。运行 bash 命令？完成。用 Chromium 打开网站？完成。写入文件？完成。可选地，所有这些操作都在 Docker 沙箱中运行，这样即使有恶意命令也无法破坏您的系统。

步骤 6：您收到回复。回复会通过网关、通道适配器返回，最终到达您的消息应用程序。

整个循环只需要几秒钟。而且你一行代码都没写。

我当时正在吃剩下的汉堡，突然就明白了这种架构的精髓。它并不复杂，只是……层次分明，就像汉堡一样。

让我们实际安装一下这个东西

理论就讲到这里吧。我手痒了，咱们动手做起来。

先决条件

你需要三样东西：

Node.js 22 或更高版本。OpenClaw使用 TypeScript 编写，并通过 npm 分发。

一台运行 macOS、Linux 或 Windows（需安装 WSL2）的电脑。如果您使用的是 Windows 系统，官方文档强烈建议您使用 WSL2。

LLM API 密钥。可以使用 Anthropic（Claude）、OpenAI（GPT），或者您也可以通过 Ollama 免费运行本地模型。

就这些。不用 Kubernetes，不用 Docker除非你以后想用沙箱。

步骤 1：安装 OpenClaw

打开终端。深呼吸。输入以下内容：

# 这会在你的系统上全局安装 OpenClaw
# 它只是一个 npm 包。就是这样。这就是推文内容。npm install -g openclaw @latest

如果您在 Mac/Linux 系统上遇到权限错误：

# 修复 npm 全局权限（只需做一次，以后你会感谢我的）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 现在安装
npm install -g openclaw@latest

这很重要：你刚刚把一只龙虾放进了硬盘里。它现在什么都不会发生。它只是静静地待在那里，等待着。

步骤 2：运行新用户引导程序

# 这是整个 OpenClaw 生态系统中最重要的一条命令
# 它会引导你完成所有操作
openclaw onboard --install-daemon

接下来会问你一系列问题。以下是你会遇到的问题：

安全警告。它会告诉你这个机器人运行在你的本地计算机上，并且拥有实际权限。请阅读、接受并尊重它。
快速入门 vs 自定义设置。首次使用请选择快速入门。
模型选择。选择您的 AI 提供商。如果您有 Anthropologie API 密钥，请选择 Claude。如果您有 OpenAI，请选择它。两者均可。
频道设置。首先选择一个即时通讯平台。我推荐 Telegram，因为它的设置最简单。
技能。您可以暂时跳过这部分。我们稍后会添加技能内容。
用户界面选择。目前请选择 Web 用户界面（控制用户界面）。这样更容易查看发生了什么。

# 完成配置后，检查网关是否正在运行openclaw gateway status

# 如果它没有运行，请启动它
openclaw gateway start

# 在浏览器中打开
openclaw dashboard
# 这将打开http://127.0.0.1:18789/

重要性：网关现在正在您的计算机上作为后台守护进程运行。您的“龙虾”已经苏醒，它正在呼吸，它有心跳。

步骤 3：连接 Telegram（您的第一个频道）

让我们给你的龙虾装上电话线吧。

打开 Telegram。搜索@BotFather。

发送/newbot。

给你的机器人起个名字（例如，“MyLobster”）。

给它一个以X_bot（例如，my_lobster_bot）结尾的用户名。

BotFather会给你一个API令牌。复制它。

现在告诉 OpenClaw 你的机器人信息：

# 您将在开机过程中提示时粘贴令牌
# 或者直接编辑配置文件：
openclaw config

在配置文件（~/.openclaw/openclaw.json）中，您需要添加类似以下内容：

{
"channels" : {
"telegram" : {
"enabled" : true ,
"token" : "YOUR_BOT_TOKEN_FROM_BOTFATHER" ,
"allowFrom" : [ "YOUR_TELEGRAM_USER_ID" ]
}
}
}

这个allowFrom字段至关重要。它会将您的 Telegram 用户 ID 添加到白名单，防止陌生人向您的机器人发送消息并控制您的计算机。您可以在 Telegram 设置中找到您的用户 ID。

# 重启网关以应用新配置
openclaw gateway restart

现在打开 Telegram。给你的机器人发消息。说“你好”。

如果它有反应，恭喜你。你刚刚构建了一个个人人工智能助手，它驻留在你的硬件上，能够跨会话记住你，并且可以在你的机器上执行命令。

第一次成功的时候，我的猫走过了我的键盘。它还在对话记录里加了“喵喵喵”的语音提示。机器人试图把它理解成一个操作指令。

重要性：你的龙虾现在有了自己的电话线。你可以随时随地和它通话，它也会通过 Telegram 回复你。Discord、WhatsApp、Slack 或任何其他支持的通讯工具也同样适用。

了解工作空间（灵魂栖息之地）

这正是 OpenClaw 与其他所有 AI 工具的不同之处：工作区。

运行命令后openclaw onboard，它会创建一个工作区目录。默认情况下，它位于~/.openclaw/workspace/。让我们看看里面的内容：

# 让我们窥探一下龙虾的大脑
ls ~/.openclaw/workspace/

你会看到类似这样的内容：

~/.openclaw/workspace/
├── AGENTS.md # Operating instructions. The "job description."
├── SOUL.md # Personality. Voice. Values. The "character sheet."
├── USER.md # Info about YOU. Your preferences.
├── TOOLS.md # Which tools the agent can use.
├── HEARTBEAT.md # What to check proactively.
├── MEMORY.md # Long-term memory. Durable facts.
├── memory/ # Daily diary entries
│ ├── 2026-03-25.md
│ └── 2026-03-26.md
└── skills/ # Installed skills
├── weather/
│ └── SKILL.md
└── gmail/
└── SKILL.md

它们每一个都是纯文本 Markdown 文件。让我逐一解释。下图是OpenClaw 工作区文件层次结构。

每个文件都可编辑。每个文件都可阅读。你的龙虾对你没有任何秘密。

SOUL.md：人格档案

这是我最喜欢的。它定义了你的代理是什么样的人。

# 灵魂特工

## 个性
- 专业且平易近人
- 简洁明了，更倾向于使用要点而非段落
- 主动提供相关信息

## 核心价值观
- 用户隐私至上；绝不泄露数据
- 任何涉及财务影响的行动前务必确认
- 所有事实性陈述均需注明来源- 若任务失败，请报告错误；切勿捏造成功

## 长期指示
- 上午 7:30 进行晨间简报，最多 5 个要点
- 总结邮件时，首先突出显示行动事项
- 在回复“下一步是什么”之前，务必先查看 HEARTBEAT.md 文件

每次你的代理程序启动（每条信息，每一次心跳），它都会SOUL.md首先读取。它通过读取自身而存在。请仔细想想这一点。

你可以让你的代理使用正式、随意、讽刺或极其简洁的语言。一位用户的 SOUL.md 文件里只有一句话：Terse.就这一个词。然后代理就照做了。

AGENTS.md：职位描述

这是主要指令文件。可以把它看作是运营合同。它包含了优先级、界限、工作流程和质量标准。务必保持规则的稳定性。

# 代理配置

## 优先级
1. 安全第一。切勿在未确认的情况下执行破坏性命令。

2 . 准确性高于速度。报告前务必进行验证。

3 . 上下文至关重要。回复前务必检查内存。

## 工作流程规则
- 代码审查时，先检查安全问题，再检查代码风格。
- 邮件草稿的正式程度应与收件人的要求保持一致。
- 研究时，至少参考 3 个信息来源后再进行总结。

## 界限
- 未经明确批准，绝不发送电子邮件。
- 绝不修改项目目录之外的文件。
- 绝不与其他用户分享对话内容。

USER.md：关于您的文件

您的沟通偏好、常用限制、已知格式偏好。这就是个性化层。

# 用户个人资料

## 基本信息
- 姓名：Sarah
- 时区：UTC+8
- 职位：高级全栈开发人员

## 偏好
- 沟通风格：直接、简洁、不废话
- 偏好格式：带代码块的 Markdown
- 晨间简报时间：当地时间早上 7:30
- 讨厌饼图。真的。千万别建议用饼图。

## 当前项目
- Tempest 项目：React Native 移动应用（高优先级）
- 后端迁移：从 Express 迁移到 Fastify

代理程序在每个会话中都会使用此信息。

MEMORY.md 和 memory/ 文件夹：日记

这很不可思议。OpenClaw 不使用数据库。既不用 PostgreSQL，也不用 Redis。它直接写入 Markdown 格式的日记条目。

memory/2026-03-26.md这是今天的日志。它记录了对话过程中发生的事情、智能体执行的操作以及它学到的知识。在长时间对话结束后，系统会执行“内存刷新”，将重要信息提升到MEMORY.md长期存储状态。

## 每日日志 - 2026年3月26日

- 用户询问季度报告格式：偏好表格而非图表
- 已于 UTC 时间 14:23 将热修复程序部署到测试服务器
- 用户提及即将于 4月 15 日至 22 日休假，无需晨会
- 发现身份验证模块存在代码检查错误，已提交 GitHub 问题 #347

MEMORY.md这是一个精简、精选、稳定的文件。其中包含经得起时间考验的事实，能够经受住日常信息的冲击。

## 核心事实

- 用户名：Sarah
- 时区：UTC+8
- 主要项目：Project Tempest（React Native 应用）
- 偏好沟通方式：直接、简洁、不使用表情符号
- 对蘑菇过敏（提及此信息是为了获得餐厅推荐）
- 假期：2026 年 4月 15 日至 22 日

您可以随时使用任何文本编辑器自行编辑这些文件。更改会在下次交互时立即生效。

当我第一次发现这个文件时，笔记本电脑屏幕上“蘑菇”这个词正好被污迹遮住了。我当时以为是“mustrooms”，花了十分钟琢磨那是什么食物。

重要性：这是 OpenClaw 最重要的设计决策。没有数据库，没有云存储。所有内容都存储在您的磁盘上。透明、可编辑，并可使用 Git 进行版本控制。您可以完全掌控git blameAI 代理的内存。

工具与技能：每个人都会遇到的困惑

这会让每个初学者都犯错。让我现在就把它解决掉。

工具就像器官，它们决定了 OpenClaw 能否完成某项任务。

技能就像教科书，它们教会 OpenClaw 如何做某事。

这个比喻最终让我豁然开朗：

你的龙虾（代理）有爪子（工具）。爪子可以抓握、拉动、推动。工具的作用就在于此：读取文件、写入文件、执行 shell 命令、浏览网页、搜索互联网。

但你的龙虾会做三明治吗？不会。做三明治需要食谱（技能）。食谱上写着：“取面包，放馅料，合上面包。”龙虾会用它的螯按照食谱来做。

下图是工具与技能——三个层面：

工具是肌肉，配置是权限单，技能是操作说明。缺一不可，否则什么都不会发生。

25 个内置工具按层分组：

第一层：基础工具（必备工具）

read- 读取文件（只读，安全）

write- 写入新文件

edit- 修改现有文件

apply_patch- 应用代码补丁

exec- 运行任何 shell 命令（强大/危险的那个）

web_search- 在互联网上搜索

web_fetch阅读网页

browser- 通过 Chromium 实现完整的浏览器自动化

第二层：智能工具（使其成为代理的要素）

memory_search- 跨内存文件进行语义搜索

memory_write- 更新内存

sessions_spawn- 为并行任务生成子会话

第三层：技能（ClawHub 上超过 5700 个）

技能实际上就是一个包含SKILL.md文件的文件夹。

skills/
└── weather/
└── SKILL.md

SKILL.md 文件内容如下：

---
name: weather
description: Get current weather information for any location
version: 1.0.0---

# Weather Skill

When the user asks about the weather:

1. Use the web_fetch tool to query wttr.in/{location}?format=3
2. Parse the response
3. Present the information in a clean, readable format
4. Include temperature, conditions, and any weather warnings

那是一项技能。它是一个包含指令的 Markdown 文件。没有编译后的代码，也没有 API 封装。只有 LLM 读取并执行的书面指令。

OpenClaw 要实际执行一项技能，必须满足三个条件。以“读取你的 Gmail”为例：

配置：您是否已允许 OpenClaw 运行命令？（如果没有允许exec，它甚至无法启动程序。）
安装：机器上是否gog已安装桥接工具？（如果没有安装，OpenClaw 知道该怎么做，但无法连接到 Google。）
授权：您是否已登录 Google 帐户并授予访问权限？（未经授权，Google 将不会允许访问。）

三者都必须满足。我写第一个自定义技能的时候，一直把笔别在耳朵后面。三个小时后我的搭档指出来我才发现。真是经典。

安装技能：有趣的部分

# 从 ClawHub（社区技能注册中心）安装
clawhub install weather
clawhub install gmail
clawhub install github

# List what you've got
clawhub list

# List what's eligible to run in your environment
openclaw skills list --eligible

# Update all skills
clawhub update --all

# Uninstall a skill
clawhub uninstall weather

也可以通过网页控制面板安装技能。前往[此处插入网址] http://127.0.0.1:18789/，导航至“技能”部分，搜索所需内容，然后点击“安装”。

技能就像乐高积木一样，可以用来搭建龙虾的骨架。

心跳：当你的龙虾变得主动起来

正是这个特性使 OpenClaw 与其他所有 AI 助手区别开来，人们第一次看到它时都会感到震惊。

大多数人工智能助手都会等待你发出指令。OpenClaw 则无需如此。

定时任务会按照您配置的时间间隔运行（默认值：每 30 分钟一次）。代理程序启动后，读取数据HEARTBEAT.md，运行推理循环，并决定是否需要向您发送信息。

无需提示。

以下是HEARTBEAT.md可能的样子：

# Heartbeat Instructions

## Every 30 minutes:
- Check if any unread emails require urgent attention
- Monitor the staging server health endpoint
- Check if the Tempest project CI/CD pipeline has any failures

## Every morning at 7:30 AM:
- Compile a morning briefing with:
- Top 3 unread emails
- Today's calendar events
- Any overnight CI/CD failures
- Weather for the day

## Conditional alerts:
- If staging server returns non-200 status, alert immediately
- If any email from the CEO arrives, prioritize notification
- If GitHub PR has been open for >48 hours without review, nudge me

你的服务器凌晨 3 点宕机了？心跳机制会在下一个周期检测到它，并通过 Telegram 向你发送消息：“嘿，测试环境返回了 503 错误。需要我调查一下吗？”

您关注的股票下跌了15%？“您的英伟达持仓已低于您的阈值。以下是详细信息。”

你并没有要求它们那样做。龙虾只是……注意到了。

配置信息位于您的主配置文件中：

{
"agents": {
"defaults": {
"heartbeat": {
"every": "30m"
}
}
}
}

您可以调整间隔，完全禁用它，或者如果您正在监控某些关键内容，可以将其提高到每 5 分钟检查一次。

每个心跳周期都会加载智能体的当前上下文，检查心跳指令中定义的条件，并且仅在真正需要关注时才发送消息。它不会每 30 分钟就发送一次垃圾邮件。它每 30 分钟进行一次检查，并在有需要时发出警报。

为什么这很重要：正是这一点让 OpenClaw 从聊天机器人变成了真正的助手。聊天机器人会等待，而助手会行动。这种“心跳”是“回答问题的工具”和“为你保驾护航的工具”之间的区别。

创建自定义技能：你的第一个自定义技能，一步一步来

让我们来打造一个真正有用的东西。一个能够根据 Git 提交生成每日站会总结的技能。

# Step 1: Create the skill directory
# Nothing fancy here. Just a folder.
mkdir -p ~/.openclaw/workspace/skills/daily-standup

# Step 2: Write the SKILL.md
cat << 'EOF' > ~/.openclaw/workspace/skills/daily-standup/SKILL.md---
name: daily-standup
description: Generate a daily standup summary from git commits
version: 1.0.0
requirements:
- git---

# Daily Standup Skill

## When to trigger
When the user asks for a standup update, daily summary,
or during morning briefing.

## Instructions

1. Ask the user which project directory to check
(or use the default from USER.md if available)

2. Run `git log --oneline --since="yesterday"` in the
project directory

3. Group commits by type:
- feat: New features
- fix: Bug fixes
- refactor: Code improvements
- docs: Documentation updates
- chore: Maintenance tasks

4. Summarize each group in 1-2 sentences

5. Add any in-progress work from the last commit message

6. Format as a standup update:
## Standup - [Date] ### Yesterday
- [grouped summaries]
### Today
- [planned work based on open issues/PRs]
### Blockers
- [any failing CI, unreviewed PRs, or dependency issues]

## Important
- Keep total length under 200 words
- Highlight any PRs awaiting review
- If no commits since yesterday, say so honestly
EOF

# Step 3: Restart the gateway to pick up the new skill
openclaw gateway restart

# Step 4: Verify the skill loaded
openclaw skills list --eligible
# You should see "daily-standup" in the output

现在给你的机器人发消息：“给我一份关于 Tempest 项目的现场更新报告。”

它读取技能信息，运行git命令，格式化输出，然后发送回去。五秒钟。

想更高级一点？OpenClaw 还能帮你生成技能。只需告诉它：“帮我创建一个技能，监控我在 Hacker News 上的声望值，并在我发布的帖子登上首页时提醒我。”它会生成完整的 SKILL.md 文件，包括文件夹结构和辅助脚本。

自动生成的技能往往过于冗长和乐观。在委托它们执行重要任务之前，务必对其进行精简。让它们提出问题而不是猜测。当缺少输入时，让它们停止运行。

为什么这很重要：你并没有编写 Git 集成代码，而是用英文写了一套指令。剩下的部分由 AI 处理。这就是其理念：不要编写集成代码，只需描述即可。

多模型支持：尽情探索

OpenClaw 并不关心你使用哪个 LLM 模型。你可以随时切换模型。

// ~/.openclaw/openclaw.json
{
"providers" : {
"anthropic" : {
"apiKey" : "sk-ant-your-key-here"
} , "openai" : {
"apiKey" : "sk-your-key-here"
} ,
"ollama" : {
"apiBase" : "http://localhost:11434/v1"
}
} ,
"agents" : {
"defaults" : {
"model" : "anthropic/claude-opus-4-5"
}
}
}

想使用 Ollama 完全本地运行以获得最大程度的隐私保护吗？

# 安装 Ollama（一条命令）
curl -fsSL https://ollama.com/install.sh | sh

# Pull a model
ollama pull llama3

# Point OpenClaw at it in your config
# Use the ollama provider entry as shown above

论连接哪个大脑，智能体循环的工作原理都相同。Claude 用于复杂推理，GPT 用于创造性任务，还有一个更便宜的模型用于日常心跳检查。您可以根据需要自由组合搭配。

关于费用：一位 Discord 用户报告称，他一周内就花费了 200 美元的 Claude API 费用。每次心跳都会重新加载所有工作区文件（消耗 4,000 到 10,000 个代币）。长时间对话中的内存刷新每次会消耗 10,000 到 25,000 个代币。如果您启用心跳并频繁聊天，代币消耗会迅速增加。

SOUL.md 文件应控制在 500 行以内。整理您的内存文件。使用价格较低的型号进行心跳检查。

安全：因为你的龙虾拥有根访问权限

咱们就别粉饰太平了。OpenClaw 对你的电脑拥有实实在在的控制权。如果exec启用，它可以运行任何 shell 命令，包括rm -rf ~安装软件包，以及读取你有权访问的任何文件。

OpenClaw 的一位维护者在 Discord 上说：“如果你不了解如何运行命令行，那么这个项目对你来说太危险了，无法安全使用。”

以下是不可妥协的安全措施：

1. 切勿在您的个人电脑上运行（仅限严肃用途）

使用虚拟专用服务器 (VPS)、闲置的 Mac Mini 或虚拟机。即使发生快速注入或安全漏洞，您的个人数据也能保持安全。

2. 将网关绑定到本地主机

{
"gateway": {
" address ": "127.0.0.1"
}
}

端口 18789 上的 Web 控制面板授予代理的完全控制权限。未经身份验证，切勿将其暴露在公共互联网上。

3. 启用令牌认证

{
"gateway" : {
"auth" : {
"mode" : "token"
}
}
}

4. 对危险行为使用明确同意

{
"tools" : {
"exec" : {
"ask" : "on"
}
}
}

这样，你的代理在运行 shell 命令之前就会请求权限。

5. 定期看医生

# OpenClaw 内置的安全和健康检查工具openclaw doctor --repair

6. 兽医第三方技能

思科安全团队发现，存在一个真实存在的 CVE 漏洞 (CVE-2026-25253)，该漏洞会导致 AI 网关被攻破。他们发现第三方技能会在用户不知情的情况下窃取数据。短短三天内，ClawHub 上就出现了 14 个恶意技能。

安装任何技能之前：

查看创建者并查看 GitHub 仓库
逐行读取 SKILL.md 文件
检查它需要哪些权限
用于openclaw skills list --eligible验证范围

认真对待安全问题，~/.openclaw/像对待密码库一样保护它。

龙虾的安全性取决于你的操作。

部署方案：龙虾该放在哪里？

你有很多选择。

选项 A：您的本地计算机（仅限开发/测试）

玩玩还行。不建议用于任何需要依赖的功能。你的笔记本电脑进入睡眠状态，你的龙虾也进入睡眠状态。

方案 B：虚拟专用服务器 (VPS)（推荐用于始终在线的情况）

DigitalOcean 为 OpenClaw 提供一键部署功能。只需启动一个 droplet，点击部署，几分钟内即可运行。他们会自动处理防火墙规则、非 root 用户执行和身份验证通信。

# 如果在 VPS 上手动部署：
# 1. 获取一台全新的 Ubuntu 24.04 服务器
# 2. 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 3. 如果您的 VPS 内存小于 2GB，请添加交换空间：
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

4. 安装 OpenClaw
npm install -g openclaw@latest

# 5. 运行
openclaw onboard --install-daemon 进行安装

选项 C：Docker

# 基于 Docker 的隔离部署
docker pull openclaw/openclaw:latest
docker run -d \
--name my-lobster \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest

选项 D：Nix（面向声明式配置爱好者）

有一个由社区维护的 Nix flake 文件openclaw/nix-openclaw。如果你了解 Nix，你就知道这为什么重要了。

对于生产环境，请设置 systemd 服务，以确保 Gateway 在重启后仍然可用：

# 创建 systemd 服务
sudo tee /etc/systemd/system/openclaw-gateway.service << 'EOF' [Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/home/ubuntu/.openclaw
ExecStart=/home/ubuntu/.npm-global/bin/openclaw gateway start --foreground
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl enable openclaw-gateway
sudo systemctl start openclaw-gateway

重要性： OpenClaw 是一个守护进程，需要全天候运行。选择一个合适的服务器位置，根据你计划对其依赖程度来选择。

秘密

官方文档刻意隐瞒了一件事，因为它简单得令人尴尬：

OpenClaw 的全部智能都来自于系统提示的构建。

就是这样。除了LLM本身提供的功能之外，没有其他花哨的AI技术。当你发送消息时，代理运行时只会……读取你的文件，将它们打包成一个简洁易懂的系统提示符，然后发送给LLM。所有思考都由LLM完成。

所谓的“自主行为”？其实就是一个定时任务，它会生成一个提示符并发送出去。

所谓的“持久内存”？其实就是添加到提示符前面的 Markdown 文件。

所谓的“个性”？它是一个被注入到程序顶部的文本文件。

OpenClaw 从架构上看是一个非常优秀的提示符构建器，并附加了一个消息路由功能。

Claude Code 和 OpenClaw 的工作区有何区别CLAUDE.md？Claude Code 的文件是一套指令集：它告诉智能体该做什么。而 OpenClaw 的完整指令集则是一个认知系统：它告诉智能体它是谁、它记住了什么以及它必须读取什么。每次启动时，智能体都会主动调用工具重新读取其工作区文件，本质上是在“重新学习自身”。这正是跨会话记忆的关键所在。

黄金法则：OpenClaw 的智能程度取决于它构建的提示符，而您控制着进入该提示符的每个文件。

编辑 SOUL.md 文件，即可更改代理的身份。编辑 HEARTBEAT.md 文件，即可更改它监控的内容。编辑内存文件，即可更改它记住的内容。您看到的每一个行为都可以追溯到磁盘上的一个文件。

那不是限制，而是特点。

快速参考：你实际会用到的所有命令

# 安装和设置
npm install -g openclaw @latest # 全局安装
openclaw onboard --install-daemon # 首次设置向导

# 网关管理
openclaw gateway start # 启动网关
openclaw gateway stop # 停止网关
openclaw gateway restart # 重启（配置更改后）
openclaw gateway status # 检查是否正在运行

# 控制面板和用户界面
OpenClaw 控制面板 # 在浏览器中打开 Web 用户界面
# 默认 URL：http://127.0.0.1: 18789/

# 技能管理
clawhub install <技能名称> # 从 ClawHub 安装
clawhub list # 列出已安装的技能
clawhub update --all # 更新所有技能
clawhub uninstall <技能名称> # 移除技能
openclaw skills list # 显示所有技能
openclaw skills list --eligible # 显示可运行的技能
openclaw skills info <技能名称> # 技能详情

# 健康与诊断
openclaw doctor # 运行诊断
openclaw doctor --repair # 修复常见问题
openclaw logs --follow # 查看实时日志

# 配置
openclaw config # 编辑配置文件
openclaw update --channel stable # 更新 OpenClaw

把这个打印出来，贴在显示器上。你会感谢我的。我屏幕旁边那张写着这些命令的便签纸现在都沾满了指纹。

伤疤胜于理论的技巧

先从一个频道和一个技能开始。别第一天就把 Telegram、Discord、Slack、Gmail 和你的智能家居都连接起来。你会因为要排查哪个频道发送了什么信息而崩溃的。
始终限制权限exec。请在配置中进行设置exec.ask: "on"。代理会在运行 shell 命令前询问。这让我避免了一个恶意程序pip install试图升级我的整个 Python 环境。
安装第三方技能前务必阅读其说明。思科曾发现一些恶意技能会窃取数据。请仔细阅读 SKILL.md 文件。如果其中有任何您不理解的功能，请不要安装。
openclaw doctor每次配置更改后都要运行它。它可以检测出错误的路径、缺失的依赖项和配置错误。像使用牙线一样定期运行它：即使你认为不需要它，也要运行它。
SOUL.md 文件应简洁明了。诸如“提供帮助”之类的模糊指令会导致模糊的行为。而诸如“最多 5 个要点，删除任何文件前请确认”之类的具体指令则会导致明确的行为。
使用 Git 跟踪你的工作区。整个~/.openclaw/workspace/目录都只是文件。把它放到一个 Git 仓库里。现在，你就可以记录 AI 的个性、记忆和行为的版本历史记录了。回滚错误的更改，并追踪具体的提交。
端口 18789 上的 Web 用户界面是您的最佳助手。它显示会话数、内存使用情况、已安装技能和代理状态。在深入研究配置文件之前，请务必先使用它。
如果出现故障，请先检查以下三项：网关是否正在运行？（openclaw gateway status）您的 API 密钥是否有效？您的通道令牌是否正确？
为消息渠道设置私信配对。这样可以确保未知发件人收到配对码，未经您的批准无法与您的客服人员互动。
定期整理你的记忆。日常笔记容易变得杂乱无章。删除旧的记录。将重要的信息上传到 MEMORY.md。这就像整理办公桌一样。