虚拟机安装龙虾 openclaw 教程

OpenClaw快速上手指南：安装、配置与使用教程

OpenClaw是最近比较火爆🔥的开源AI助手，短短几个月就已登顶GitHub热门榜，目前star⭐️达到24.3w。

OpenClaw爆火的核心，在于它用本地执行 + 多渠道统一 + 模型无关 + 安全可控 + 插件生态五大技术，解决了 AI 助手 “只会聊、不会做、记不住、不安全、难扩展” 的行业痛点。

本文将基于 VMware + Ubuntu 24.04 环境，从零开始完成 OpenClaw 的安装、配置，并实现与飞书机器人的打通。

OpenClaw安装配置
安装
在安装openclaw之前，先给Ubuntu系统换源，以提高安装速度，这里使用小鱼的一键安装指令：

选5

wget http://fishros.com/install -O fishros && . fishros
有nodejs环境的可以轻易安装openclaw，另外openclaw也提供了一键安装脚本，它会自动安装环境所需要的nodejs、make、gcc、cmake和python3：

1. 安装 OpenClaw (官方脚本)

使用官方提供的一键安装脚本进行部署：

curl -fsSL https://molt.bot/install.sh | bash

2. 安装完毕会让你选择：

这个选Yes，回车

◆  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  ● Yes / ○ No

选QuickStart，回车

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

选择大语言模型

◆  Model/auth provider
│  ○ OpenAI
│  ○ Anthropic
│  ○ Chutes
│  ○ vLLM
│  ○ MiniMax (M2.5 (recommended))
│  ○ Moonshot AI (Kimi K2.5)
│  ○ Google
│  ○ xAI (Grok)
│  ○ Mistral AI
│  ○ Volcano Engine
│  ○ BytePlus

我选择的 custom provider
用的是nvidia免费API

“baseUrl”: “https://integrate.api.nvidia.com/v1”,
“apiKey”: “${NVIDIA_API_KEY}”,
“api”: “openai-completions”,
“models”: [
{ “id”: “moonshotai/kimi-k2.5”, “name”: “Kimi K2.5”},
{ “id”: “minimaxai/minimax-m2.1”, “name”: “Minimax M2.1”}
]

选 Skip for now 空格，回车

◆  Search provider
....
│  ○ Grok 
│  ○ Kimi 
│  ● Skip for now

选Skip for now (You can add channels later via: openclaw channels add)，跳过移动端接入，回车

◆  Select channel (QuickStart) │  … 
│  ○ 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) 
│  ○ Synology Chat (Webhook) 
│  ○ Tlon (Urbit) 
│  ● Skip for now (You can add channels later via openclaw channels  │  add)

不安装skills，后续有需要再装，选No，回车

◆  Configure skills now? (recommended)
│  ○ Yes / ● No

跳过hook，选Skip for now，回车

◆  Enable hooks?
│  ◼ Skip for now
│  ◻ 🚀 boot-md
│  ◻ 📎 bootstrap-extra-files
│  ◻ 📝 command-logger
│  ◻ 💾 session-memory

后续如果想启用，可通过： 列出所有hook：openclaw hooks list 启用hook：openclaw hooks enable session-memory 检查hook状态：openclaw hooks check

选Hatch in TUI (recommended)测试是否可以与大语言模型对话，回车

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

至此，openclaw就已经安装好了

添加飞书，建议先看看文档 https://zhuanlan.zhihu.com/p/2011924690973767058

openclaw channels add
选择Yes，回车

◆  Configure chat channels now?
│  ● Yes / ○ No

选择Feishu/Lark (飞书) (needs app creds)，回车

◆  Select a channel
│  ○ Telegram (Bot API)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ IRC (Server + Nick)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ● Feishu/Lark (飞书) (needs app creds)
│  ○ 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)
│  ...

输入App ID回车
输入App Secret 回车

选择国内，回车

◆  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

查看openclaw gateway状态
openclaw gateway status

重启openclaw gateway
openclaw gateway restart

重新配置/重置所有配置
openclaw onboard

模型列表
openclaw models list

检查 openclaw 是否安装成功

which openclaw

查看版本

openclaw --version

飞书权限管理导入json

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:bot.menu:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:message"
    ]
  }
}

使用配对码在openclaw进行与飞书配对

openclaw pairing approve feishu

Nvidia api 接入

"models": {
    "mode": "merge",
    "providers": {
      "nvidia": {
        "baseUrl": "https://integrate.api.nvidia.com/v1",
        "apiKey": "${NVIDIA_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "moonshotai/kimi-k2.5", "name": "Kimi K2.5" ,
            "reasoning": true,
            "input": [
              "text",
              "image"
            ]
          },
          { "id": "minimaxai/minimax-m2.1", "name": "Minimax M2.1" ,
            "reasoning": true,
            "input": [
              "text",
              "image"
            ]
          }
        ]
      }
    }
  }

开启局域网访问
vim ~/.openclaw/openclaw.json

修改

"gateway": {
    "bind": "lan",
    "controlUi": {
          "dangerouslyAllowHostHeaderOriginFallback": true,
          "allowInsecureAuth": true,
          "dangerouslyDisableDeviceAuth": true,
              "allowedOrigins": [
                "http://具体局域网IP:18789", // 这个地方要加具体局域网IP
                "http://localhost:18789",
                "http://127.0.0.1:18789"
              ]
    },
}

保存，使用 openclaw gateway restart 重启openclaw gateway

浏览器扩展安装
如需在 OpenClaw 中调用浏览器功能，请在终端执行扩展安装命令：

openclaw browser extension install
7.1 验证浏览器扩展

检查浏览器扩展状态

openclaw browser status

OpenClaw 安装失败
问题：官方脚本安装失败

解决方案：

检查系统要求：

node --version # 需要 Node.js ≥ 22
清理后重试：

npm uninstall -g openclaw
npm cache clean --force
curl -fsSL https://molt.bot/install.sh | bash
查看错误日志：

tail -f ~/.openclaw/logs/gateway.log

安装clawpanel

curl -fsSL http://39.102.53.188:16198/clawpanel/scripts/install.sh -o install.sh && sudo bash install.sh

Ubuntu 系统下 OpenClaw + 浏览器自动化配置核心教程

https://cloud.tencent.com/developer/article/2635167

1. 正确配置 Chrome 源

# 1. 下载并安装 Chrome GPG 密钥（新规范）
wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/google-chrome-keyring.gpg

# 2. 创建 Chrome 源列表文件
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/google-chrome-keyring.gpg] https://dl.google.com/linux/chrome/deb/ stable main" | sudo tee /etc/apt/sources.list.d/google-chrome.list

# 3. 刷新包索引
sudo apt update

2. 安装 Chrome 及中文显示依赖

# 安装 Chrome 稳定版
sudo apt install -y google-chrome-stable

# 安装中文显示依赖（避免网页乱码）
sudo apt install -y fonts-liberation xdg-utils fonts-noto-cjk

# 验证 Chrome 安装路径（关键，后续配置要用）
which google-chrome  # 正确输出：/usr/bin/google-chrome

二、OpenClaw 浏览器核心配置

1. 基础配置（解决权限 / 沙箱问题）

# 1. 创建 OpenClaw 浏览器配置目录（避免目录缺失错误）
mkdir -p /root/.config/openclaw/browser

# 2. 设置目录权限（解决 Permission denied 问题）
sudo chown -R root:root /root/.config/openclaw/browser
sudo chmod -R 755 /root/.config/openclaw/browser

# 3. 核心配置（root 用户必须开启 noSandbox）
openclaw config set browser.defaultProfile "openclaw"  # 设置默认配置文件
openclaw config set browser.headless true             # 无头模式（服务器无桌面必开）
openclaw config set browser.noSandbox true            # 关闭沙箱（root 运行 Chrome 必开）
openclaw config set browser.executablePath "/usr/bin/google-chrome"  # 指向正确的 Chrome 路径

2. 修复库预加载错误（解决 libion.so 警告）

# 编辑预加载配置文件，删除错误的 libion.so 行
sudo nano /etc/ld.so.preload

# 操作：删除所有包含 "/lib/libion.so" 的行 → 按 Ctrl+O 保存 → Ctrl+X 退出

# 刷新动态链接器缓存
sudo ldconfig

3. 启动并验证浏览器

# 1. 清理残留进程（避免端口占用/多实例错误）
pkill -f "chrome"
pkill -f "google-chrome"
sudo lsof -i :18800 | awk 'NR>1 {print $2}' | xargs -r sudo kill -9

# 2. 重启 OpenClaw 网关
openclaw gateway restart

# 3. 启动浏览器并检查状态
openclaw browser start
openclaw browser status  # 输出 "running: true" 即为成功

三、功能验证

# 示例：打开百度并截图
openclaw browser exec --url "https://www.baidu.com" --screenshot

若命令执行成功并生成截图文件，说明配置全部生效；
若失败，检查：openclaw browser status 是否为 running: true，Chrome 路径及权限配置是否正确。