乐于分享
好东西不私藏

5分钟免费开一家openclaw小龙虾公司(树莓派 + 电脑版)

5分钟免费开一家openclaw小龙虾公司(树莓派 + 电脑版)
=

OpenClaw/ClawBot 搭建实战指南

核心要点:OpenClaw/ClawBot是一款强大的AI Agent框架,支持多平台接入,让大模型可以主动调用各种工具和服务。本文系统介绍从零开始搭建OpenClaw的完整流程。
# OpenClaw/ClawBot / 树莓派/WSL 搭建

服务器选型

本地服务器
云服务:阿里云/腾讯云

准备各种大模型API

基本AI 问答和Coding
• 国内
GLM:
API KEY 获取链接: https://bigmodel.cn/usercenter/proj-mgmt/apikeys
活动优惠:https://bigmodel.cn/special_area
Kimi:
API KEY获取链接:https://platform.moonshot.cn/console/api-keys
• 国外
Claude/GPT/gemini等可以上官网查询。
工具/Skill API

clawhub:

各类开源skill都可以从clawhub 里面找到,其他个性化skill可以让自己的小龙虾去生成然后发布, clawhub链接: https://clawhub.ai/

我的个人开源仓库(后续安排我的小龙虾持续更新上传)

https://github.com/wenkangwei/agent_skills

本地搭建

前置环境
Linux 版本要安装node22版本及以上
代码示例可复制
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash  source ~/.bashrc  nvm install node
直接安装
代码示例可复制
# 安装openclaw 源码安装 # 推荐使用npm直接安装最新版本,避免很多问题 npm install -g openclaw@latest  #源码安装 #curl -fsSL https://molt.bot/install.sh | bash   # 安装之后 通过onboard命令进入 安装指南 openclaw onboard
内存<1G的设备安装(树莓派)
树莓派系统安装参考:https://www.raspberrypi.com/software/
由于内存不够, gateway启动大概率会OOM启动不了, 这里解决方案是扩swap空间到2G,用速度换空间,用内存+ swap解决内存不够的问题。
代码示例可复制
# 1. 创建 2GB swap 文件 sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile  # 2. 永久生效 echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab  # 3. 验证 free -h # 应该看到 Swap: 2G #               total        used        free      shared  buff/cache   available #Mem:           906Mi       611Mi        26Mi       7.1Mi       339Mi       294Mi #Swap:          2.9Gi       321Mi       2.6Gi
清理进程和端口,把NODE启动使用的内存space扩大到2G,然后重新启动服务
代码示例可复制
# 1. 确保没有残留进程 killall -9 node openclaw 2>/dev/null sudo fuser -k 18789/tcp 2>/dev/null  # 2. 确认环境变量已设置 systemctl --user set-environment NODE_OPTIONS="--max-old-space-size=2048"  # 3. 重启服务 systemctl --user restart openclaw-gateway.service  # 4. 等待并检查 sleep 15 openclaw gateway status
永久新增NODE_OPTION使用最大的space
代码示例可复制
# 编辑服务文件 mkdir -p ~/.config/systemd/user cat > ~/.config/systemd/user/openclaw-gateway.service << 'EOF' [Unit] Description=OpenClaw Gateway After=network.target  [Service] Type=simple Environment="NODE_OPTIONS=--max-old-space-size=2048" Environment="OPENCLAW_GATEWAY_PORT=18789" ExecStart=/usr/bin/node /usr/local/nodejs/lib/node_modules/openclaw/dist/index.js gateway --port 18789 Restart=always RestartSec=5  [Install] WantedBy=default.target EOF  #或者直接修改 ~/.config/systemd/user/openclaw-gateway.service 文件 # 新增这一行Environment="NODE_OPTIONS=--max-old-space-size=2048"   # 重载并重启 systemctl --user daemon-reload systemctl --user restart openclaw-gateway.service
Docker安装
直接拉国内搭建好的docker镜像下来部署到docker环境,进行隔离
(这里的镜像安装有点坑, openclaw.json 文件配置有问题导致每次进去docker环境都修改不了旧配置)
代码示例可复制
# 拉取预装中国 IM 插件的镜像 docker pull justlikemaki/openclaw-docker-cn-im:latest  # 创建配置目录 mkdir -p ~/.openclaw  # 运行容器(预装飞书插件) docker run -d \   --name openclaw \   -p 8080:8080 \   -p 18789:18789 \   -v ~/.openclaw:/app/config \   -e FEISHU_APP_ID=your_app_id \   -e FEISHU_APP_SECRET=your_app_secret \   justlikemaki/openclaw-docker-cn-im:latest
自己部署docker环境
代码示例可复制
# 克隆官方仓库 cd ~ git clone https://github.com/openclaw/openclaw.git cd openclaw/  # 切换到最新标签 LATEST_TAG=$(git tag --sort=-creatordate | head -1) git checkout $LATEST_TAG  # 构建 Docker 镜像 docker build -t openclaw:$LATEST_TAG .  # 运行容器 docker run -d \   --name openclaw \   -p 8080:8080 \   -p 18789:18789 \   -v ~/.openclaw:/app/config \   openclaw:$LATEST_TAG

OpenClaw 可视化切换大模型API插件

安装openclaw后,一般我们的openclaw大模型API配置都是在 ~/.openclaw/openclaw.json 这个配置文件。
但是这个配置文件内容一般比较多,修改起来不太适合新手, 这里有个github项目支持可视化切换大模型API,更新openclaw.json配置文件
🔗 https://github.com/RongleCat/OpenClawSwitch

接入Channels(飞书/Telegram/WhatsApp)

1、飞书机器人安装
• 1.1、飞书机器人创建
通过飞书 "开发者后台" https://open.feishu.cn/app?lang=zh-CN 创建自己的机器人,之后点进去新建的应用里
从左栏的 "凭证和基础消息" 找到appId, appSecret 这两个信息,后面需要在飞书插件里面配置
• 1.2、飞书机器人权限配置
我们想要让机器人能调用飞书接口进行消息对话需要给读写权限
订阅方式这里选 "长连接"
"事件与回调" - >"添加事件" ->"消息与群组" ->选择所有能让agent操作的权限 并 确认添加
上面图添加的是事件回调的功能, 而agent怎么对这些事件做出操作进行授权 就需要在下图 添加权限。
"权限管理" ->"批量导入/导出权限" - >更新里面的JSON内容变成下面代码块, 最后再确认
代码示例可复制
{   "scopes": {     "tenant": [       "contact:user.base:readonly",       "im:chat",       "im:chat:read",       "im:chat:update",       "im:message",       "im:message.group_at_msg:readonly",       "im:message.p2p_msg:readonly",       "im:message:send_as_bot",       "im:resource",     ],     "user": []   } }
• 1.3、飞书插件安装
代码示例可复制
#Step1 飞书插件安装 openclaw plugins install @m1heng-clawd/feishu  # Step2: 配置填写你自己创建的飞书应用的appId 和appSecret 以及 启动feishu插件 openclaw config set channels.feishu.appId "cli_xxxxx" openclaw config set channels.feishu.appSecret "your_app_secret" openclaw config set channels.feishu.enabled true  # Step3: 重启服务 openclaw gateway restart
• 1.4、飞书agent 玩起来
在手机飞书APP 里面的应用中心找到自己的APP然后对话
后台openclaw会对消息进行记录

OpenClaw使用

OpenClaw 常用命令
代码示例可复制
# 安装指南以及配置各种skill, api 指南 openclaw onboard  # 重启/启动/停止服务 openclaw gateway restart openclaw gateway start openclaw gateway stop  # openclaw 自动修复gateway, plugins 等配置问题,会自动重置配置文件 openclaw doctor --fix  #安装插件 openclaw  plugins install xxxx  #查看openclaw 服务状态 openclaw gateway status
Openclaw 各种路径:
用node 安装的openclaw的skill路径默认如下
/home/<用户名>/.nvm/versions/node/v22.19.0/lib/node_modules/openclaw/skills//SKILL.md
例如: /home/wwk/.nvm/versions/node/v22.19.0/lib/node_modules/openclaw/skills/web-dev-demo/SKILL.md
配置文件路径 (需要新增skill或者改LLM API配置在这里改)
/home/<用户名>/.openclaw/openclaw.json
OpenClaw 切换模型
参考: https://www.kimi.com/share/19c3cf87-a8f2-8691-8000-0000911c8a5d
通过对/home/<用户名>/.openclaw/openclaw.json 文件里面models providers字典里面新增  模型公司,模型版本 base url apiKey 来配置
通过"primary"字段控制选哪个模型
代码示例可复制
{"models": {"providers": {"moonshot": {"baseUrl": "https://api.moonshot.cn/v1","apiKey": "sk-moonshot-key","models": [{"id": "moonshot-v1-8k"}]}, "glm4": {"baseUrl": "https://open.bigmodel.cn/api/paas/v4","apiKey": "glm4-key","models": [{"id": "glm-4"}]}, "deepseek": {"baseUrl": "https://api.deepseek.com/v1","apiKey": "sk-deepseek-key","models": [{"id": "deepseek-chat"}]}}}, "agents": {"defaults": {"model": {"primary": "glm4/glm-4"}}}}
或者通过环境变量来切换使用哪个模型
代码示例可复制
# 临时切换到其他模型(仅当前会话) export OPENCLAW_MODEL_PROVIDER=glm4 export OPENCLAW_MODEL_ID=glm-4  openclaw gateway

常见问题

问题1: 如果出现channel的信息出现下面问题
代码示例可复制
OpenClaw: access not configured. Your Feishu user id: xxxx Pairing code: 1234567 Ask the bot owner to approve with: openclaw pairing approve feishu 1234567
解决方法:
在openclaw安装的机器使用 你的pairing code
代码示例可复制
openclaw pairing approve feishu 1234567
问题2: 如果出现RPC probe: failed 问题,说明openclaw启动不了, 特别是在内存<2G的机器, 那么大概率是内存不足导致启动失败
代码示例可复制
Gateway: bind=loopback (127.0.0.1), port=18789 (service args) Probe target: ws://127.0.0.1:18789 Dashboard: http://127.0.0.1:18789/ Probe note: Loopback-only gateway; only local clients can connect.  Runtime: running (pid 1237, state active, sub running, last exit 0, reason 0) Warm-up: launch agents can take a few seconds. Try again shortly. RPC probe: failed RPC target: ws://127.0.0.1:18789   gateway closed (1006 abnormal closure (no close frame)): no close reason   Gateway target: ws://127.0.0.1:18789   Source: cli --url   Config: /home/pi/.openclaw/openclaw.json  Gateway port 18789 is not listening (service appears running). Logs: journalctl --user -u openclaw-gateway.service -n 200 --no-pager  Troubles: run openclaw status Troubleshooting: https://docs.openclaw.ai/troubleshooting
解决方法:参考上面 "内存<1G的设备安装(树莓派)" 小节内容

参考

⭐⭐Openclaw + feishu搭建参考 https://mp.weixin.qq.com/s/w9_6RX2gK3ZBNyxoTorjKg
点击链接查看和 Kimi 的对话 https://www.kimi.com/share/19c3cf30-4ae2-8c31-8000-0000a4b88d61