如何在 2026 年设置 OpenClaw:详细的逐步教程

设置 OpenClaw 需要安装 Node.js、运行 OpenClaw 安装程序、完成引导向导、配置 AI 模型提供商,并可选择连接 Telegram 或 Discord 等消息通道。对于熟悉终端的用户,整个过程大约需要 5 分钟;如果您不熟悉命令行工具,则可能需要长达 30 分钟。本指南涵盖了从全新机器到正常运行的 OpenClaw 代理的每个步骤。
Advanced computer use agent
Production-grade reliability
Transparent Execution

为什么要设置您自己的 AI 代理?

为什么要设置您自己的 AI 代理?

大多数人通过聊天界面使用 AI,例如 ChatGPT、Claude、Gemini。您输入一个问题,然后得到一个答案。但 AI 代理有所不同。代理不仅回答问题,它还能在您的计算机上执行操作。它能点击按钮、填写表格、读取文件、发送电子邮件,并自主执行多步骤工作流程。

对此的需求正在迅速增长。一项 2025 年 Gartner 预测 预计到 2028 年,33% 的企业软件应用程序将包含代理式 AI。开发者们也没有坐等——像 OpenClaw 这样的工具已经获得了数十万个 GitHub 星标,因为它们让任何人都能构建和运行自己的 AI 代理,而无需依赖付费的 SaaS 平台。

人们设置自己的代理主要有三个原因:

成本控制。 托管式 AI 代理平台收取月度订阅费。使用 OpenClaw 这样的开源工具,您只需支付底层模型 API 调用费用(对于中度使用,通常每月 5-20 美元,配合 AnthropicOpenAI)。

可定制性。 OpenClaw 使用 插件和技能系统 ,允许您构建自定义自动化。您可以修改代理的行为、添加新功能,并与任何具有 API 的工具集成。

数据隐私。 当您自托管时,您的提示和数据都保留在您的机器上。没有第三方平台会看到您的查询。对于处理敏感数据的团队来说,这是一个硬性要求。

什么是 OpenClaw?

OpenClaw 是一个 开源 AI 代理框架 它将大型语言模型转化为自主的计算机使用代理。它通过 API 连接到 Anthropic (Claude)、OpenAI (GPT) 和 Google (Gemini) 等模型提供商,然后扩展这些模型,使其能够执行操作——浏览网页、执行 shell 命令、读写文件以及控制桌面应用程序。

主要技术特点(来源):

  • 许可证: MIT(完全开源,可免费用于商业用途)
  • 运行时: Node.js 22.14+(推荐使用 Node 24)
  • GitHub 星标数: 36.1万+(截至2026年4月)
  • 架构: 运行在端口 18789 上的网关服务 + 用于交互的 CLI 或仪表盘 UI
  • 模型支持: Anthropic Claude、OpenAI GPT、Google Gemini,以及通过 Ollama 支持的本地模型
  • 消息集成: Telegram、Discord、WhatsApp 和 Slack 频道(来源)

OpenClaw本身不是一个模型——它是一个介于你和模型之间的框架。你需要提供自己的API密钥,OpenClaw则提供了一个脚手架,能将语言模型转化为一个真正在你的电脑上执行任务的智能体。

你为什么要设置OpenClaw?

如果你符合以下所有三个条件,OpenClaw将是你的正确选择:

  1. 你熟悉终端操作。 设置过程涉及运行命令行指令、编辑JSON配置文件,并可能需要管理后台服务。如果你从未用过终端,预计会有一个学习曲线。
  2. 你希望对你的智能体拥有最大程度的控制权。 OpenClaw让你能够访问完整的源代码、插件系统和配置。你可以修改任何内容。如果你只是想要一个开箱即用的智能体,那么托管平台会更适合你。
  3. 你理解安全方面的权衡。 OpenClaw运行时拥有 对你机器的完全本地访问权限。它没有内置的危险操作审批系统——智能体可以读取、写入和删除你的用户账户可以访问的任何文件。其安全模型依赖于 共享内存中的应用程序级检查 进程,而非操作系统级别的隔离。

不应使用OpenClaw的人群:

  • 非技术用户 不愿管理先决条件、配置文件或服务器部署的用户
  • 任何处理敏感数据的人 在智能体执行破坏性操作前,需要操作系统级别隔离或人工干预审批系统的人
  • 需要24/7全天候可用性的团队 无需管理自己的基础设施——OpenClaw要求您自行托管和维护Gateway服务

如果以上任何一点符合您的情况,请跳到末尾的“如何使用Sai实现此功能”部分,了解零配置替代方案。

如何设置OpenClaw:分步指南

步骤1:安装先决条件

您需要 Node.js 22.14或更高版本(推荐Node 24) 以及来自模型提供商的API密钥。

检查您的Node.js版本:

node --version

如果您没有安装Node.js或版本过旧,请从 nodejs.org 安装,或使用版本管理器:

nvm install 24
nvm use 24

获取API密钥:

OpenClaw支持 Anthropic (Claude), OpenAI (GPT), Google (Gemini),以及 通过 Ollama 的本地模型。Anthropic 用户请在 console.anthropic.com注册。OpenAI 用户请访问 platform.openai.com

步骤 2:安装 OpenClaw

根据您的操作系统运行相应的命令(来源):

Mac / Linux:

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

Windows (PowerShell):

irm https://openclaw.ai/install.ps1 | iex

其他安装方式:Docker、Nix(nix-openclaw),或 npm(npm install -g openclaw)。

验证安装:

openclaw --version

步骤 3:运行新手引导向导

openclaw onboard --install-daemon

向导会要求您 (来源):

  1. 选择模型提供商 —— Anthropic (Claude)、OpenAI、Google,或通过 Ollama 使用本地模型
  2. 输入您的 API 密钥 ——存储在 ~/.openclaw/openclaw.json
  3. 配置网关 ——负责处理代理通信的后台服务,运行在 port 18789

--install-daemon 标志会将网关设置为系统服务,使其在后台运行。

步骤 4:验证并开始使用您的代理

确认网关正在运行:

openclaw gateway status

然后开始与您的代理聊天:

openclaw              # Terminal chat (quickest)
openclaw dashboard    # Visual UI in your browser

步骤 5:连接消息通道(可选)

OpenClaw 支持 Telegram、Discord、WhatsApp 和 Slack。每个通道都需要各自的机器人令牌。

Telegram 示例:

  1. 打开 Telegram,搜索 @BotFather
  2. 发送 /newbot 并按照提示操作
  3. 将机器人令牌复制到 ~/.openclaw/openclaw.json
  4. 重启: openclaw gateway restart

步骤 6:部署以实现全天候运行(可选)

为了让您的代理始终可用,请在 VPS 上运行网关(DigitalOceanHetzner,或 AWS Lightsail ——基础服务器每月5-10美元)。

openclaw gateway status    # Check if running
openclaw gateway start     # Start the service
openclaw gateway stop      # Stop the service
openclaw gateway restart   # Restart after config changes

在您的个人电脑上,当您关闭电脑时,Gateway 会停止运行。

OpenClaw 设置与替代方案:它们有何不同?

Tool Setup Method Time to First Task Technical Requirements Always-On Hosting Security Model
OpenClaw CLI installer + onboarding wizard
source
~5 minutes (terminal-comfortable users) Node.js 22.14+, API key, terminal Self-managed (VPS or always-on machine) Application-level checks, full local access
Sai by Simular Download desktop app, sign in
source
Under 2 minutes None - works out of the box Managed cloud (included in subscription) Cloud VM isolation + approval system
Claude Computer Use Docker setup or Claude Max subscription
source
~10-15 minutes (self-hosted) Docker, API key (self-hosted) or $100/mo subscription Self-managed Docker container or cloud subscription Docker container isolation (OS-level)
Manus Sign up on website
source
Under 1 minute None - web app only Managed cloud (included) Cloud-only, no local access
NanoClaw git clone + Claude Code setup
source
~5 minutes Git, Claude Code, API key Self-managed OS-level container isolation

如何使用 Sai 实现此功能

如果您想要一个无需任何终端设置、服务器管理或API密钥配置,即可控制您的桌面和浏览器的AI代理, Simular 的 Sai 是一个开箱即用的托管替代方案。

  • 无需任何设置 ——下载桌面应用,登录,即可在2分钟内开始自动化任务。无需Node.js,无需API密钥,无需配置文件(来源
  • 内置安全 ——每项潜在的破坏性操作(发送电子邮件、删除文件、提交表单)在Sai执行前都需要您的明确批准,并且通过云虚拟机隔离将代理与您的本地机器分开(来源)
  • 桌面版 + 浏览器版 + 集成功能均包含 -- Sai 可控制原生应用和浏览器标签页,原生连接 Gmail、Google 日历、Google 表格和 GitHub,并支持定时工作流 -- 全部功能均可免费试用 7 天 且不按 API 调用次数收费

Stop doing repetitive tasks. Let Sai handle them for you.

Sai is your AI computer use agent — it operates your apps, automates your workflows, and gets work done while you focus on what matters.

Try Sai

FAQS

})