
大家好,我是墨香异境,AI工具ClawBot(现已改名OpenClaw)风靡全球,最近没有发文章,一直通过官网和其他人的文章进行学习和研究,但看的大部分文章的安装过程非常简单基本上一下子就能成功,但我实际安装发现其实并不容易,尤其是配置。今天结合实际安装测试,整理一份详细的安装和配置教程,并集成飞书进行对话。
OpenClaw是什么?它是一个开源的AI助手,能运行在你的电脑或服务器上,支持Claude、GPT、Gemini等模型。通过Telegram、WhatsApp、Discord等聊天App,你可以随时指挥它处理任务,比如查天气、写代码、管理日程,甚至自动化交易!福利:马上春节准备了微信红包封面,文末可以领取,数量有限先到先得!一、使用前必须了解的规则首先最重要,安全,安全,安全!!因为OpenClaw需要的权限非常大,不建议在自己常用的电脑上进行部署,最好在云服务器或者不常用的电脑上部署,最大程度的降低安全风险。最近听到了两个词:“提示词注入”、“钓鱼贴”,都是安全风险。

二、安装因所需权限大存在安全风险不在本地安装,之前购买过一台腾讯云服务器,直接在上边进行安装。可以自行去各大云厂商上购买,现在也有很多厂商支持一键部署的方式,购买服务器时选择OpenClaw镜像即可,我还是采用自行安装的方式,学习嘛自己得动手试试。进入官网:https://openclaw.ai/支持多种安装形式:
- 一键脚本安装方式:这种方式可以自动处理nodejs和git(自动处理一切)
curl-fsSL https://openclaw.ai/install.sh | bash
- npm方式安装:使用npm全局安装(本文的安装方式)
npm install -gopenclaw@latest

前期准备:
- Node.js 22+(官网下载安装)

完成安装后接下来开始配置,使用新手引导并安装服务。
openclaw onboard--install-daemon
1.安全提示会有安全提醒,中文意思如下,这里选择yes继续

中文释义:
安全警告 — 请务必阅读OpenClaw 是一个兴趣项目,目前仍处于测试阶段,存在不完善之处。若启用相关工具,该机器人可读取文件并执行操作。恶意提示可能诱骗它执行不安全的操作。若你不熟悉基础的安全防护和访问控制知识,请勿运行 OpenClaw。在启用工具或将其暴露于互联网之前,请寻求有经验的人员协助。推荐的安全基准配置:配对验证/白名单+@提及触发机制沙箱环境+最小权限工具集避免机密信息存放在机器人可访问的文件系统中对于启用工具或接收不可信消息的机器人,请使用功能最强的可用模型请定期执行以下命令:openclaw security audit--deep(深度安全审计)openclaw security audit--fix(安全审计并自动修复)必读文档:https://docs.openclaw.ai/gateway/security
2.快速开始选择后会默认端口号等配置。

3.配置模型这里选择Qwen模型,量大管饱。


复制地址,在本地浏览器中进行认证,认证完成后选择模型,默认即可。

4.配置聊天渠道这里选择飞书,需要提前在飞书中配置好机器人。(这里也可以跳过,后面再配置)

4.1 飞书配置进入飞书开发者平台进行创建,首先要创建应用,具体创建过程可以参考文案党狂喜!n8n改写热点文案,自动同步飞书不加班,这里直接从创建机器人开始4.2 机器人创建及配置选择添加应用能力菜单,进入后选择添加机器人。

添加后在左侧菜单会出现机器人的应用能力

开通必须的权限,在权限管理页面中按照提示添加权限


也可以选择导入权限配置,官网的内容复制导入开通。
{"scopes":{ "tenant":[ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "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"]}}
设置事件与回调,配置前一定要确保在openclaw中添加了渠道,参考第三节,第2部分内容。重要提醒:在配置事件订阅前,请务必确保已完成以下步骤:
- 运行 openclaw channels add 添加了 Feishu 渠道
- 网关处于启动状态(即openclaw gateway)


4.3 安装飞书插件选择飞书后会自动安装模块(若安装失败,等后续再次安装插件,可继续进行下一步)

5.配置Skills选择安装Skills,会让选择安装方式,选择npm方式,列出很多skills,按需安装通过空格键进行选择。



这里选择了三个:model-usage、nano-pdf、summarize、obsidian,其他的也可以通过对话形式安装。也可能会安装出错,核心问题是依赖环境缺失导致,这里先跳过安装

有一些配置API_KEY的选项,都没有可以选择全部No。

至此就完成了完成步骤。6.手动添加插件安装飞书插件(若飞书安装插件失败则手动安装)
openclawplugins install@openclaw/feishu
7.可能遇到的坑飞书存在多个的情况在~/.openclaw/extensions在~/lib/node_modules/openclaw/extensions需要删除一个才可以,查看openclaw.json文件中飞书引用的位置(需保留),另外一个删除。

三、详细配置1.路由启动
openclaw gateway--port18789--verbose
2.配置飞书在OpenClaw中添加飞书渠道(若开始已添加则无需此步骤)
openclaw channelsadd

Feishu account ID :这里随便填写一个即可。主要的是APPID和appSecret


配置完成后选择最后一个finished即可完成。3.配置配对码
在飞书中找到自己的应用发起对话,第一次对话会发送一个配对码

在服务器端使用以下命令即可完成配对,之后就可以放心沟通啦
openclaw pairing approve feishu
四、其他配置1.联网搜索1.1 Brave Search第一次运行会让配置Brave Search API密钥,注册获取apikey,选择免费的套餐即可(注意需要填写信用卡信息),足够用。1秒1次请求,每月2000次请求。


通过命令引导:
openclaw configure--sectionweb
修改配置文件:
{ tools: { web: { search: { provider:"brave", apiKey:"BRAVE_API_KEY_HERE", maxResults:5, timeoutSeconds:30, }, }, },}
1.2 Perplexity searchPerplexity Sonar 模型具有内置的网络搜索功能,并返回带有引用的 AI 综合答案。可以通过 OpenRouter使用它们(无需信用卡 – 支持加密货币/预付费)。
{ tools: { web: { search: { enabled: true, provider:"perplexity", perplexity: { // API 密钥(如果设置了 OPENROUTER_API_KEY 或 PERPLEXITY_API_KEY 则可选) apiKey:"sk-or-v1-...", // 基础 URL(如果省略则根据密钥感知默认值) baseUrl:"https://openrouter.ai/api/v1", // 模型(默认为 perplexity/sonar-pro) model:"perplexity/sonar-pro", }, }, }, },}
可用的 Perplexity 模型
| 模型 | 描述 | 最适合 |
| perplexity/sonar | 带网络搜索的快速问答 | 快速查询 |
perplexity/sonar-pro(默认) |
带网络搜索的多步推理 | 复杂问题 |
| perplexity/sonar-reasoning-pro | 思维链分析 | 深度研究 |
2. 定期检查
openclaw security audit--deep(深度安全审计) openclaw security audit--fix(安全审计并自动修复)
