乐于分享
好东西不私藏

OpenClaw 安装教程:从零到上手

OpenClaw 安装教程:从零到上手

最近折腾 OpenClaw 折腾得挺开心的。先是在 VPS 上装了一遍尝鲜,后来又在 Mac 和 Linux 上都跑通了。虽然网上教程已经不少,但我还是想写一篇自己的总结,毕竟实践过程中踩了不少坑,也有一些心得。

简单说,OpenClaw 就是一个开源的 AI 助手,跑在你自己的电脑上。你可以通过飞书、Telegram 这些聊天工具,或者 Web 界面跟它对话。它能帮你处理邮件、管理日历、写代码、控制智能家居——就像一个 24 小时在线的私人助理。

官方资源:

  • • 官网:https://openclaw.ai/
  • • GitHub:https://github.com/openclaw/openclaw
  • • 文档:https://docs.openclaw.ai/zh-CN

好了,话不多说,直接开始。

安装 OpenClaw

整个流程其实就三步:装 OpenClaw → 跑 onboard 配置向导 → 开始用。

我这里主要在 Linux 下操作(Mac 基本一样)。

最简单的方式:npm 安装

npm install -g openclaw

装完验证一下:

openclaw --version

看到版本号就说明装好了。

其他安装方式

如果 npm 不方便,还有这些选择:

一键安装脚本

macOS / Linux:

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

Windows PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

从源码安装(适合想折腾的)

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

配置向导

装好之后,运行:

openclaw onboard

这个向导会带你完成所有配置,包括 AI 模型、聊天渠道、技能、Hooks 等等。

安全提示

首先会弹出安全警告,看完选 Yes 继续就行。

选择模式

◇  Onboarding mode│  QuickStart

选 QuickStart 就好,会自动配置好端口(18789)和绑定地址(127.0.0.1)这些。

配置 AI 模型

这一步要选 AI 模型提供商,然后输入 API Key。

提供商
获取方式
备注
Anthropic Claude
https://console.anthropic.com
需要国际信用卡
OpenAI GPT
https://platform.openai.com
需要国际信用卡
OpenRouter
https://openrouter.ai
支持多种支付,聚合多家模型
DeepSeek
https://platform.deepseek.com
国内服务商,支持支付宝
Moonshot / Kimi
https://platform.moonshot.cn
国内服务商
本地模型
支持 Ollama 等
免费,需要本地算力

国内用户的省钱方案

Anthropic 和 OpenAI 的 API 不仅要国际信用卡,费用也不便宜。国内用户我推荐用阿里云百炼或者字节火山的月套餐。

不要问为什么首选这俩,问就是大厂真的优惠。

新用户的话,最低档月套餐优惠价不到 10 块钱。老用户也会给优惠券,差不多也就 10 块一个月。

关键是这两个平台不仅有自家的旗舰模型(阿里的 qwen3.5-plus、qwen3-max,字节的 Doubao-Seed-Code),还支持第三方模型,比如 kimi 2.5、GLM-4.7。

这种 ALL IN ONE 平台的好处就是选择多,哪个模型好用换哪个。

我这段时间主要用阿里的 qwen3.5-plus,速度挺快,关键是基本没有 Token 焦虑了。

阿里云百炼:https://www.aliyun.com/benefit/ai/aistar?clubBiz=subTask..12397051..10263..

注意阿里云百炼月套餐的 API-KEY 是 sk-sp- 开头的,跟阿里云通用 KEY 不一样,别搞混了。

阿里云百炼提供了两套兼容协议的 API 地址:

OpenAI 兼容:

https://coding.dashscope.aliyuncs.com/v1

Anthropic 兼容:

https://coding.dashscope.aliyuncs.com/apps/anthropic

字节火山也可以,我觉得差不多:https://volcengine.com/L/N2P_cZvd7jg/

配置聊天渠道

向导会让你选择聊天渠道:

◇  Select channel (QuickStart)

我建议选飞书,下面说说怎么配。

第一步:创建飞书应用

去飞书开发者后台:https://open.feishu.cn/app?lang=zh-CN

创建应用后,在"应用能力"那里添加"机器人"能力。

然后在"开发配置" → "权限管理"这里添加权限。搜索 "message",把"消息和群组"的权限都开通。至少要开通这些:

  • • im:message
  • • im:message.group_at_msg:readonly
  • • im:message.p2p_msg:readonly
  • • im:message:send_as_bot

如果你希望机器人能读写飞书文档和多维表格,也可以顺手都开通。

在"凭证与基础信息"这里拿到两个关键信息:App ID 和 App Secret。

第二步:启动本地程序

这一步最关键。你需要用刚才拿到的 App ID 和 App Secret 去连接飞书。

在配置文件里填入这两个信息,然后启动服务。如果配置正确,服务启动后会自动建立长连接。保持这个服务运行,别关。

如果你不太会手动配置,我建议装个 Claude Code 或者 OpenCode,让 AI 帮你配。直接跟 AI 说"帮我配置 OpenClaw 的飞书频道,配置文件是 openclaw.json",跟着提示做就行。

第三步:飞书后台保存配置

确认程序已经成功运行(终端没报错,可能显示 "connected")后,回到飞书开放平台后台:

进入应用 → "事件与回调" → 选择"使用长连接接收事件" → 保存。

然后点"添加事件",搜索并添加 im.message.receive_v1

最后,这一步很重要:去"版本管理与发布",创建新版本并发布。只有发布后,配置才会正式生效。

配置技能和 Hooks

频道配置完后,向导会问你要不要配置 Skills。可以先跳过,后面需要再通过 openclaw configure 配置。

Hooks 建议全部启用(默认已全选):

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

后续可以用这些命令管理:

  • • openclaw hooks list — 查看所有 Hooks
  • • openclaw hooks enable <name> — 启用
  • • openclaw hooks disable <name> — 禁用

Gateway 服务

向导会自动安装 Gateway 服务(Linux 下是 systemd 服务),确保网关持续运行。

Web 控制面板

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

Web UI: http://127.0.0.1:18789/Web UI (with token): http://127.0.0.1:18789/#token=xxxxxGateway WS: ws://127.0.0.1:18789

孵化 Bot

最后一步,选择如何首次启动 Bot:

◇  How do you want to hatch your bot?│  ● Hatch in TUI (recommended)│  ○ Open the Web UI│  ○ Do this later

我推荐选 Hatch in TUI,会直接进入终端聊天界面。Bot 会发送 "Wake up, my friend!" 作为第一条消息。你可以开始跟它对话,告诉它你的需求——描述越详细,后续体验越好。

退出 TUI 按 Ctrl+C 就行。Bot 的 Gateway 服务还在后台跑着。

验证飞书连接

飞书应用发布成功后,开发者小助手会发消息通知。点"打开应用",给机器人发条消息,收到回复就说明配置成功了。

如果有异常提示,别慌,把提示复制下来扔给 Claude Code,让它帮你修。

日常使用

OpenClaw 有两个核心组件:

组件
说明
是否需要一直开着
Gateway 守护进程
后台服务,负责连接飞书等渠道、接收处理消息
✅ 是(开机自动启动)
TUI / Web 控制面板
聊天界面,在终端或浏览器中直接对话
❌ 否(需要时打开)

关键点:只要 Gateway 在后台跑着,你就能通过飞书随时跟 AI 对话——不需要打开 TUI 或 Web 控制面板。

下次开机后

onboard 向导已经自动装好了 Gateway 的 systemd 服务,每次开机后会自动启动。

确认 Gateway 是否在运行:

openclaw status

手动管理 Gateway

通常不需要手动操作,但排查问题时可能用到:

# 查看状态openclaw status# 手动启动openclaw gateway --force# 查看实时日志openclaw logs --follow# 安装/卸载守护进程openclaw daemon installopenclaw daemon uninstall

OpenClaw 能干什么

除了 OpenClaw,现在还有 picoclaw、zeroclaw、nanobot 这些。我都试过,虽然其他 Claw 主打轻量,但总体来说还是 OpenClaw 功能最全。

那 OpenClaw 能干什么呢?

我觉得这个问题因人而异。OpenClaw 就是个工具,像住在电脑里的助手,可以操作你的电脑,也可以通过网络搜集信息。它能做什么,取决于你想干什么。

最简单的,你可以让它查天气、搜新闻、总结文章。

如果你给它权限,它可以操控电脑——帮你整理文件夹(高危操作,记得备份)、修改系统配置等等。

配合飞书云文档和多维表格,能做的事情就更多了。

最关键的是,OpenClaw 支持安装和创建技能(SKILL)。这提供了无限可能,比如用 SKILL 自动生成小红书封面、公众号图片。


最后我想说,OpenClaw 这类智能工具还不够完善,最好先找台闲置电脑,上面别放重要数据和隐私。先当玩具折腾,用熟了再慢慢扩展权限。

SKILL 也一样,别一上来就装一堆。先根据实际需要,把一两个技能打磨到能用、好用。AI 的技能不在于多,而在于稳定且符合实际需要。

怎么样?赶紧试试吧。