OpenClaw 安装教程:2026 最新保姆级飞书对接指南,搭建你的开源 AI 助手 ​

OpenClaw 是一款开源的本地 AI 助手,本篇 OpenClaw 安装教程将手把手教你在 Linux 系统下部署最新版 OpenClaw,并完成飞书机器人对接。OpenClaw 支持在你自己的服务器上运行,通过飞书、WhatsApp、Telegram 等聊天工具交互。与云端 SaaS 服务不同,OpenClaw 让你完全掌控数据隐私,可以执行系统命令、浏览网页、管理文件,甚至编写代码——是你的专属开源 AI 助手。

注意:本教程在 Linux 系统下进行

OpenClaw 是什么? ​

OpenClaw(原名 Clawdbot,后更名为 Moltbot,现正式命名为 OpenClaw)是一个运行在你本地环境的高权限 AI 智能体。它的核心特性包括:

  • 本地部署:运行在你的服务器或电脑上,数据完全自主可控
  • 多平台支持:支持飞书、WhatsApp、Telegram、Discord、Slack 等主流聊天工具
  • 浏览器控制:可以浏览网页、填写表单、提取数据
  • 系统访问:读写文件、执行 Shell 命令、运行脚本
  • 持久化记忆:记住你的偏好和上下文,成为真正属于你的 AI
  • 插件扩展:支持社区技能插件,甚至可以自己编写插件

无论是邮件管理、日程安排、数据查询还是代码编写,OpenClaw 都能成为你的得力助手。

如果你想了解 OpenClaw 的前世今生,可以看这篇:Clawdbot 又又又改名了 并发布新版本。如果你使用钉钉而不是飞书,可以参考 OpenClaw 钉钉对接教程。

OpenClaw 安装前的准备工作 ​

安装 OpenClaw 需要满足以下环境要求:

项目要求
操作系统Linux(推荐)/ macOS / Windows (WSL2)
Node.js≥ 22.x
内存≥ 2GB(建议 4GB,否则需配置 swap)
网络能访问 GitHub、npm 仓库(国内服务器可能需要代理)
AI 模型通义千问、OpenAI、Claude、KIMI 等任一 API Key(千问免费额度充足)

安装 OpenClaw 依赖环境 ​

如果你不想手动安装依赖、配置环境,可以直接使用 阿里云 OpenClaw 一键部署,几分钟即可完成 OpenClaw 服务器搭建。

如果你选择手动安装,继续往下看。

第一步安装 Git

shell
# 安装 Git
sudo apt update
sudo apt install git -y

第二步安装 Node.js

shell
# 安装 NVM
# 国内使用 gitee 的镜像源
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash

# 国外使用
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

# 重新加载环境变量
source ~/.bashrc

# 安装 Node.js 22
nvm install 22

# 查看 nodejs 版本
node -v # 输出 v22 即可,版本只要 22 就行

安装 OpenClaw 开源 AI 助手 ​

shell
# 使用官方脚本安装
curl -fsSL https://openclaw.bot/install.sh | bash

服务器在国内,如果安装失败的话,可能需要解决网络问题

其他平台安装方式请参考OpenClaw 安装文档 (原 Clawdbot)

你会看到如下

shell
  🦞 OpenClaw Installer
  Siri's competent cousin.

✓ Detected: linux
✓ Node.js v22.22.0 found
✓ Git already installed
→ Installing OpenClaw 2026.2.6-3...
✓ OpenClaw installed

🦞 OpenClaw installed successfully (2026.2.6-3)!
Home sweet home. Don't worry, I won't rearrange the furniture.

Starting setup...


🦞 OpenClaw 2026.2.6-3 (85ed6c7) — curl for conversations.

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  🦞 OPENCLAW 🦞                    
 
┌  OpenClaw onboarding

如果首次安装,时间会很长,需要耐心等待。 如果最后输出如下内容:

shell
→ npm install failed; cleaning up and retrying...

新的脚本服务器内存要求变高了,据我使用下来 2G 内存,肯定会 OOM,如果出错的话,建议使用 swap 把硬盘空间当作交互内存使用。

成功之后会输出会看到下面的输出

shell
┌  OpenClaw onboarding
│
◇  Security ──────────────────────────────────────────────────────────────────────────────╮
│                                                                                         │
│  Security warning — please read.                                                        │
│                                                                                         │
│  OpenClaw is a hobby project and still in beta. Expect sharp edges.                     │
│  This bot can read files and run actions if tools are enabled.                          │
│  A bad prompt can trick it into doing unsafe things.                                    │
│                                                                                         │
│  If you're not comfortable with basic security and access control, don't run OpenClaw.  │
│  Ask someone experienced to help before enabling tools or exposing it to the internet.  │
│                                                                                         │
│  Recommended baseline:                                                                  │
│  - Pairing/allowlists + mention gating.                                                 │
│  - Sandbox + least-privilege tools.                                                     │
│  - Keep secrets out of the agent's reachable filesystem.                                │
│  - Use the strongest available model for any bot with tools or untrusted inboxes.       │
│                                                                                         │
│  Run regularly:                                                                         │
│  openclaw security audit --deep                                                         │
│  openclaw security audit --fix                                                          │
│                                                                                         │
│  Must read: https://docs.openclaw.ai/gateway/security                                   │
│                                                                                         │
├─────────────────────────────────────────────────────────────────────────────────────────╯
│
◆  I understand this is powerful and inherently risky. Continue?
│  ● Yes / ○ No
└

第一个选项就是询问你是否知道风险的,需要选择 yes, 然后回车。 第二步选择 QuickStart

shell
◆  Onboarding mode
│  ● QuickStart (Configure details later via openclaw configure.)
│  ○ Manual
└

第三步选择模型服务商,这里选择 Qwen,免费额度充足,适合入门快速使用

shell
◆  Model/auth provider
│  ○ OpenAI
│  ○ Anthropic
│  ○ MiniMax
│  ○ Moonshot AI (Kimi K2.5)
│  ○ Google
│  ○ xAI (Grok)
│  ○ OpenRouter
│  ● Qwen (OAuth)
│  ○ Z.AI (GLM 4.7)
│  ○ Qianfan
│  ○ Copilot
│  ○ Vercel AI Gateway
│  ○ OpenCode Zen
│  ○ Xiaomi
│  ○ Synthetic
│  ○ Venice AI
│  ○ Cloudflare AI Gateway
│  ○ Skip for now
└

选择千问模型后,选择 Qwen OAuth 之后 会提供一个链接,复制并在浏览器中打开

shell
 Qwen auth method
│  ● Qwen OAuth
│  ○ Back
└
shell
 Starting Qwen OAuth…
◇  Qwen OAuth ─────────────────────────────────────────────────────────────────────────╮
│                                                                                      │
│  Open https://chat.qwen.ai/authorize?user_code=-AYWBJHL&client=qwen-code to approve  │
│  access.                                                                             │
│  If prompted, enter the code -AYWBJHL.                                               │
│                                                                                      │
├──────────────────────────────────────────────────────────────────────────────────────╯
◓  Waiting for Qwen OAuth approval…...

复制链接后,打开浏览器,会看到如下界面。由于我已登录过,所以显示账户信息;如果尚未登录,按照提示完成登录即可。

登录完成后,会出现以下选项,提示选择对应的千问模型,如下图

shell
◇  Qwen OAuth complete
│
◇  Model configured ─────────────────────────────╮
│                                                │
│  Default model set to qwen-portal/coder-model  │
│                                                │
├────────────────────────────────────────────────╯
│
◇  Provider notes ──────────────────────────────────────────────────────────────────────╮
│                                                                                       │
│  Qwen OAuth tokens auto-refresh. Re-run login if refresh fails or access is revoked.  │
│  Base URL defaults to https://portal.qwen.ai/v1. Override                             │
│  models.providers.qwen-portal.baseUrl if needed.                                      │
│                                                                                       │
├───────────────────────────────────────────────────────────────────────────────────────╯
│
◆  Default model
│  ● Keep current (qwen-portal/coder-model)
│  ○ Enter model manually
│  ○ qwen-portal/coder-model
│  ○ qwen-portal/vision-model
└

选择默认模型 Keep current (qwen-portal/coder-model) 即可。接下来会提示选择 channel,这里先跳过,后续再添加。之前飞书都没有内置的,现在新版本飞书已经内置了

shell
 Select channel (QuickStart)
│  ○ Telegram (Bot API) (not configured)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ Feishu/Lark (飞书)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ LINE (Messaging API)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Tlon (Urbit)
│  ● Skip for now
└

继续下面选择 skills,也是选择 No

shell
 Skills status ────────────╮
│                            │
│  Eligible: 6               │
│  Missing requirements: 43  │
│  Blocked by allowlist: 0   │
│                            │
├────────────────────────────╯
│
◆  Configure skills now? (recommended)
│  ○ Yes / ● No
└

然后等待安装完成,最后会出现以下选项,这里选择 TUI

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

如果看到 TUI 聊天界面,说明安装成功,可以尝试输入 Hello 进行测试。 OpenClaw (原 Clawdbot) TUI 聊天界面 - AI 助手对话测试 然后直接使用 ctrl+c 先关闭,后面我们再来设置

查看 OpenClaw 服务状态 ​

可以使用下面的命令来查看

shell
 openclaw status

会看到如下图的结果就说明服务启动了

shell
🦞 OpenClaw 2026.2.6-3 (85ed6c7) — I read logs so you can keep pretending you don't have to.

│
◇  
│
◇  
OpenClaw status

Overview
┌─────────────────┬─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Item            │ Value                                                                                                                                               │
├─────────────────┼─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ Dashboard       │ http://127.0.0.1:18789/                                                                                                                             │
│ OS              │ linux 6.8.0-71-generic (x64) · node 22.22.0                                                                                                         │
│ Tailscale       │ off                                                                                                                                                 │
│ Channel         │ stable (default)                                                                                                                                    │
│ Update          │ pnpm · npm latest 2026.2.6-3                                                                                                                        │
│ Gateway         │ local · ws://127.0.0.1:18789 (local loopback) · reachable 42ms · auth token · VM-16-7-ubuntu (10.0.16.7) app unknown linux 6.8.0-71-generic         │
│ Gateway service │ systemd installed · enabled · running (pid 327748, state active)                                                                                    │
│ Node service    │ systemd not installed                                                                                                                               │
│ Agents          │ 1 · 1 bootstrapping · sessions 1 · default main active 1m ago                                                                                       │
│ Memory          │ enabled (plugin memory-core) · unavailable                                                                                                          │
│ Probes          │ skipped (use --deep)                                                                                                                                │
│ Events          │ none                                                                                                                                                │
│ Heartbeat       │ 30m (main)                                                                                                                                          │
│ Sessions        │ 1 active · default coder-model (128k ctx) · ~/.openclaw/agents/main/sessions/sessions.json                                                          │
└─────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

访问 OpenClaw Web UI 管理面板 ​

如何访问面板?服务监听在 http://127.0.0.1:18789/ 端口上,我们现在通过 ssh 隧道来访问,输入下面的命令

shell
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
# 回车之后
用户名@服务器IP's password: # 输入密码

然后在浏览器打开 http://127.0.0.1:18789/, 你会看到 Dashboard 了,如下图 OpenClaw (原 Clawdbot) Web UI Dashboard 未授权页面 图中显示的是未授权状态,回到服务器,输入以下命令

shell
clawdbot dashboard

会看到下面的面板数据,有这个 Dashboard URL

shell
openclaw dashboard

🦞 OpenClaw 2026.2.6-3 (85ed6c7) — Works on Android. Crazy concept, we know.

Dashboard URL: http://127.0.0.1:18789/#token=e8e5cd1573123ae9b11111111111111e2b94b8b7b4ccd
Copy to clipboard unavailable.
No GUI detected. Open from your computer:
ssh -N -L 18789:127.0.0.1:18789 ubuntu@222222
Then open:
http://localhost:18789/
http://localhost:18789/#token=e8e5cd1573123ae9b11111111111111e2b94b8b7b4ccd
Docs:
https://docs.openclaw.ai/gateway/remote
https://docs.openclaw.ai/web/control-ui

复制对应的 Dashboard URL 到浏览器打开,即可正常查看聊天记录。 OpenClaw (原 Clawdbot) Web UI 管理面板 - AI 助手聊天记录

至此 OpenClaw 开源 AI 助手已安装完成,可以正常访问了。接下来在聊天框首次输入 Hello,OpenClaw 会询问你它应该叫什么、应该叫你什么。你需要给这个 AI 助手设置一个名字,以及它对你的称呼。可以在聊天框这么输入

shell
Name: OpenClaw

My Name: Boss

OpenClaw 对接飞书机器人教程 ​

下面是本篇 OpenClaw 飞书教程的核心部分。回到刚才添加 channels 的配置,选择飞书添加。如有遗漏,可以看官方文档OpenClaw 飞书对接

shell
◆  Select a channel
│  ○ Telegram (Bot API)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ Feishu/Lark (飞书)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ LINE (Messaging API)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Tlon (Urbit)
│  ● Finished
└

选择之后会安装对应的扩展,回车就行了

shell
◆  Install Feishu plugin?
│  ● Download from npm (@openclaw/feishu)
│  ○ Skip for now
└

如果出现下面的错误,一般都是由于你之前安装过了,需要删除扩展

shell
 [plugins] feishu failed to load from /home/ubuntu/.openclaw/extensions/feishu/index.ts: Error: Cannot find module 'zod'
Require stack:
- /home/ubuntu/.openclaw/extensions/feishu/src/config-schema.ts

先退出安装飞书,先安装 zod,输入

shell
npm install -g zod

# 删除飞书扩展,一般都是由于你之前安装过了
rm -rf ~/.openclaw/extensions/feishu

如果没有错误的话,选择飞书通道之后,应该是下面的输出

shell
  Select a channel
│  Feishu/Lark (飞书)
│
◇  Feishu credentials ──────────────────────────────────────────────────────────────╮
│                                                                                   │
│  1) Go to Feishu Open Platform (open.feishu.cn)                                   │
│  2) Create a self-built app                                                       │
│  3) Get App ID and App Secret from Credentials page                               │
│  4) Enable required permissions: im:message, im:chat, contact:user.base:readonly  │
│  5) Publish the app or add it to a test group                                     │
│  Tip: you can also set FEISHU_APP_ID / FEISHU_APP_SECRET env vars.                │
│  Docs: feishu                 │
│                                                                                   │
├───────────────────────────────────────────────────────────────────────────────────╯
│
◆  Enter Feishu App ID
│  _ # 输入 App ID
└

先不着急输出,我们先登录飞书开放平台 https://open.feishu.cn,点击「开发者后台 -> 创建企业自建应用」,如下图 飞书开放平台创建企业自建应用 - OpenClaw 对接 然后点击创建应用,如下 飞书创建应用 - OpenClaw AI 机器人 创建完成后,首先到凭据管理中获取 App ID 和 App Secret,注意保存,后续配置需要使用。 飞书 App ID 和 App Secret 凭据管理 然后添加机器人,如下操作 飞书添加机器人能力 - OpenClaw AI 助手 首先配置个名字 飞书机器人名称配置 - OpenClaw

配置 OpenClaw 飞书参数 ​

拿到 App ID 和 App Secret 之后,在刚才的上面的输入填入 APP ID 和 App Secret,最后

shell
◇  Enter Feishu App ID
│  cli_a9xxxxxxxf85cb2 # 填入你自己的 App ID
│
◇  Enter Feishu App Secret
│  WmO1Hj1qkxxxxxxxxxxxihYL5NxXyTDt # 填入你自己的 App Secret
[info]: [ 'client ready' ]
│
◇  Feishu connection test ───────────────────────────╮
│                                                    │
│  Connected as ou_3ef555cb1axxxxxxxxeb6203805ba9ee  │
│                                                    │
├────────────────────────────────────────────────────╯
│
◆  Which Feishu domain?
│  ● Feishu (feishu.cn) - China # 选择国内
│  ○ Lark (larksuite.com) - International
◆  Group chat policy
│  ○ Allowlist - only respond in specific groups # 允许列表 需要配置
│  ● Open - respond in all groups (requires mention) # 这里全部放开就行了
│  ○ Disabled - don't respond in groups
◆  Select a channel
│  ○ Telegram (Bot API)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ Feishu/Lark (飞书)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ LINE (Messaging API)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Tlon (Urbit)
│  ● Finished (Done) # 选择完成

完成之后会继续让你选择访问策略

shell
◇  Configure DM access policies now? (default: pairing) #
│  Yes
│
◇  Feishu DM access ─────────────────────────────────────────────────────────────────────────╮
│                                                                                            │
│  Default: pairing (unknown DMs get a pairing code).                                        │
│  Approve: openclaw pairing approve feishu <code>                                           │
│  Allowlist DMs: channels.feishu.dmPolicy="allowlist" + channels.feishu.allowFrom entries.  │
│  Public DMs: channels.feishu.dmPolicy="open" + channels.feishu.allowFrom includes "*".     │
│  Multi-user DMs: set session.dmScope="per-channel-peer" (or "per-account-channel-peer"     │
│  for multi-account channels) to isolate sessions.                                          │
│  Docs: start/pairing                     │
│                                                                                            │
├────────────────────────────────────────────────────────────────────────────────────────────╯
│
◇  Feishu DM policy
│  Open (public inbound DMs) # 公开
│
◇  Add display names for these accounts? (optional)
│  No # 不需要
│
└  Channels updated.

你可以通过 ~/.openclaw/openclaw.json 查看对应的 channel 配置,最后配置如下

json
{
    "channels": {
    "feishu": {
      "enabled": true,
      "appId": "xxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "domain": "feishu",
      "groupPolicy": "open",
      "dmPolicy": "open",
      "allowFrom": [
        "*"
      ]
    }
  }
}

配置完成之后,重启

shell
openclaw gateway restart

重启完成后回到飞书,找到「事件和回调」,选择长连接模式,如下图 飞书事件和回调配置 - OpenClaw 长连接模式 如果配置成功,说明连接已建立。继续下面的配置,添加事件,选择「接收消息」事件 飞书添加接收消息事件 - OpenClaw AI 助手 事件添加完成之后,还需要开通权限,有以下权限全部勾选

权限Scope(范围)Description(说明)
contact:user.base:readonly用户信息获取基础用户信息
im:message消息 全部勾选发送和接收消息

如下图 飞书权限配置 - OpenClaw 用户信息权限

飞书消息权限配置 - OpenClaw AI 机器人

以上步骤全部完成后,即可与机器人对话。但在此之前需要先创建一个版本 飞书应用版本发布 - OpenClaw AI 助手上线

注意:每次修改配置后都需要重新发布版本,建议全部配置完成后再统一发布。

发布完成后,回到飞书客户端,可以看到应用已上线,点击打开应用 飞书应用发布成功 - OpenClaw AI 机器人 向机器人发送 Hello,即可收到 Moltbot 的回复 飞书 OpenClaw AI 助手回复测试成功

OpenClaw 常用命令速查 ​

安装完成后,以下是日常使用中最常用的 OpenClaw 命令:

命令功能
openclaw status查看 OpenClaw 运行状态
openclaw onboard重新进入配置向导
openclaw gateway start启动服务
openclaw gateway stop停止服务
openclaw gateway restart重启服务
openclaw update更新到最新版本
openclaw health健康检查
openclaw doctor诊断问题
openclaw dashboard获取 Web UI 访问链接
openclaw security audit --deep安全审计
openclaw uninstall卸载 OpenClaw

OpenClaw 成本说明与免费模型推荐 ​

OpenClaw 本身完全免费开源,主要成本来自两个方面:

服务器成本:一台最低配置的云服务器即可,月费约 30-50 元。如果使用 阿里云 OpenClaw 一键部署,可以省去环境配置的时间。

AI 模型 API 调用费用:各模型服务商的免费额度和计费模式不同,以下是常见选择:

模型服务商免费额度适合场景
通义千问(Qwen)免费额度充足本教程推荐,入门首选
小米 MiMo有免费试用额度成本敏感用户
KIMI (Moonshot)有免费额度中文理解能力强
GLM 4.7 (Z.AI)有免费额度性价比高
OpenAI GPT付费英文场景最佳
Anthropic Claude付费代码能力最强

对于刚接触 OpenClaw 的用户,建议先用通义千问的免费额度体验,熟练后再根据实际需求选择其他模型。

总结 ​

本篇 OpenClaw 安装教程从环境准备、OpenClaw 部署、飞书机器人对接到权限配置,完整走完了一个最新版 OpenClaw 开源 AI 助手的搭建流程。如果你按照这篇 OpenClaw 飞书教程完成了所有步骤,现在应该已经可以在飞书中和你的 OpenClaw 助手正常对话了。

如果你还想让 OpenClaw 助手做更多事情,可以参考:

OpenClaw 常见问题 FAQ ​

OpenClaw 和 Clawdbot、Moltbot 是什么关系? ​

OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot,后因商标问题更名为 Moltbot,最终在 2025 年 1 月正式定名为 OpenClaw。三者是同一个项目的不同阶段命名。

OpenClaw 支持哪些 AI 模型? ​

OpenClaw 支持多种 AI 模型服务商,包括 Anthropic Claude、OpenAI GPT、通义千问(Qwen)、KIMI、小米 MiMo 等。本教程使用通义千问是因为其免费额度充足,适合入门学习。

为什么安装时提示 npm install failed? ​

这通常是服务器内存不足导致的。新版本脚本对内存要求较高,2G 内存可能会出现 OOM(内存溢出)。建议配置 swap 交换空间,将硬盘空间作为虚拟内存使用。

OpenClaw 可以在 Windows 或 macOS 上运行吗? ​

可以。OpenClaw 支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例,其他系统的安装方式可参考官方文档。

飞书机器人配置后无法收到消息怎么办? ​

请检查以下几点:

  1. 确认飞书通道已正确安装(新版 OpenClaw 已内置飞书支持,安装时选择 Feishu/Lark 即可)
  2. 检查 App ID 和 App Secret 配置是否正确
  3. 确认已开通「接收消息」事件权限
  4. 检查长连接模式是否配置成功
  5. 确保应用版本已发布
  6. 使用 openclaw gateway restart 重启服务后再试

OpenClaw 数据安全吗? ​

OpenClaw 运行在你自己的服务器上,所有数据都在本地存储,不会上传到第三方云端。但由于它具有系统级权限,建议在独立的服务器上部署,避免在生产环境或重要数据的机器上运行。

除了飞书,OpenClaw 还支持哪些平台? ​

OpenClaw 支持多个聊天平台,包括 WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每个平台需要安装对应的插件。

OpenClaw 可以做什么? ​

OpenClaw 不只是一个聊天机器人,它能真正在你的服务器上执行操作。以下是一些典型使用场景:

  • 文件整理:“帮我把上周下载的文件按类型分类”,它会直接操作文件系统完成分类
  • 网页摘要:发一个 URL 给它,它能自动打开网页、提取内容并生成摘要
  • 代码编写:“写一个 Python 脚本批量重命名文件”,它能写完代码还能直接在服务器上运行
  • 数据查询:连接本地数据库查询数据,并把结果发回飞书
  • 日程管理:定时提醒、晴间简报、邮件自动回复
  • 系统运维:执行 Shell 命令、监控服务器状态、自动化脚本

简单说,OpenClaw 是一个 7×24 小时在线的 AI 助手,你睡觉时它还能继续干活。

如何更新 OpenClaw 到最新版本? ​

使用以下命令更新:

shell
openclaw update

OpenClaw 命令和 clawdbot 命令有什么区别? ​

OpenClaw 更名后,官方推荐使用 openclaw 命令,但为了兼容性,clawdbot 命令仍然可用。两者功能完全相同,建议新用户直接使用 openclaw 命令。

提示 openclaw 命令找不到怎么办? ​

这通常是环境变量未加载导致的。尝试以下步骤:

  1. 关闭当前终端窗口,重新打开
  2. 执行 source ~/.bashrc 重新加载环境变量
  3. 如果还不行,执行 openclaw doctor 检查问题
  4. 实在无法解决,尝试重启服务器

OpenClaw 安装卡住不动怎么办? ​

  1. 按 Ctrl + C 中断当前操作
  2. 执行 openclaw doctor 检查问题
  3. 如提示网络问题,检查服务器网络是否能访问 GitHub 和 npm
  4. 尝试重新运行 openclaw onboard

端口 18789 被占用怎么办? ​

使用其他端口启动服务:

shell
openclaw gateway --port 18790

如何配置 swap 解决内存不足? ​

如果服务器内存不足 2GB,可以配置 swap 交换空间:

shell
# 创建 2G 的 swap 文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 设置开机自动启用
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
本作品采用《CC 协议》,转载必须注明作者和本文链接