在Ubuntu上部署OpenClaw

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

系统
配置

脚本自动完成 Node.js 检测/安装、CLI 全局安装、启动引导向导，是最省心的方式。

标准安装

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

适合已安装 Node.js 22+ 且希望自主管理安装流程的用户。

更新包并检查Node.js版本
在终端输入以下命令，确认 Node 版本在 22 或以上：

npm全局安装OpenClaw

为避免sudo权限问题，建议先配置npm全局目录到用户路径：

然后安装 OpenClaw：

3.sharp构建错误处理（Ubuntu常见问题）

sharp是图像处理依赖，若 Ubuntu 已全局安装 libvips（如通过 sudo apt install libvips-dev），可能导致构建失败。解决方法：

方案 1：强制使用预编译二进制（推荐）

方案 2：安装构建工具后重试

若提示 sharp: Please add node-gyp to your dependencies：

需手动克隆仓库、构建依赖，适合想修改代码或运行最新开发版的用户。

前置准备：安装基础依赖

1.克隆仓库并构建

2. 链接CLI（全局可用）

若不链接，可在仓库目录内通过 pnpm openclaw … 运行命令（如 pnpm openclaw onboard）。

3. 运行引导

- 更新OpenClaw

2.检查配置健康度

3.其它命令

命令作用说明openclaw onboard启动配置向导交互配置，如果遇到问题可以重新执行引导openclaw gateway install安装服务同时启动，开机自启openclaw gateway start启动服务需要先安装installopenclaw gateway stop停止服务会卸载服务openclaw gateway status查看状态检查服务是否运行openclaw logs –follow查看执行过程中的日志

或者，如果已经运行过向导，想重新配置，可以使用

接下来，跟着向导一步步操作：

1.风险确认：你会看到一句提示 I understand this is powerful and inherently risky. Continue?，直接输入 Yes 并回车。这是因为 OpenClaw 可以操作你的电脑，需要你明确授权。

2.选择模式：选择 QuickStart，它将自动帮你配置好大部分默认设置，对新手最友好。Manual，手动配置每项参数，适合高级用户。

3.配置 AI 模型：OpenClaw 需要一个“聪明的大脑”（大语言模型）来理解你的指令。这里你可以：

Model/auth provider：选择你希望使用的模型供应商。如果你还没有 API Key，可以先选择 “Skip for now” 跳过，后续在网页界面配置也一样方便。
Filter models by provider：同样，可以先选择 “All providers” 或直接“Skip for now” 。

国产模型

平台选项阿里 Qwen Qwen百度千帆 QianfanKimi Moonshot AI字节火山 Volcano Engine智谱 Z.AI

本地模型

如果你本地跑Ollama或vLLM，选VLLM。

API Key
如果有API Key

Telegram Bot Token：选择 Enter Telegram bot token 并粘贴 BotFather 生成的 token
Perplexity Search：可跳过（Skip for now）或输入 API Key
其他 API Key（Notion、Whisper、Nano Banana 等）建议跳过，安装核心功能即可

选项含义适合谁 Paste API key now现在直接粘贴 API Key，保存到 OpenClaw 配置文件 个人电脑用户（推荐） Use external secret provider使用外部密钥管理器（例如环境变量、Vault等）企业 / 服务器

即使没有API Key，也可以先完成向导，选择“Skip for now” 。

4.配置通信渠道：问你想通过什么软件和它聊天，比如 Telegram、飞书。

选项说明适合谁 Telegram (Bot API)官方推荐新手渠道，通过 Telegram Bot 使用 推荐新手/个人用户WhatsApp / Discord / Slack / Signal / iMessage / LINE / Feishu 等企业或高级用户使用，需要 API Key 或复杂配置高级用户或团队 Skip for now跳过，不设置任何渠道测试或只想先用本地命令行 AI

第一次尝试，建议选择 “Skip for now” 跳过，我们先使用它自带的网页版界面，以后可通过命令openclaw configure channel添加。

5.搜索提供商（Search provider）：

这一步是在选择搜索提供商（Search provider），也就是 OpenClaw 用来获取网页搜索或信息检索结果的来源。

选项说明适合谁 Perplexity Search提供结构化搜索结果，可以过滤域名、语言、更新鲜度新手/个人用户推荐，功能全面Brave Search纯网页搜索，类似浏览器搜索普通搜索需求Gemini (Google Search) / Grok / Kimi高级搜索或 AI 驱动搜索高级用户 / 特定模型 Skip for now不启用搜索功能只用模型生成回答，不检索网页

新手/个人用户推荐选择Perplexity Search，如果你暂时不想启用搜索功能可以选择Skip for now。

6.配置技能（Skills）
是否现在添加特定技能？安装默认技能（推荐选择 Yes），安装技能依赖（Install missing skill dependencies）。同样，先选 “No” 跳过。

说明：

skills说明是否推荐安装使用 1Password CLI 安全读取密码、API 密钥等敏感信息。适合企业用户保护凭证。✅ 推荐（高安全需求）监控博客更新并自动通知（如 RSS 订阅）。适合内容创作者。❌ 一般不需 BluOS CLI 工具，用于发现和管理 OpenClaw 技能。它是技能市场的核心命令行接口。✅ 必须安装（建议勾选）从摄像头拍摄照片或视频流（如监控）。❌ 除非你有摄像头需求通过 ClawHub 搜索、安装和管理公开技能包。类似 npm 或 pip。✅ 强烈推荐（获取更多技能）与 Eight (AI Agent 平台) 集成，可能用于调度或任务分发。❌ 一般不用支持 Google Gemini 模型（如 gemini-1.5-pro），让 OpenClaw 能调用 Google AI。✅ 如果你用 Google 生态在 GIF 图像中搜索文本或关键词（基于 OCR）。❌ 小众用途与 GitHub API 交互：创建 Issue、PR、查看仓库、提交代码等。✅ 推荐（开发者必备）GOG 游戏平台集成（可能用于自动化游戏下载/更新）。❌ 不相关获取 Google Places 数据（地点、评分、评论等）。❌ 除非做地图应用可能是一个本地文件同步或备份工具（名称来自“喜马拉雅”）。❌ 未知用途Minecraft 服务器端口转发或管理工具？❌ 不常用名称搞笑，可能是实验性技能（如“香蕉”主题的自动化）。❌ 可忽略处理 PDF 文档（提取文本、合并、转换等）。✅ 推荐（文档处理）与 Obsidian 笔记软件集成，实现笔记查询、标签管理、自动生成大纲等。✅ 推荐（知识工作者）使用 OpenAI Whisper 模型进行语音转文字（STT）。✅ 推荐（语音输入场景）控制 Philips Hue 灯泡（智能家居）。❌ 除非你有智能灯连接 Oracle 数据库（SQL 查询、数据导出）。✅ 数据库管理员可用订单管理系统 CLI（可能是电商或内部系统集成）。❌ 业务定制可能是 “Smart Assistant Gateway” 或某个私有项目缩写。❌ 未知歌曲识别或音乐推荐工具？❌ 小众控制 Sonos 音响系统（播放音乐、调整音量）。❌ 智能家居用户自动生成文章摘要（支持文本、网页、PDF）。✅ 推荐（高效阅读）提取视频中的帧图像（用于分析或截图）。✅ 视频处理者可用WhatsApp 命令行客户端（发送消息、接收通知）。✅ 如果你用 WhatsApp 工作

如果不安装这些依赖，相关技能功能无法使用，但基本模型聊天仍然可以用

选项含义建议 Install missing skill dependencies自动安装所有缺少的依赖 推荐新手/个人用户，确保技能可以直接用 Skip for now不安装依赖，之后可以手动安装如果只想先测试 AI 聊天功能，可以跳过

skills如何确认是否安装成功,要以通过以下命令列出所有已安装的技能

7.配置钩子（Hooks）：这是高级功能，用于在启动时加载文档、记录日志等。

在OpenClaw中，Hook（钩子）是一种轻量级的自动化脚本，会在以下事件发生时触发：

启动时
每次命令执行前/后
会话开始/结束
文件加载等

它们可以用来：

记录日志
加载额外文件
自动保存上下文
执行预设命令

Hook 名称作用说明是否推荐启用在启动时自动加载 Markdown 文件作为初始知识库（如 README.md、FAQ.md） → 你可以把常用指令、规则写进文件，让 AI 知道你的偏好✅ 推荐（适合个性化助手）启动时自动加载指定目录下的额外文件（如 JSON 配置、CSV 数据表、API 文档） → 帮助 AI 快速了解你的项目结构✅ 推荐（如果你有固定数据源）记录所有执行过的命令到日志文件中 → 便于调试、审计和复盘 AI 的行为✅ 强烈推荐（开发者必开）为每次会话保存记忆（如上下文对话、变量状态） → 让 AI 能记住“我们之前说过了什么”，避免重复提问✅ 强烈推荐（提升交互体验）

说明：

这些 Hook 是可选的，不启用也不会影响基本功能。
如果你不确定，可以先选，之后通过命令行手动添加：

直接选择 “Skip for now” 并回车。

8.OpenClaw在启动AI助手时的方式：

直接在终端中运行，无需浏览器
实时显示日志、状态、命令执行过程
快速调试技能、查看错误信息
支持键盘快捷键（如 Ctrl+C 停止）

适合人群：

开发者
运维人员
喜欢命令行操作的用户

图形化操作：拖拽技能、配置参数更直观
支持多设备访问（手机/平板）
可视化监控：会话历史、性能图表等
更适合非技术用户

适合人群：

非程序员
想快速上手的普通用户
需要远程访问的人

Do this later：跳过，稍微再设置

稍等片刻，看到完成界面，向导就成功结束了！

验证安装

运行以下命令，如果能正常显示版本号或帮助信息，则表示安装成功。

常见问题

问题解决方法不是命令确认在 PowerShell 中；Node.js 安装并在 PATH模型无法响应检查状态，必要时 Telegram 不回复检查 Bot Token；确保后台服务运行搜索无返回检查 Perplexity API Key 或网络连接

安装skill时失败提示Homebrew is not installed

安装Homebrew

其他高级技能、API Key、Hooks 可以跳过，后续再配置

1.获取API Key
在AI模型平台进行注册，获取api key（具体省略）

2.运行配置向导(openclaw onboard)并选择关键选项

Model/auth provider 选择你的ai

Enter Moonshot API Key粘贴你刚才复制的API Key

按你之前习惯选，或者全跳过

1.登录并进入开发者后台

访问飞书开放平台并登录你的账号。
进入到「管理后台」
在飞书管理后台中选择「工作台」-> 「应用管理」 -> 「创建应用」

2.创建企业自建应用

点击「创建应用」->「企业自建应用」。

填写应用名称和描述，然后点击「创建」。

3.添加机器人能力

创建成功后，在应用详情页找到「添加能力」卡片，点击「机器人」。

4.配置权限

点击左侧菜单的「权限管理」。
在搜索框中输入 im:，然后将出现的所有权限全部勾选，点击「批量开通」。

（重要）再次搜索「通讯录」或「手机号」，找到「通过手机号或邮箱获取用户ID信息」这个权限，也点击开通。这能让机器人知道是谁在和它说话。

5.发布第一个版本

点击左侧菜单的「版本管理与发布」。
点击「创建版本」，填写版本号（如 1.0.0）和更新说明，然后点击「保存」。
保存后，点击「确认发布」。

发布需要管理员审核，通常很快，也可以自己审核自己。

1.进入配置面板

回到VS Code终端，输入以下命令：

选择local（本地配置）

2.配置通信渠道

选择Channels -> Link 添加新渠道。
选择feishu

3.安装渠道插件

系统检测到缺少飞书插件，选择Install进行安装。安装完成后，按Enter键继续。

4.填写飞书应用凭证

不要关闭终端！现在回到飞书开发者后台，找到你的应用。
点击左侧菜单的「凭证与基础信息」。
分别复制 App ID 和 App Secret 到终端中粘贴。

5.完成后续配置

Endpoint type：选择 im（实时通讯）。
Environment：根据你的飞书版本选择国内或国际。
Allow group chat：是否允许群聊使用，选择 open。
看到 finished 选项，选择它完成渠道配置。
之后会询问是否配置私聊访问策略，新手可以先选择 No 跳过。

6.保存并退出

一直按 Esc 或选择 Finish 退出配置面板。

1.确保网关已启动

在终端中，确保 OpenClaw 的网关服务正在运行。如果没有，请启动它：

2.设置飞书事件订阅方式

回到飞书开发者后台，点击左侧菜单的「事件与回调」。
在「订阅方式」卡片中，点击「修改」，将方式改为「长连接」，点击「确认」。OpenClaw 会通过长连接与飞书通信，无需公网地址。

3.添加消息接收事件

在「事件与回调」页面下方，点击「添加事件」。
搜索并选择接收消息事件（im.message.receive_v1），然后点击「确认添加」。

4.再次发布版本

权限和事件都配置好了，需要再次发布一个新版本才能生效。回到「版本管理与发布」，创建一个新版本（如 1.0.1）并发布。

5.测试连接

现在，去飞书客户端，找到你刚刚创建的这个机器人，给它发送一条消息，比如“hello”。如果一切顺利，你应该能收到 OpenClaw 的回复！

以上，已经成功地将OpenClaw接入飞书！

则在命令行执行：

从微信热点、抖音热点、百度热点、知乎热点、小红书热点、头条热点热点、微博热点、B站热点中，选出最高的10条推给我

2.一句话查bug进展，在手机上也可以做研发管理，让它总结项目bug遗留情况，直接做出可视化报表

3.解决token不够用问题，让openclaw自己研究有哪些免费模型，让它自己配置上。英伟达的模型库也用上了，180多种随便用。当然也有做memory的优化，token压缩等

本案例将配置 OpenClaw，实现通过自然语言查询数据库、监控性能、排查故障等功能。

1. 配置云数据库与Skill

前提：准备一台云数据库MySQL实例，并获取其Access Key、Secret Key及实例地域信息。
安装 Skill：将 Skill 克隆到 OpenClaw 的技能目录（如）。

2. 配置密钥与权限

在 OpenClaw 的环境配置文件（）中添加火山引擎密钥：

3. 重启并验证

重启 OpenClaw 服务后，在 Web 控制台的 Skill 管理中确认已加载。
测试指令示例：
- “列出所有 MySQL 实例，并按存储使用率从高到低排序。”
- “查询表最近7天的新增用户数。”
- “检查实例是否存在慢查询，并给出优化建议。”

本案例将创建一个定时任务，让OpenClaw自动为您准备会议资料。

1. 编写核心提示词

在 Web 控制台中，使用以下提示词（可自定义）：

每天北京时间早上7点，请在 Chrome 浏览器中打开 calendar.google.com，同步我的会议安排。为每个会议生成一份准备文档，包含：

与会者背景研究（职业身份、负责业务、过往合作经历）；

会议主题相关背景信息（项目进度、相关文档摘要、待讨论问题建议）；

核心议题梳理与发言要点建议。
将文档保存至目录，命名格式为“日期-会议名称.md”。最后，为每个会议设置会前15分钟提醒，通过系统通知发送。

2. 创建定时任务 (Cron Job)

通过命令行添加每日定时任务：

表示每天 7:00 执行。
您可以使用查看任务，手动测试。

OpenClaw 的强项是能“自己写代码、封装技能”。当遇到新需求时，您可以引导它创建新的Skill。

1. 提出需求

在控制台中下达指令，要求AI创建一个新技能。

我想让 OpenClaw 每天早上8点自动抓取Hacker News首页Top10文章，总结要点，并写入。请帮我：

设计一个 Skill，包括工具函数（如抓取网页、写文件）和主逻辑。

生成完整的 Skill 代码，遵循 OpenClaw 的 Skill 规范。

将代码写入目录下的和文件。

告诉我如何安装和测试这个 Skill。

2. 审查与安装

审查代码：AI 生成代码后，务必人工审查，重点关注文件操作、网络请求和命令执行等敏感权限。
安装测试：确认代码无误后，重启OpenClaw服务，并在Skill管理中检查新技能是否已加载。然后发送测试指令，如“立即运行一次 Hacker News 技能”。

3. 创建定时任务

为这个新的 Skill 也创建一个定时任务，实现每日自动执行。

推荐两个免费测试用的大模型

智谱（Z.AI） GLM-4.7-Flash
优势：代码能力强、推理快，适合写代码、技术问答、文档总结
https://bigmodel.cn/
讯飞星火 Spark Lite (需实名注册,Token无限)
优势：语音 + 文字双能，适合语音转文字、口语对话、翻译
https://www.xfyun.cn/

因为是免费的，并发数受限制，只能测试用，生产环境还是用收费的吧