前言：聊聊本地部署 OpenClaw 的小心路子

先说实话，折腾本地 AI 助手这事儿，跟玩游戏差不多。

你得先装好环境，然后一步步把插件塞进去，Zui后再和飞书掰掰手。

别怕，我这老铁Yi经走完了全流程，给你捋一捋，保证你kan完Neng直接开干。

先把 Node.js 拉下来。

macOS 用 Homebrew 安装，Linux 用 apt 或 dnf，Windows 则直接下载安装包。

装完记得打开终端敲：

node -v

npm -v

Nengkan到版本号就算成功啦。

接着装 Git，同理检查一下：

git --version

这俩玩意儿是后面所有命令的基石，没有它们，你连插件dou下不了。

打开终端，一键执行下面的命令：

npm i -g openclaw

Ru果提示权限不足，就在前面加个 sudo 再来一次。

装好以后敲：

openclaw --version

显示版本号就算是打通任督二脉了。

想要可视化的话，用 Web UI：

openclaw dashboard

默认会在本机打开浏览器，你也Ke以手动访问 http://127.0.0.1:18789。

If you prefer terminal, just run：

openclaw tui

TUI 超轻量，不占资源，还Neng随时切换模型。

先把飞书插件给装上。

openclaw plugins install @openclaw/feishu

# 不对不对，这里其实是 @m1heng-clawd/feishu ，别搞错了。

登录飞书开放平台

创建企业自建应用

# 配置 App ID
openclaw config set channels.feishu.appId ""
# 配置 App Secret
openclaw config set channels.feishu.appSecret ""
# 启用飞书渠道
openclay config set channels.feishu.enabled true
# 使用长连接
openclaw config set channels.feishu.connectionMode websocket
# 单聊采用配对授权
openclaw config set channels.feishu.dmPolicy pairing
# 群聊白名单模式
openclaw config set channels.feishu.groupPolicy allowlist
# 必须@才响应
openclaw config set channels.feishu.requireMention true

# 不对不对，上面命令里有个 typo，把 openclay` 改成 `openclaw` 就行啦。

在飞书里找刚才创建的机器人，对它发一句「你好」或者「配对」之类的话。

机器人会回一条带配对码的消息，比如「Pairing code: 123456」。哈哈，这就是关键码啦。回到终端执行：openclaw pairing approve feishu 123456 Ru果提示成功，那就说明 OpenClaw Yi经和飞书建立起安全通道啦！咱就是说现在Ke以正常聊天了。 B 检查状态确保没毛病

openclaw gateway status
# 正常返回 Runtime: running && RPC probe: success 就算 OK。

打开浏览器访问 OpenClaw Dashboard 页面；左侧选择 “Chat”。 输入 “帮我写个 Python 脚本读取 CSV”。 几秒钟后你会得到一段完整代码，还Neng直接复制运行。 Ru果想让脚本跑在本机上，只需在 Terminal 输入 /run <脚本名>.py. 咱就是说hen方便啊！ B 在飞书里和机器人闲聊

打开飞书，对刚才配好的机器人 @ 一句 “今天天气怎么样”。 几秒钟后它会回复当前城市天气，还Neng给出穿衣建议。 想让它帮忙查文件？直接发 “列出 ~/Documents 下Zui近修改的文件”。机器人立马返回列表，你直接点进去就行啦！ Ru果发现它答不上来那就回到终端敲 /model qwen-coder-model, 换个geng强大的模型再试试。哈哈，有时候模型选错了也是坑啊！ 八、常见坑与排查技巧 Pitfall 1：端口被占用导致网关启动失败 😖

默认网关使用 18789 端口，Ru果报错 “address already in use”，先找出占用进程：lsof -i :18789 # macOS/Linux netstat -ano | findstr 18789 # Windows kill -9 PID # macOS/Linux 杀掉进程 taskkill /F /PID PID # Windows 杀掉进程 }

或者直接改配置换个端口再重启：openclaw config set agents.gateway.port 18888 openclaw gateway restart }

确认插件Yi成功安装： openclaw plugins list | grep feishu.检查配置是否写入正确。Ru果刚才改过记得重新执行 alert openclawl gateway restart.. Pitfall 3：模型调用报错 🛑

确认 Qwen API Key 正确无误，并且网络Neng访问对应域名。Ru果公司网络走代理，需要在环境变量里设置 SYSTEMPROXY=yourproxy_url.}