龙虾不支持国内IM?一步步带你手搓专属IM APP,控制本地OpenClaw!

234 阅读7分钟

🚀 告别封闭IM工具!数据本地化存储,功能自由扩展,让你的AI数字分身真正听你指挥、为你所用


OpenClaw对接的国内IM工具都是封闭的,无法自定义UI和扩展功能。这让我开始思考:如果能通过自己开发的APP来控制本地的OpenClaw,岂不是更自由?

之前我写了一篇关于Moltbot部署的文章(GitHub 10万+ Star 的 Moltbot 部署实战:手把手带你在本地跑起来这只「龙虾」🦞),最近有了这个新想法。

一、现有方案的痛点

问题描述
封闭性OpenClaw对接的国内IM工具都是封闭的,无法自定义UI和扩展功能
数据安全消息需要流经第三方IM工具,存在数据泄露或被监管的风险
体验受限受限于IM工具的功能,无法实现更个性化的交互方式

二、手搓终端的优势

完全可控:UI、功能、数据流向都由你说了算
跨平台:支持Android、iOS、鸿蒙和浏览器
高性能:基于uni-app x原生框架,流畅度媲美原生应用
自由扩展:想加什么功能就加什么功能,不受限制


三、准备工作:打造你的AI管家「基地」

1. 部署OpenClaw本地网关

首先,你需要一台专用电脑作为OpenClaw的运行环境(相当于你的数字管家的「家」)。

安装步骤

  1. 详细安装教程请参考我之前的文章:GitHub 10万+ Star 的 Moltbot 部署实战
  2. 核心是通过 npm install -g openclaw 安装,然后运行 openclaw onboard 初始化
  3. 初始化时,只需要配置AI模型,其他选项全部默认或选择「No」

2. 安装uni-ai通道插件

为了让你的APP能与OpenClaw通信,需要安装一个WebSocket通道插件:

插件地址uni-ai-openclaw-channel-plugin

安装命令

macOS & Linux

npm install && \
npm run build && \
mkdir -p ~/.openclaw/extensions/uni-ai && \
cp -r dist package.json openclaw.plugin.json ~/.openclaw/extensions/uni-ai && \
cd ~/.openclaw/extensions/uni-ai && \
npm install --production

Windows

一键执行版(复制到PowerShell运行):

# 安装依赖并构建项目
npm install
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }

npm run build
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }

# 目标插件目录
$pluginDir = "$env:USERPROFILE\.openclaw\extensions\uni-ai"

# 创建目录(如果不存在)
New-Item -ItemType Directory -Path $pluginDir -Force | Out-Null

# 复制文件和文件夹
Copy-Item -Path "dist" -Destination $pluginDir -Recurse -Force
Copy-Item -Path "package.json" -Destination $pluginDir -Force
Copy-Item -Path "openclaw.plugin.json" -Destination $pluginDir -Force

# 进入插件目录并安装生产依赖
Set-Location $pluginDir
npm install --production
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }

Write-Host "✅ 插件 uni-ai 已成功安装到 $pluginDir" -ForegroundColor Green

执行过程请见截图

1-openclaw-app.png

📌 使用提示

  1. 在插件项目根目录打开PowerShell(Shift+右键)
  2. 复制粘贴上述代码并执行
  3. 看到绿色提示即表示安装成功

🔒 权限问题: 如果遇到「无法加载文件」的错误,请先执行:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后输入 Y 确认


四、配置通道:建立APP与OpenClaw的通信桥梁

1. 准备配置信息

步骤1:登录 uniCloud Web 控制台,创建一个服务空间,必须是支付宝云版

  1. 访问 uniCloud Web 控制台:访问地址
  2. 登录你的账号
  3. 点击「创建服务空间」
  4. 选择「支付宝云」作为服务提供商
  5. 填写服务空间名称,完成创建
  6. 等待服务空间创建完成

步骤2:下载并配置uni-ai-x插件

  1. 下载地址:uni-ai-x
  2. 关联已创建的uniCloud服务空间(必须是支付宝云版)

2-openclaw-app.png

  1. 编辑配置文件:/uni_modules/uni-ai-x/uniCloud/cloudfunctions/uni-ai-openclaw/config.json
  2. 设置 access_token.openClaw 字段为一个自定义的长字符串(后续会用到)
  3. 右键该文件选择「上传部署」 (这一步非常重要)

3-openclaw-app.png

步骤3:获取WebSocket地址(wsUrl)

  1. 登录uniCloud Web控制台: 访问地址
  2. 找到已关联的服务空间 → 「详情」→ 「云函数/云对象」
  3. 找到 uni-ai-openclaw 云函数,点击「详情」,拉到最下面
  4. 复制「云函数URL化」的路径,然后拼接 /getWebSocketURL
  5. 最终格式:https://[你的云函数路径]/getWebSocketURL

4-openclaw-app.png

2. 配置OpenClaw通道

macOS & Linux

node -e "
const fs = require('fs');
const p = require('os').homedir() + '/.openclaw/openclaw.json';
try {
  let c = JSON.parse(fs.readFileSync(p, 'utf8'));
  c.channels = c.channels || {};
  c.channels['uni-ai'] = {
    enabled: true,
    wsUrl: '__________替换为你的wsUrl__________',
    access_token: '__________替换为你的token__________'
  };
  fs.writeFileSync(p, JSON.stringify(c, null, 2));
  console.log('✅ 配置已自动更新');
} catch (e) {
  console.error('⚠️ 自动配置失败,请手动检查 openclaw.json');
}
" && openclaw gateway restart

Windows

# 第一步:更新配置
node -e "
const fs = require('fs');
const p = require('os').homedir() + '/.openclaw/openclaw.json';
try {
  let c = JSON.parse(fs.readFileSync(p, 'utf8'));
  c.channels = c.channels || {};
  c.channels['uni-ai'] = {
    enabled: true,
    wsUrl: '__________替换为你的wsUrl__________',
    access_token: '__________替换为你的token__________'
  };
  fs.writeFileSync(p, JSON.stringify(c, null, 2));
  console.log('✅ 配置已自动更新');
} catch (e) {
  console.error('⚠️ 自动配置失败,请手动检查 openclaw.json');
}
"

# 第二步:重启网关
if ($LASTEXITCODE -eq 0) {
  openclaw gateway restart
}

💡 注意:请将上述命令中的 wsUrlaccess_token 替换为你实际的值

命令执行截图

4-openclaw-app.png

重启openclaw网关服务结果截图

4-openclaw-app.png

🎉 配置完成:通过以上步骤,我们成功地将OpenClaw与uni-ai-x项目进行了对接,并优化了配置文件的管理方式。现在,你可以使用uni-ai-x项目来与OpenClaw进行通信,实现更丰富的AI功能。


五、打造专属APP:从开发到部署

1. 开发环境准备

  • 下载并安装 HBuilderX(推荐最新版)
  • 在HBuilderX中导入uni-ai-x项目

2. 本地调试

  1. 在HBuilderX中打开项目
  2. 点击「运行」→ 「运行到浏览器」→ 选择一个浏览器
  3. 等待项目启动,你将看到AI聊天界面
  4. 测试与OpenClaw的通信是否正常

7-openclaw-app.png

3. 打包部署

当浏览器调试通过后,你可以将APP打包到各种平台:

移动应用

  1. 点击「发行」→ 「云打包-原生应用」
  2. 选择Android、iOS或鸿蒙平台
  3. 按照提示填写必要信息
  4. 等待打包完成后下载安装包

7-openclaw-app.png

Web应用

  1. 点击「发行」→ 「网站-PC Web或手机H5」
  2. 打包后可部署到任何Web服务器

六、实战演示:让数字管家为你办事

现在,你的专属AI控制终端已经搭建完成。让我们来测试一下:

APP1.jpg

场景:创建提醒事项

  1. 在APP中打开聊天界面
  2. 发送指令:「帮我创建一个明天下午3点的会议提醒」
  3. OpenClaw会分析指令并执行相应操作
  4. 执行完成后,APP会收到反馈

示例1: APP2.jpg

示例2: APP3.jpg

更多可能性

功能类型示例指令
文件操作「帮我整理桌面文件,按类型分类」
信息查询「帮我查一下明天的天气和限行信息」
自动化任务「每天晚上10点帮我关闭电脑」
个性化服务根据你的习惯和偏好提供定制化建议

七、总结与展望

通过本文的步骤,你已经成功:

  1. 搭建了本地OpenClaw网关:作为你的AI管家核心
  2. 安装了uni-ai通道插件:建立了通信桥梁
  3. 开发并部署了专属APP:实现了跨平台控制

后续优化方向

  • 🎨 UI定制:根据个人喜好美化APP界面
  • 🚀 功能扩展:添加语音输入、快捷指令、多模型切换等功能
  • 🔒 安全增强:添加身份验证、加密通信等安全措施
  • 🔄 自动化集成:与更多本地服务和设备集成

写在最后

打造专属AI控制终端,不仅是技术上的尝试,更是对未来数字生活的探索。通过这种方式,你可以真正拥有一个「懂你、听你、为你服务」的数字分身,让AI技术更自然地融入你的日常。

🎯 核心价值:数据本地化、功能自定义、体验个性化


相关资源

相关阅读

技术支持


🌟 你准备好让你的数字管家为你服务了吗?赶紧动手试试吧!💪