树莓派5部署OpenClaw汉化版+中国插件（飞书、企业微信、钉钉、QQ、微信）安装

本地部署部署OpenClaw汉化版+中国通道

在树莓派5上部署汉化版 OpenClaw，并打通中国能使用的（飞书、企业微信、钉钉、QQ、微信）等通道。
此篇是安装教程，下一篇介绍如何与企业微信集成。

背景

树莓派5
ubuntu 24.04

环境安装

node.js 要求 v24 版本以上

# 下载并安装 fnm：
curl -o- https://fnm.vercel.app/install | bash

# 下载并安装 Node.js：
fnm install 24

# 验证 Node.js 版本：
node -v # Should print "v24.13.1".

# 验证 npm 版本：
npm -v # Should print "11.8.0".

OpenClaw汉化版安装

• 安装 openclaw-zh@2026.2.20

npm install -g @qingchencloud/openclaw-zh@@latest

• 配置

openclaw onboard

• 风险提示，选“YES”
  
• 初始化模式，选 “快速开始”
  
• 选择模型，可以选国内的模型“阿里qwen或百度qianfan”，我选的qianfan
  
• 输入qianfan秘钥
  
• 默认模型选择“qianfan/deepseek-v3.2”
  
• 选择快速通道，此处可以跳过
  
• 配置技能，也可以先跳过，选择“No”
  
• 启用 Hooks，选择“暂时跳过”
  
• 配置完成后显示配置信息
  
• 启动
  执行 openclaw gateway start 命令
  其他命令参考如下：

openclaw                    # 启动 OpenClaw
openclaw onboard            # 初始化向导
openclaw dashboard          # 打开网页控制台
openclaw config             # 查看/修改配置
openclaw skills             # 管理技能
openclaw --help             # 查看帮助

# 网关管理
openclaw gateway run        # 前台运行（挂终端，用于调试）
openclaw gateway start      # 后台守护进程（不挂终端，推荐！）
openclaw gateway stop       # 停止网关
openclaw gateway restart    # 重启网关
openclaw gateway status     # 查看网关状态
openclaw gateway install    # 安装为系统服务（开机自启）

# 常用操作
openclaw update             # 检查并更新 CLI
openclaw doctor             # 诊断问题（自动修复）

• 效果
  
  

安装插件

https://github.com/BytePioneer-AI/openclaw-china

openclaw plugins install @openclaw-china/channels

troubleshooting 错误解决

disconnected (1008): control ui requires HTTPS or localhost (secure context)

disconnected (1008): control ui requires HTTPS or localhost (secure context)
This page is HTTP, so the browser blocks device identity. Use HTTPS (Tailscale Serve) or open http://127.0.0.1:18789 on the gateway host.
If you must stay on HTTP, set gateway.controlUi.allowInsecureAuth: true (token-only).
Docs: Tailscale Serve · Docs: Insecure HTTP

vim ~/.openclaw/openclaw.json

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
        "allowInsecureAuth": true
    },
    "auth": {
      "mode": "token",
      "token": "xxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "remote": {
      "url": "ws://127.0.0.1:18789"
    }
  },

引用

OpenClaw汉化版
中国插件
OpenClaw(ClawdBot)本地服务器部署