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 的技能不在于多，而在于稳定且符合实际需要。

怎么样？赶紧试试吧。