Home
BlogThoughtsAbout

OpenClaw零基础配置教程·其二

March 6, 2026

图片

图片

图片

图片

在下一篇文章中，我们将进入更进阶的玩法：包括如何更新 OpenClaw、如何通过 Telegram 群组绑定多个 Agent（每个 Agent 都拥有完全独立的工作空间、会话记录和长期记忆，并且可以自由切换为任意已通过 API 接入的大模型——让不同的 AI 各司其职，在节省 token 消耗的同时，把每一分算力都用在刀刃上），以及OpenClaw Mac 客户端的安装与日常使用。

敬请期待。

另外，感谢所有读者在上一篇文章下的留言与互动！

有朋友问到宿主机与虚拟机之间如何互传文件——我的 OpenClaw 出于安全考虑是安装在虚拟机内的，但两边的文件并非完全隔绝。解决方法其实很简单：打开 UTM，右键点击你的虚拟机，选择编辑，进入共享选项卡，点击添加，选择宿主机上你想共享的文件夹路径，保存后重启虚拟机，它就会作为一块共享磁盘挂载进来（如图中的 My Shared Files），从此宿主机与虚拟机之间的文件互通就再无障碍了。

图片

图片

图片

图片

（进入虚拟机后，所有E/David路径下的文件，都会出现在My Shared Files里）

0. 为什么我不推荐你用一键脚本安装 OpenClaw？

在上一篇文章里，我带大家从零搭建了 Node.js 运行环境。很多朋友可能会有疑问：折腾这么半天，直接用官方提供的一键安装命令

curl -fsSL https://openclaw.ai/install.sh | bash

不就完了？

这个问题问得好。我们先来看看这条命令到底在做什么。

它的学名叫 Curl-to-Bash，原理是从官网下载一个 install.sh脚本，然后立刻在你的终端里执行它。脚本会自动检测你的系统环境，帮你把一切都配置好——听起来很美，但这里有几个问题我必须提醒你：

第一，它是一个黑盒。这个脚本在你的系统里做了什么，你并不清楚。它可能修改了你的 .zshrc或 .bashrc，把文件藏在了某个隐蔽的目录里。今天没问题，但等你哪天想更新或者卸载，就会发现完全找不到头绪。

第二，后续更新是个麻烦事。脚本安装方式最大的硬伤，就是没有统一的更新机制。你只能靠官方是否提供了对应的 update命令或者新的安装脚本，否则每次更新都可能变成一次"重新折腾"——而 AI 工具这个领域，更新频率是非常高的。

第三，理论上存在安全风险。直接把网上的脚本下载下来就执行，万一官方网站某天出了什么问题，你的电脑就相当于对外敞开了一扇门。这个概率虽然很低，但不得不提。

相比之下，通过 npm 安装的方式就清爽得多：

npm i -g openclaw

因为你上一步已经装好了 Node.js 和 npm，所以这个前置条件对你来说根本不是障碍。而 npm 的优势在于，它的每一步都是透明且标准化的——你知道它装在哪，更新只需要一条命令 npm update -g openclaw，卸载也是一条命令 npm uninstall -g openclaw，整洁、可控、不留后患。

这也是我在上篇文章里花时间带大家把环境搭起来的真正原因：让你拥有用 npm 管理工具的能力，而不是每次都依赖别人写好的脚本替你做决定。

0.1 API

什么是 API？为什么 OpenClaw 离不开它？

你可以把 API 理解成一张"点菜单"。

ChatGPT、Claude、Gemini 这些大模型，本质上是运行在各家公司服务器上的超级大脑。你平时用网页版或 App 跟它们对话，背后其实也是在调用这张"点菜单"——你发出一条消息，服务器收到请求、处理、返回结果，整个过程走的就是 API。

网页版和 App 帮你把这个过程包装好了，所以你感觉不到。而当开发者想把大模型的能力嵌入自己的产品时，就需要直接拿着这张菜单去"点菜"，这就是所谓的调用 API。

OpenClaw 为什么需要 API？

OpenClaw 是一个 AI Agent 框架，它本身并不是大模型，它更像是一个"大脑的躯壳"——负责帮你规划任务、操作电脑、调用工具、记录记忆。但真正负责"思考"和"理解"的部分，还是要靠背后的大模型来完成。

所以每当 OpenClaw 需要做决策、理解你的指令、生成下一步行动时，它都要向大模型发送一次 API 请求，问一句："接下来我该怎么做？"

为什么会消耗大量 API？

这里有一个很多人没意识到的关键点。

你平时用 ChatGPT 聊天，一问一答，调用一次。但 OpenClaw 作为 Agent，完成一个任务的过程是这样的：

分析任务 → 制定计划 → 执行第一步 → 观察结果 → 重新思考 → 执行第二步 → 再观察……

每一个"思考"的环节，都是一次 API 调用。一个稍微复杂的任务，可能在你看不见的地方已经来回调用了几十次。加上 OpenClaw 会把大量的上下文记忆、工具说明、历史操作一并打包发给模型，每次消耗的 token 数量也相当可观。

简单来说：你用 ChatGPT 是坐公交，用 OpenClaw 做复杂任务是包了一辆专车跑全程。效果更强，但油钱自然也更多。

这就是为什么在开始之前，我建议大家先把 API 额度备足——不然任务跑到一半没额度了，什么都得停下来。

因此，想要流畅地使用 OpenClaw，背后的大模型必须有充足的 token 额度撑着，否则用起来总会畏手畏脚。所以在正式开始之前，我比较建议大家先去薅一把 Google Cloud 的 300 美元免费赠金。

不过有几点必须提前说清楚，请大家认真权衡：这笔额度有效期只有 3 个月，到期自动作废；每个谷歌账号只能领取一次；并且必须绑定信用卡才能激活。如果这几个条件对你来说都不是问题，那它绝对是目前性价比最高的起步方式。

如果你不方便绑卡，或者暂时没有 Visa / Mastercard，也不想购买 ChatGPT 或 Claude 的官方 API，还有几条替代路线可以走：可以考虑 Kimi 2.5 的 API、智谱 GLM-5 或 GLM-4.7 的 API（也可以直接开通他们的 Coding Plan），或者通过 Zenmux 平台购买或订阅中转服务。这些选项后续有机会再单独介绍，本篇我们先聚焦 Google API 的领取方式。

Google 为新用户提供 300 美元的免费 API 额度，个人日常使用完全足够。

获取步骤：

0. 去 Google Cloud Console 绑定信用卡、激活 300 美元额度。网址 https://cloud.google.com/

图片

图片

图片

这一步需要绑定一张信用卡来验证身份，页面上也明确说明了——在你主动升级为付费账户之前，不会产生任何扣费，绑卡只是用来做身份核验，300 美元的免费额度用完或到期后也不会自动续费。

至于用什么卡，理论上支持 Visa 和 Mastercard 的虚拟信用卡是可以通过验证的，这里就各显神通了——网上有很多提供一次性或虚拟卡的平台，大家自行搜索。

不过有几点需要注意：

首先，部分虚拟卡在 Google 这里可能会验证失败，因为 Google 的风控系统会识别一些已知的虚拟卡 BIN 号段，遇到这种情况换一张或换一个平台的卡试试即可。

其次，Google 可能会预授权扣除一笔小额费用（通常是 1 美元左右）来验证卡的有效性，之后会退还，所以卡里需要有少量余额。

其三，用完 300 美元赠金之后，如果你不想产生额外费用，记得不要主动点击升级到正式付费账户，赠金到期后服务会自动暂停，不会悄悄扣钱。

  1. 访问 https://aistudio.google.com，用 Google 账号登录
  2. 点击左侧「Get API key」→「Create API key」
  3. 复制生成的 API Key，立即妥善保存

⚠️ 安全提示：API Key 等同于你的账号密钥，请勿分享给任何人。

图片

图片

图片

创建之后，右侧有set up billing的选项，设置好之后即可得到300美元赠金

都设置好之后，在

console.cloud.google.com/billing 可以看到当前已发放的赠金。

另外，如果通过各种方式获得了Gemini pro，可在

https://developers.google.com/program/my-benefits

领取每月10美元的赠金用于API（200美元的Gemini ultra每月可领100美元）

如果通过各种方式通过Gemini学生认证，获得一年的pro会员的话，那么，理论上说，每月10美元的赠金（有效期一年）搭配三个月300美元的初始赠金，应该够用很长时间了。

0.2 连接 Channel：让你随时随地掌控 OpenClaw

安装完成之后，OpenClaw 默认只能在本机操作。但很多时候，我们希望能够远程下达指令、接收任务进度通知、甚至在手机上直接控制 Agent 干活——这就需要为它连接一个通信频道，也就是 Channel。

你可以把 Channel 理解成 OpenClaw 的"对讲机"。它本身在电脑上默默运行，而你通过绑定的 Channel，随时随地都能跟它说话、发指令、查看它的执行状态。对于一个需要长时间在后台处理任务的 Agent 来说，这个能力几乎是不可缺少的。

从上图可以看到，OpenClaw 目前支持相当多的 Channel，包括 Telegram、WhatsApp、Discord、飞书、Slack、iMessage、Signal 等等，部分需要额外安装插件才能启用。

如果你不方便申请 Telegram 或 WhatsApp，优先推荐使用飞书，国内注册门槛低，操作也简单。

如果条件允许，我个人更推荐 Telegram。原因有三：安全性比 WhatsApp 略高；Bot 生态非常成熟，创建和配置极为方便；最重要的是，后续我们要玩的多 Agent 群组控制，在 Telegram 里实现起来最为顺手——把多个 Agent 的 Bot 拉进同一个群，分工协作，各司其职，体验非常丝滑。

0.2.1 创建你的 Telegram Bot

OpenClaw 通过 Telegram Bot 来收发消息，我们需要先向官方"申请"一个 Bot。

步骤如下：

  1. 在 Telegram 中搜索 @BotFather（这是 Telegram 官方的 Bot 管理机器人），点击「Start」
  2. 发送 /newbot
  3. 按提示输入 Bot 的显示名称

（随便起，比如 My OpenClaw Bot或者David、Jarvis什么的都可以）

  1. 输入 Bot 的用户名（全局唯一，且必须以 bot结尾）。由于这个名字在全 Telegram 范围内不能与任何人重复，建议起一个足够独特的名字，比如 Jarvis_17760704_openclaw_bot，这样撞名的概率几乎为零。

5.创建成功后，BotFather 会返回一串 Token，格式类似：1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

⚠️ 请务必妥善保存这个 Token，它是你的 Bot 的唯一凭证，丢失后只能重新生成，且不要分享给任何人。

图片

图片

这个有蓝标、月用户超500万的才是真正的bot father

1. 终于开始正式安装OpenClaw了

1.1 写在前面

如0.中所说，我们要通过npm安装。

npm 是什么？为什么安装时会出现黄色警告？

先从一个比喻说起

你用 iPhone 的时候，想要一个 App，你会去 App Store 搜索、下载、安装。App Store 帮你管理了所有 App 的版本、更新和卸载。

npm 就是程序员世界里的 App Store，只不过它管理的不是手机 App，而是各种代码工具和程序包。它的全名是 Node Package Manager，也就是 Node.js 的包管理器。

什么叫"通过 npm 安装"？

当你在终端输入：

npm i -g openclaw

这条命令的意思是：去 npm 的官方仓库（类似 App Store 的服务器）找到名叫 openclaw的这个包，把它下载下来，安装到我的电脑上，并且让我在任何地方都能直接使用它。

其中 i是 install（安装）的缩写，-g是 global（全局）的意思，也就是安装到全局环境，而不只是某个项目文件夹里。

整个过程 npm 会自动帮你处理好一切：下载主程序、下载它依赖的所有其他组件、配置好可执行命令……你什么都不需要手动操作。这就是"通过 npm 安装"的好处所在。

那些黄色的 Warning 是什么？要紧吗？

图片

截图里的内容，全是 npm warn deprecated，这个词的意思是"已被弃用"。

你可以这样理解：OpenClaw 在运行时，依赖了很多其他人写的代码包（就像一栋楼依赖钢筋、水泥、玻璃等各种材料）。其中某些材料的供应商在 npm 仓库里留了一张"告示"，说：

"我这个版本太老了，已经不再维护了，建议使用新版本。"

npm 在安装的时候看到了这些告示，就用黄色字体打印出来提醒你。

但这只是警告，不是报错。关键区别在于：

  • Warning（黄色）

    ：安装成功完成，只是提示你某些依赖比较老旧，目前仍然可以正常运行

  • Error（红色）

    ：安装失败，出现了真正需要解决的问题

这些警告的根本原因是，OpenClaw 本身调用了一些比较老的依赖包，而这些包的作者没有及时更新。这是整个 npm 生态里非常普遍的现象——几乎所有稍微复杂一点的工具在安装时都会出现一堆黄色警告，只要最后没有红色的 Error，安装就是成功的，可以正常使用。

1.2 正式安装

https://openclaw.ai/ 给出的安装命令如下：

图片

图片

可以先输入npm -v 以及node -v，验证一下这两个有没有装好

然后，我们先在终端里输入：

npm i -g openclaw

运行完成后，我们再在终端里输入：

openclaw onboard

第一步：安全须知确认

启动后，你会看到一段安全警告（如图）。OpenClaw 目前仍处于测试阶段，它可以读取文件、执行操作，一条错误的指令可能会触发预期之外的行为。官方建议在正式使用前定期运行安全审计命令：

阅读完毕后，选择 Yes确认继续。

图片

第二步：选择安装模式

这里有两个选项，选择 QuickStart（快速开始）即可。后续所有配置都可以通过 openclaw configure随时修改，不必担心现在设置不完整。

图片

第三步：选择大模型

这一步选择你要接入的 AI 模型提供商。如前文所说，我们选择 Google，然后在下一个界面的认证方式中选择 Google Gemini API key，将你之前在 AI Studio 获取的 API Key 粘贴进去即可。

当然，这里你也可以看到 OpenClaw 支持非常多的模型提供商，包括 Anthropic、Kimi（Moonshot AI）、智谱（Z.AI）、Grok、OpenRouter 等，大家根据自己的实际情况选择。

图片

图片

第四步：连接通信 Channel

接下来选择你要绑定的 Channel。如前文介绍，这里我们选择 Telegram（Bot API），然后按提示将 BotFather 给你的 Token 粘贴进去。

如果你暂时没有准备好 Telegram，也可以先选择 Skip for now，之后通过 openclaw configure再补充配置。

图片

图片

图片

第五步：Skills 配置

OpenClaw 的 Skills 是它的技能扩展包，相当于给 Agent 装上各种"工具"。这里会显示当前可用的 Skills 状态：

  • Eligible（可用）

    ：已满足依赖条件，可以直接启用

  • Missing requirements（缺少依赖）

    ：需要额外安装对应工具才能使用

系统会询问你是否现在安装缺失的依赖，并列出一份清单，包括 github、obsidian、gemini等各类工具。建议初次安装选择 Skip for now，先把基础跑通，后续有需要再针对性地安装。

接下来会有几个询问是否配置额外 API Key 的问题（比如 Google Places、Notion、ElevenLabs 等），如果你暂时用不到这些功能，全部选 No跳过即可。

图片

图片

图片

图片

第六步：Hooks 配置

Hooks 是一个自动化触发机制，可以在你发出特定指令（比如 /new或 /reset）时自动执行预设动作，例如将会话上下文保存到记忆中。

初次安装同样建议选择 Skip for now，等熟悉基本操作后再回来配置。

图片

第七步：启动方式

最后一步，系统询问你想以哪种方式启动 OpenClaw：

  • Hatch in TUI

    ：在终端界面中运行

  • Open the Web UI

    （推荐）：在浏览器中打开图形化控制台

  • Do this later

    ：稍后手动启动

选择 Open the Web UI，系统会自动在浏览器中打开 127.0.0.1本地控制台（建议保持该地址）。

图片

图片

完成！欢迎来到 OpenClaw Gateway Dashboard

如最后一张截图所示，这就是 OpenClaw 的 Web 控制台界面。左侧导航栏清晰地分为三个区域：

Control 区包含 Overview（总览）、Channels（通信频道）、Instances（实例）、Sessions（会话记录）、Usage（用量统计）和 Cron Jobs（定时任务）。

Agent 区包含 Agents（Agent 管理）、Skills（技能）和 Nodes（节点）。

Settings 区包含 Config（配置）和 Debug（调试）。

中间的 Chat界面可以直接与你的 Agent 对话，用于快速测试和日常交互。右上角的 Health OK表示服务运行正常。

图片

可以跟openclaw稍微聊聊天，初次聊天建议按照以下方式进行：

你好

你是Jarvis（名字随便起，后面也可以改），我是Sam（也是随便起，不过不太建议用真名，想一个自己听着比较习惯的就行），我是一名____工作者，我的爱好是____（也是随意，主要看后续想让openclaw执行什么样的任务，后面也可以改），你的性格是专业冷静（也可以是一些，同样看个人需求，后面也可以改，不过 专业冷静 能稍微省一点token，一般的回复会控制在3到5句话之内），你的emoji是___（可以让它自己选一个，“给你自己选一个emoji”，一般的emoji都可以：😊、🤖、📚、⚙️、🪜之类的都可以）

确认 OpenClaw 运行正常之后，先关闭网页，然后在 Finder 中使用快捷键 Command + Shift + .（句号键）显示隐藏文件，找到 .openclaw文件夹，将它整个复制一份，保存到「下载」或「文稿」等你方便找到的地方。

这一步强烈建议不要跳过。说实话，在折腾这套环境的过程中，我自己重装了 3 次系统，OpenClaw 更是重装了十几次。踩了这么多坑之后，我总结出一条最实用的经验：只要初始状态能跑通，就立刻备份整个 .openclaw文件夹。

后续出问题，十有八九是 openclaw.json配置文件被改坏了。这时候不需要重装，只需要把备份里的旧文件覆盖回去，几秒钟就能恢复正常——省去了大量排查问题和重新配置的时间。

图片

写在最后：

openclaw gateway restart

这个终端命令希望大家牢记，以后会经常使用

另外，在虚拟机里开启openclaw之后，中文输入法有时会卡住，出现显示问题，这个时候一般只要在终端里输入这个命令，让输入法关闭并重启一下就可以了：

sudo pkill -9 -f SCIM

再另外，如果要更新openclaw，可采用以下方式：

如果 OpenClaw 是通过 npm 全局安装的，最安全、最推荐的更新方式如下：

  1. 停止服务

    （防止文件占用）： openclaw gateway stop

  2. 更新

    （强制使用最新稳定版）： npm install -g openclaw@latest

  3. 重启服务

    openclaw gateway start

npm install -g 会直接覆盖旧文件，确保所有依赖同步更新。

先停止服务是为了避免更新过程中出现文件锁定或权限错误。

至此，OpenClaw 的基础安装已经全部完成。下一篇我们将进入更进阶的玩法。