OpenClaw 安装与运行教程 | OpenClaw教程 | 第2篇

原文链接:https://mp.weixin.qq.com/s/aU6Fs3Gxtqw73ZIPV_Pcmg

在前面的文章中,对于OpenClaw是什么有了一个了解,这一篇看看如何安装和使用OpenClaw。

一、选择你的运行环境

首先,你需要一个地方让助手「住」下来。

方案A、云服务器

购买一台云服务器进行安装和使用,对于一开始的新手来说,可能成本会比较高一些。

云端部署的方式很多大厂也支持一键部署的方式进行体验了。

优点:24 小时在线,不怕断电,不占你电脑资源

适合:想让助手全天候待命的人

方案B、自己的电脑/Mac Mini / 旧笔记本

想先体验一下再决定?直接在当前电脑上跑。

优点:零门槛,立刻开始

缺点:关机就没了,适合试玩

二、安装与配置

整个过程分 3 步:安装 OpenClaw → 运行 onboard 向导(配置 AI 模型 + 聊天渠道 + 技能 + Gateway)→ 开始使用。

2.1 安装

安装有3种常用方式:npm install、curl .sh一键安装、源码安装

方式一:npm install

复制代码
npm install -g openclaw

说明:这里要已经有node环境了,不然是要自己配置这个环境的。

验证安装:

复制代码
openclaw --version

看到版本号即安装成功。

方式二:官方安装脚本(一键安装):

macOS / Linux:

复制代码
curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell:

复制代码
iwr -useb https://openclaw.ai/install.ps1 | iex

如果你用的是 Windows,建议先装 WSL2(Windows Subsystem for Linux),然后在 WSL 里操作。安装很简单:以管理员身份打开 PowerShell,运行 wsl --install 即可。

详细步骤见 微软官方 WSL 安装指南:

https://docs.microsoft.com/zh-cn/windows/wsl/install

方式三:源码安装**(适合开发者)**

复制代码
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

这3种环境方式大家看情况自行选择一种即可。博主一开始使用的是方式二,但是不知道为啥一直安装失败,所以就放弃了这种方式,选择了方式一,方式一的安装还是比较顺利的。

2.2 运行初始化向导

复制代码
openclaw onboard

向导会交互式引导你完成所有配置,包括:AI 模型、聊天渠道、技能、Hooks、Gateway 服务安装等。

2.2.1 安全提示

首先会显示安全警告,阅读后选择 Yes 继续。

2.2.2 选择 Onboarding 模式

复制代码
◇  Onboarding mode
│  QuickStart

选择 QuickStart(推荐),会自动配置网关端口(18789)、绑定地址(127.0.0.1)等默认设置。

2.2.3 配置AI模型

选择 AI 模型提供商并输入 API Key:

这里有很多的模型可以供选择和配置,根据情况自行选择一种方式。

2.2.4 安装后台守护进程

向导会问你要不要安装 daemon(后台服务)。选 Yes------这样助手会自动在后台运行,开机自启,不用你手动管。

  • Linux 服务器:自动创建 systemd 用户服务

  • Mac:自动创建 LaunchAgent

2.2.5 健康检查 + 技能安装

向导最后会启动 Gateway、运行健康检查,并让你选择安装推荐技能。

整个过程大概 3-5 分钟,全程跟着提示走,不需要手动编辑任何配置文件。

接下来向导会逐一询问是否配置各技能的 API Key:

复制代码
◇  Set GOOGLE_PLACES_API_KEY for goplaces?     → No(没有就跳过)
◇  Set GEMINI_API_KEY for nano-banana-pro?      → No
◇  Set NOTION_API_KEY for notion?               → No
◇  Set OPENAI_API_KEY for openai-image-gen?     → No
◇  Set OPENAI_API_KEY for openai-whisper-api?   → No
◇  Set ELEVENLABS_API_KEY for sag?              → No

💡 这些 API Key 都是可选的,用于特定技能。没有的话全部选 No 跳过即可,后续可通过 openclaw configure 随时补充。

2.2.6 配置 Hooks(自动化钩子)

复制代码
◇  Hooks ──────────────────────────────────────────────────────────╮│                                                                  ││  Hooks let you automate actions when agent commands are issued.  ││  Example: Save session context to memory when you issue /new.    ││                                                                  │├──────────────────────────────────────────────────────────────────╯│◇  Enable hooks?│  🚀 boot-md, 📝 command-logger, 💾 session-memory

建议全部启用(默认已全选),这三个 Hook 的作用:

Hook 作用
boot-md 启动时加载引导信息
command-logger 记录命令日志
session-memory 保存会话上下文到记忆

💡 后续可通过以下命令管理 Hooks:

  • openclaw hooks list

    --- 查看所有 Hooks

  • openclaw hooks enable <name>

    --- 启用

  • openclaw hooks disable <name>

    --- 禁用

2.2.7 安装 Gateway 服务

向导会自动完成以下操作(无需手动干预):

  1. Systemd 配置

    (仅 Linux):启用 systemd lingering,防止退出登录后服务被终止

  2. Gateway 服务安装

    :自动安装 systemd 服务,确保网关持续运行

    ◇ Systemd ─────────────────────────────╮
    │ │
    │ Enabled systemd lingering for root. │
    │ │
    ├───────────────────────────────────────╯

    ◇ Gateway service installed.

安装完成后,向导会自动验证 Slack 连接:

复制代码
Slack: ok (2180ms)
Agents: main (default)

看到 Slack: ok 表示 Slack 连接成功 ✅

2.2.8 Control UI 信息

向导会显示 Web 控制面板的访问地址:

复制代码
◇  Control UI ─────────────────────────────────────────────────────────────────────╮│                                                                                  ││  Web UI: http://127.0.0.1:18789/                                                 ││  Web UI (with token): http://127.0.0.1:18789/#token=xxxxx                        ││  Gateway WS: ws://127.0.0.1:18789                                                ││                                                                                  │├──────────────────────────────────────────────────────────────────────────────────╯

💡 记住这个地址,后续可以通过浏览器访问 Web 控制面板与 Bot 对话。 也可以随时运行 openclaw dashboard 打开。

在mac下会自动打开:

http://127.0.0.1:18789/overview

三、你的助手,上线了

向导完成后,你的助手就已经在后台运行了。验证一下:

复制代码
openclaw gateway status

如果看到 Gateway 正在运行,说明一切就绪。

四、日常管理命令

装好之后,这些命令你会经常用到:

复制代码
openclaw status          # 查看整体状态

openclaw gateway status  # 查看 Gateway 运行状态

openclaw health          # 健康检查

openclaw configure       # 重新配置(修改模型、频道等)

openclaw daemon restart  # 重启后台服务

openclaw daemon logs     # 查看运行日志

五、常见问题排查

❓ 安装脚本报错

Node.js 版本太低:OpenClaw 需要 Node.js 22+。检查版本:

复制代码
node -v

如果版本不够,安装脚本通常会自动帮你装。如果没有,手动升级:

复制代码
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bashnvm install 22

❓ 想重新配置?

随时可以重新运行向导:

复制代码
openclaw onboard

或者只改某一部分:

复制代码
openclaw configure
复制代码

扫码加入OpenClaw实战营一起探索OpenClaw变现:

历史文章

我用 OpenClaw 创办了16人AI团队:24小时不间断、高效运营!

OpenClaw 入门教程 | OpenClaw教程 | 第1篇

相关推荐
一个无名的炼丹师1 小时前
从零构建工业级 AI Agent 操作系统:本地优先记忆网络与动态 Skills 架构详解
网络·人工智能·架构·大模型·openclow
HyperAI超神经1 小时前
物理信息机器学习新突破!新型GNN架构可对复杂多体动力系统进行准确预测,赋能机器人/航空航天/材料科学
人工智能·深度学习·机器学习·架构·机器人·cpu·物理
tq10861 小时前
文明跃迁中的结构与网络
人工智能
速易达网络1 小时前
OpenClaw从入门到实战:打造你的专属AI智能体
人工智能
体育分享_大眼1 小时前
AI天花板级碰撞!GPT-5.4正式接入DataEyes,数据智能进入「秒级响应」时代
大数据·人工智能·gpt
冰糖猕猴桃1 小时前
【AI】深度解析:OpenAI API 调用之争 —— requests 裸连 vs openai SDK
人工智能·ai·openai·模型调用
cn_newer1 小时前
人工智能时代,劳累到死,还是轻松活着?
人工智能
StarChainTech1 小时前
告别“催款”焦虑:如何打造一款高可用、多场景的智能代扣系统
大数据·人工智能·微信小程序·小程序·软件需求
EMQX1 小时前
消息平台演进之路:为什么融合是必然趋势
人工智能·mqtt·智能硬件