Openclaw本地部署

2026-03-03

openclaw本地部署 Qwen+飞书

qwen： https://chat.qwen.ai/authorize?user_code=XFRZXMHK&client=qwen-code

macos:

下载openclaw安装脚本 : curl -fsSL https://openclaw.ai/install.sh | bash

image

注册qwen： liulei0128 15797899690@163.com 15797899690lxl

image

安装飞书插件

npm install -g @openclaw/feishu –registry=https://registry.npmmirror.com

设置飞书App ID

openclaw config set channels.feishu.appId “XXXX”

设置飞书App Secret

openclaw config set channels.feishu.appSecret “XXXX”

启用飞书渠道

openclaw config set channels.feishu.enabled true

输入飞书appid。
image

1.打开飞书开放平台（https://open.feishu.cn/app），用飞书账号登录。
2.点击创建企业自建应用，填写任意应用名称，选择应用类型为机器人，点击创建。
3.进入应用详情页，点击凭证与基础信息，复制App ID和App Secret。
4.在飞书应用详情页，点击权限管理，开启以下核心权限（缺一不可）：
▪im:message（消息发送/接收）
▪im:chat（群聊访问）
▪im:message.p2p_msg:readonly（单聊消息读取）
▪application:bot.menu:write（机器人菜单编辑）
▪im:message:send_as_bot（以机器人身份发送消息）
▪contact:contact.base:readonly（获取通讯录基本信息）
▪contact:user.id:readonly（通过手机号或邮箱获取用户ID）

image

1.第4步：配置核心Skills
Skills是AI的工具箱，新手不用装太多，可以先跳过（Skip for now），后续需要再添加，常用Skills解读如下：

技能名称 功能用途
1password 集成1Password密码管理器，可CLI操作密码库、获取/生成密码
blogwatcher 监控博客更新，自动抓取新内容、推送通知或汇总博客信息
blucli 蓝牙设备管理CLI工具，可配对、连接、控制蓝牙设备
camsnap 调用摄像头快速抓拍照片/录制短视频，支持自定义存储路径
clawhub OpenClaw核心hub功能，管理各技能调度、消息分发
eightctl 控制EightSleep智能床垫，调节温度、查看睡眠数据
gemini 集成GoogleGemini大模型，调用其API完成对话、生成内容
gifgrep 搜索GIF动图（支持关键词/标签），可下载、预览或发送
github 集成GitHubAPI，CLI操作仓库、PR/Issue、查看通知、提交代码
gog 管理GOG游戏平台账号，查看库内游戏、下载、启动游戏
goplaces 地理位置相关功能，查询地址、导航信息、周边场所
himalaya 命令行邮件客户端集成，收发邮件、管理邮箱文件夹
mcporter Minecraft服务器/存档管理，备份、迁移、启动/停止服务器
nano-banana-pro 适配NanoPiBananaPro开发板，控制板载硬件、执行系统命令
nano-pdf PDF文件轻量处理，提取文本、合并/拆分PDF、转换格式
obsidian 集成Obsidian笔记软件，CLI创建/编辑笔记、查询知识库
openai-whisper 调用OpenAIWhisper模型，语音转文字（支持多语言、本地/远程）
openhue 控制PhilipsHue智能灯光系统，调节亮度、颜色、场景
oracle 集成Oracle数据库，执行SQL、管理数据库实例、导出数据
ordercli 订单管理CLI工具，创建/查询/跟踪订单（适配电商/本地服务）
sag 语音合成/语音助手功能，将文本转为语音、响应语音指令
songsee 音乐搜索/播放控制，查询歌曲信息、控制音乐播放器
sonoscli 控制Sonos智能音箱，调节音量、切换曲目、设置播放列表
summarize 文本/网页内容摘要，调用AI生成精简总结（支持长文本/链接）
video-frames 视频帧处理，提取指定时间帧为图片、分析视频画面内容
wacli WhatsAppCLI集成，发送消息、查看聊天记录、管理联系人
•第5步：配置环境变量
接下来配置一些环境变量，为了简便操作，一路选择“No”即可，以下是对各环境变量及其用途的解释：

名称 功能 核心用途 补充说明
GOOGLE_PLACES_API_KEY goplaces 用于调用Google Places API，实现：
1.查询地理位置、周边场所（餐厅/加油站/景点）
2.获取地址解析、导航信息、场所评分/营业时间
3.地理编码/逆地理编码（坐标转地址/地址转坐标） 需在GoogleCloud控制台申请，有免费额度，超额后按调用量收费
GEMINI_API_KEY nano-banana-pro 这里是配置错误/关联错误（nano-banana-pro本身是开发板控制），实际是为gemini技能提供密钥：用于调用Google Gemini大模型API，实现AI对话、内容生成、多模态交互 需在GoogleAIStudio申请，免费额度足够个人使用，商用需升级付费
NOTION_API_KEY notion 用于调用Notion（笔记工具）的API，实现：
1.程序化创建/编辑/查询Notion页面/数据库
2.同步数据到Notion、自动化整理笔记
3.读取Notion知识库内容供OpenClaw调用 在Notion Integrations中创建，完全免费（个人/团队）
OPENAI_API_KEY openai-image-gen 用于调用OpenAI的图像生成API，实现：
1.根据文本描述生成图片
2.编辑/扩展已有图片
3.控制图片尺寸、风格、数量 需在OpenAI平台申请，按生成图片的分辨率/数量计费，无免费额度
OPENAI_API_KEY openai-whisper-api 用于调用OpenAI的Whisper语音转文字API，实现：
1.将音频文件/语音流转为文字（支持多语言）
2.识别语音内容、生成字幕
3.音频格式转换+转写 按时长计费（$0.006/分钟），需绑定支付方式
ELEVENLABS_API_KEY sag 用于调用ElevenLabs的语音合成API，实现：
1.将文本转为高自然度的语音（支持多音色/多语言）
2.自定义语音语速、音调、情感
3.生成语音文件或实时播放 有免费额度（10k字符/月），超额后按字符数收费，支持自定义克隆语音
•第6步：配置Hooks
然后继续配置Hooks（钩子），前文介绍过Hook的作用类似于事件回调函数，用于在特定时机触发自定义的动作，以下是各种Hook的简要介绍，为了简便处理，也可以选择先跳过（Skip for now）。

名称 核心功能 典型应用场景
boot-md 启动时自动加载Markdown格式配置/脚本 1.开机自动执行自定义MD格式的初始化指令
2.启动时加载预设的技能配置/环境变量
3.自定义启动欢迎语/状态提示
bootstrap-extra-files 引导过程中加载额外的配置文件/资源 1.加载第三方工具的配置（如自定义CLI工具配置）
2.导入外部脚本、模板文件到OpenClaw环境
3.同步自定义的技能依赖文件
command-logger 记录所有执行的命令及执行结果 1.审计/排查问题：追溯执行过的指令和输出
2.统计常用命令、分析使用习惯
3.生成操作日志，便于复盘/故障定位
session-memory 持久化保存会话内存（上下文/状态） 1.跨会话保留对话上下文（如之前执行的指令等）
2.重启OpenClaw后恢复之前的操作状态
3.多技能间共享会话数据
通过以上一系列的新手引导配置，最终会显示安装完成的提示语：



四、常用命令说明
安装完成后，日常操作全靠命令行搞定，不用记复杂指令，掌握下面这些常用命令，就能轻松管理OpenClaw（所有系统通用，复制粘贴即可执行，重点命令标红提示），每一条都配了通俗解读，小白也能一眼看懂。

（1）核心服务管理命令（最常用，必记！）
这类命令用于控制OpenClaw的核心服务（Gateway），启动、停止、查看状态都靠它们，日常用得最多，记牢这几条就够了：

•启动服务：openclaw daemon start，解读：最基础的启动命令，安装完成后首次启动、服务停止后重启，都用这条，执行后AI助手开始运行，飞书机器人即可正常响应。
•停止服务：openclaw daemon stop，解读：需要修改配置、安装新Skill后，必须先停止服务，再重启才能生效，执行后飞书机器人会停止响应，服务关闭。
•重启服务：openclaw daemon restart，解读：修改配置、安装新插件后，快速重启服务的捷径，相当于停止+启动，不用输两条命令。
•查看OpenClaw版本：openclaw –version，解读：查看当前安装的OpenClaw版本，判断是否需要更新。
•查看帮助文档：openclaw –help解读：忘记命令用法时，执行这条，会显示所有命令的详细说明，相当于随身手册。
（2）大模型（基模）相关命令
用于查看、修改当前使用的大模型（基模），比如想从Qwen换成Claude，或者查看已配置的模型，用这些命令：

•查看当前使用的基模：openclaw models，解读：执行后会显示当前配置的大模型（比如qwen-3-plus），以及模型的基础信息（API地址、调用额度等）。
•修改基模（切换模型）：openclaw models set 模型名称，解读：核心命令！比如想从Qwen切换到Claude，执行openclaw models set claude-3-opus，切换后重启服务即可生效；常用模型名称：qwen-3-plus（通义千问）、claude-3-opus（Claude）、gpt-4-turbo（OpenAI）。
•查看支持的所有模型：openclaw models list，解读：想知道OpenClaw支持哪些大模型，执行这条就能看到完整列表，包括模型名称、支持状态、适用场景。
（3）Skills（技能）相关命令
Skills是AI的工具箱，安装、卸载、查看、更新Skill，全靠这些命令，和我们后面实操股票助手密切相关：

•安装新Skill：npx clawhub install Skill名称，解读：最常用！比如安装股票推荐Skill，执行npx clawhub install 1password，安装完成后重启服务即可使用。
•卸载不需要的Skill：npx clawhub uninstall Skill名称，解读：Skill装多了占内存，不用的可以卸载，比如卸载代码生成Skill，执行npx clawhub uninstall 1password。
•查看已安装的所有Skill：openclaw skills list，解读：查看自己装了哪些Skill，以及每个Skill的版本、运行状态（正常/异常）。
（4）Hooks（钩子）相关命令
Hooks是AI的自动触发开关，添加、删除、查看钩子，实现AI自动响应，比如收到关键词就执行Skill，用这些命令：

•查看已添加的所有Hook：openclaw hooks list，解读：查看自己添加的所有钩子，包括触发条件、执行动作、状态。
•启用/禁用Hook：openclaw hooks enable/disable Hook名称解读：不想删除Hook，但暂时不用，执行这条命令禁用，需要时再执行一次启用，比如openclaw hooks disable boot-md。
五、常见问题的解决方案（持续更新）
（1）首次与飞书对话报错
OpenClaw: access not configured.
Your Feishu user id: ****
Pairing code: XXXXXXXX
Ask the bot owner to approve with:
openclaw pairing approve feishu XXXXXXXX
其中，XXXXXXXX是飞书的配对码，执行如下命令即可修复：

执行授权命令，替换成你的配对码

openclaw pairing approve feishu XXXXXXXX

检查当前授权状态

openclaw pairing list

测试OpenClaw基础功能

openclaw feishu send –chat-id <你的飞书群ID> --text "测试消息"

image

本地交互可以选择 控制台交互/ webui 交互

飞书开放平台：https://open.feishu.cn/app/cli_a92cf3f60dfb9cb1/baseinfo

本地部署openclaw之后，需要关联飞书机器人和openclaw。需要使用远程云服务。

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

windows

（1）前置准备
在安装OpenClaw之前，先做好这3个准备工作，避免安装到一半卡住，浪费时间：

1.检查系统版本：
1.Windows：需要Windows 10/11，而且必须安装WSL2（否则无法正常运行，后面会教你怎么装）。
2.Linux：推荐Ubuntu 20.04+，其他Linux系统（如Debian、Fedora）也可以，但步骤略有差异。
3.MacOS：需要MacOS 12+，无论是Intel芯片还是M芯片，都能正常运行。
2.安装Node.js：OpenClaw依赖Node.js运行，必须安装22.0及以上版本（低于这个版本会报错），后面每个系统的安装步骤里，会一起教你安装。
3.准备核心凭证：
1.Qwen API Key：用来调用通义千问模型，相当于给AI大脑激活权限。
2.飞书企业账号+自建应用：用来和OpenClaw对接，需要创建一个飞书企业自建应用，获取App ID和App Secret。
（2）安装步骤（Windows、Linux、MaxOS）
OpenClaw提供了官方安装脚本，不同系统的安装命令不同，全程自动安装，无需手动配置环境，跟着步骤来即可。

•Windows系统
第一步：打开PowerShell（以管理员身份运行，快捷键：Win+X，选择Windows PowerShell）。

第二步：复制以下命令，粘贴到PowerShell中，回车执行（自动安装OpenClaw及依赖，耐心等待5-10分钟，期间不要关闭窗口）：

iwr -useb https://openclaw.ai/install.ps1 | iex
第三步：安装完成后，执行以下命令，启动新手引导（后续配置Qwen、飞书会用到）：

openclaw onboard –install-daemon
常见问题：如果提示“iwr不是内部或外部命令”，说明未启用PowerShell的远程脚本执行权限，执行以下命令开启，再重新安装：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
•Linux系统
第一步：打开终端（快捷键：Ctrl+Alt+T）。

第二步：复制以下命令，粘贴到终端中，回车执行（自动安装，无需手动干预）：

curl -fsSL https://openclaw.ai/install.sh | bash
第三步：安装完成后，执行以下命令，启动新手引导：

openclaw onboard –install-daemon
常见问题：如果提示“curl: command not found”，先执行以下命令安装curl，再重新安装：

Ubuntu系统

sudo apt update && sudo apt install curl -y

CentOS系统

sudo yum install curl -y

https://www.cnblogs.com/whuanle/p/19558535

openclaw 重启失败

https://zhuanlan.zhihu.com/p/2004580081973092721

可以通过下面命令消除飞书影响

openclaw plugins disable feishu openclaw config unset plugins.entries.feishu openclaw config unset plugins.load.paths rm -rf ~/.openclaw/extensions/feishu 然后重启gateway

openclaw gateway restart 此时不会再有feishu插件的警告啦。

image