如何让 OpenClaw 正常工作

Source: Dev.to

版本

安装

1. 安装 Node.js，如果系统上尚未安装。

2. 安装特定的 OpenClaw 版本：

   npm install -g openclaw@2026.4.22
   # added 498 packages in 51s

3. 验证安装：

   openclaw -v
   # OpenClaw 2026.4.22 (00bd2cf)

注意: 本指南固定在 2026.4.22 版本以保证可复现性。更新的版本可能会引入不兼容的更改。

初始设置

OpenClaw 需要模型提供商和 API 密钥。本指南使用 Google AI Studio。

1. 在 Google AI Studio 中创建 Gemini API 密钥并安全保存。

2. 运行入职命令：

   openclaw onboard

   该命令可能需要几分钟时间来安装额外组件。出现提示时，按下面显示的方式回答问题，以完成快速启动设置。

   Question	Answer
   我了解此默认是个人使用，共享/多用户使用需要锁定。继续吗？	yes
   设置模式	QuickStart
   模型/认证提供商	Google
   输入 Gemini API 密钥	Paste the key you generated
   模型	google/gemini-2.5-flash
   选择频道（快速启动）	Skip for Now
   搜索提供商	Skip for Now
   现在配置技能吗？（推荐）	No
   启用钩子吗？	Skip for now
   你想如何孵化你的机器人？	Do this later

3. 确认默认模型：

   openclaw models
   # (output should list google/gemini-2.5-flash as the default)

与代理的首次聊天

打开两个终端：

• 终端 1 – 启动网关（服务器）：

  openclaw gateway

• 终端 2 – 打开文本 UI（客户端）：

  openclaw tui

当 UI 准备好后，输入如 Hello 的问候语。代理应作出回应，以确认设置成功。

恭喜，你已成功运行

现在你可以与 OpenClaw 代理交互，定义其行为、个性和任务，并继续探索其功能。

额外：需要考虑的事项

• 预算安全： 为你的 Google Gemini API 密钥设置低消费上限（例如 $1），以避免意外费用。

• 进程清理： 在 Windows 上，终止 OpenClaw 进程可能需要：

  taskkill /F /IM node.exe /T

• 版本更新： 如果你想尝试更新的版本，请在 npm install 命令中将 2026.4.22 替换为所需的版本，但要做好可能出现不兼容更改的准备。