本次安装步骤不包括本地 Ollama的安装，不是完全免费版的！IM用的是飞书，大模型用的deepseek-v4-flash  

 -- 提前购买DeepSeek Token 和配置飞书

• DeepSeek 进入开放平台后台，购买后创建api key ,就可以了

目录

1、检查电脑系统配置，是否支持 WSL2

2、安装WSL2（已经有的可以跳过该步骤）

3、安装 ubantu 

4、进入ubuntu后更新系统基础环境

5、安装 node  npm ，注意安装的node版本>=24，并且修改npm全局权限

6、准备好飞书的配置

6.1 飞书开放平台

7、安装龙虾

8、进行龙虾安装向导，配置大模型、飞书

9、查看getway启动状态，本地连接面板

---

1、检查电脑系统配置，是否已支持 WSL2

• 快捷键  win+x+Y 看windows系统版本Win10 64位 ≥ 21H2，或 Win11 → 满足安装，系统版本过低需要手动开启配置，太旧的系统这里不多做介绍了哈~
• 快捷键  win+x  打开PowerShell(管理员)
• wsl -l -v 查看是否安装过linux环境

2、安装WSL2（已经有的可以跳过该步骤）

wsl --install

3、安装 ubantu 

# 卡 0.0% 或商店网络不通时：
wsl --install --web-download -d Ubuntu-22.04

# 如果想让 wsl 默认进 Ubuntu执行
wsl --set-default Ubuntu-22.04 
# 之后只需在 powershell 中执行
wsl

#重启 命令
wsl --shutdown

4、进入 ubuntu后更新系统基础环境

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git ca-certificates build-essential

5、安装 node  npm ，注意安装的node版本>=24，并且修改npm全局权限

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node -v   # >= v24.15
npm -v    # 10/11+

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

6、准备好飞书的配置

6.1 飞书开放平台

1. https://open.feishu.cn → 创建企业自建应用

2. 添加能力 → 机器人

3. 凭证与基础信息 → 记 App ID (cli_xxx) / App Secret

4. 权限管理 → 勾：

   • im:message

   • im:message:send_as_bot

   • im:message.p2p_msg:readonly

   • im:message.group_at_msg:readonly

   • im:resource

   • contact:contact.base:readonly ← 后面报错补的

5. 事件订阅 → 订阅方式选 WebSocket 长连接​ → 加事件 im.message.receive_v1

6. 版本管理与发布 → 创建版本 → 发布

7、安装龙虾

# 全局装 OpenClaw 正式包，并显式放行它的安装脚本
sudo npm install -g openclaw@latest --allow-scripts
openclaw --version    # 出版本号=装好
OpenClaw 2026.7.1-2 (0790d9f) # 版本号

8、进行龙虾安装向导，配置大模型、飞书

# 初始化向导 + 注册系统守护进程​ 二合一
openclaw onboard --install-daemon

# 初始化向导选择项：
1、yes
2、Setup mode (Recommended)  →  Recommended local
3、more->DeepSeek  # Model/auth provider
4、Download from ClawHub (clawhub:@openclaw/deepseek) # 安装deepseek插件包
5、输入deepseek app_key 和 code
6、Keep current (deepseek/deepseek-v4-flash) # 选择默认模型版本
7、IM 选择 Feishu # 选择完之后会自动下载飞书的插件包
# 后面跳过执行初始化，到这一步就完成初始化向导

9、查看getway启动状态，本地连接面板

# 查看服务是否正常启动 
openclaw gateway status
# 在飞书app上的机器人发送消息，测试是否正常回复
# 第一次需要执行配对
openclaw pairing approve feishu <配对码>

• 执行 openclaw dashboard --no-open 会自动把龙虾本地地址并把带 token 的 URL 复制到剪贴板
• 
• 粘贴到浏览器查看龙虾的控制台
• 

常用命令：

命令                                                                    含义
openclaw --version                                    看版本号，确认 CLI 装好
openclaw doctor                             自检神器：Node、gateway、配置、通道健康度全扫一遍
openclaw gateway status                            看网关是否活着、绑在哪个 IP/端口
openclaw gateway start                            前台/后台启动网关
openclaw gateway stop                                    停网关（飞书立刻不回）
openclaw gateway restart                          改配置后必敲，重启生效
openclaw logs --follow                            实时看日志，飞书发消息时跟这里最有用

openclaw channels list                    看当前开了哪些通道（feishu/telegram/wechat 等）
openclaw channels status --probe                    连飞书服务器试一次，看 WS 是否连上
openclaw config get channels.feishu                    看飞书当前配置
openclaw config set channels.feishu.streaming true                    开/关流式卡片
openclaw config set channels.feishu.renderMode "card"            卡片/纯文本渲染模式
openclaw config set channels.feishu.dmPolicy pairing            私聊配对模式（安全）

openclaw skills list                                            已装 skill
openclaw skills install playwright                    装浏览器控制
openclaw skills enable playwright                    启用
openclaw skills disable playwright                    关掉

openclaw config get                                                    看全部配置
openclaw config get channels.feishu.streaming    看单个字段
openclaw config set <path> <value>                    改配置，如：
openclaw config set channels.feishu.cardMode text
openclaw configure                                            交互式向导（≈ onboard 简化版）

openclaw sessions list                            看有哪些会话
openclaw sessions prune                            清旧会话，省空间
openclaw memory list                            看它记住了什么（比如你名字）
openclaw memory clear                            忘掉所有记忆

openclaw schedule list                                    看定时任务
openclaw schedule add "0 9 * * *" -- "早报"            加 cron（格式同 Linux）
openclaw schedule remove <id>            删

systemctl --user status openclaw-gateway    systemd 看服务状态
systemctl --user start openclaw-gateway    等同 openclaw gateway start
systemctl --user enable openclaw-gateway    开机自启
systemctl --user disable openclaw-gateway    关自启