简单说明：
OpenClaw 是一款开源的个人 AI 助手框架，核心定位不是“陪聊机器人”，而是一个“能做事的数字员工”。
与传统 AI 只能回答问题不同，OpenClaw 能够连接你的聊天软件（如飞书、微信、Telegram 等），接收自然语言指令，并自主执行具体的电脑操作或网络任务。
1、OpenClaw的核心设计目标就是跨平台兼容，它可以部署在Linux、macOS和Windows系统上。
2、OpenClaw只能操作它所在的那个环境里的文件，并且只能操作工作区目录下的文件。
3、如果要让OpenClaw自主打开处理电脑里的文件等操作，一般建议使用本地部署，执行更方便。
4、OpenClaw 是基于 Node.js 开发的应用程序，安装OpenClaw的电脑需要先安装Node.js环境。
部署环境：
在本地的Linux系统电脑Ubuntu 24.04.4 LTS中安装部署
#安装并开启ssh服务
sudo apt update
sudo apt install openssh-server -y
sudo systemctl start ssh
sudo systemctl enable ssh
sudo ufw allow ssh
一、安装Node.js环境
openclaw需要Node.js才能运行，OpenClaw 是基于 Node.js 开发的，必须运行在 Node 环境中，通常需要 v18 (LTS) 或 v20 (LTS) 甚至更高。
Node.js® 是一个免费、开源、跨平台的 JavaScript 运行时环境，它让开发人员能够创建服务器、 Web 应用、命令行工具和脚本。
官方网站：
https://nodejs.org/
下载地址：
https://nodejs.org/zh-cn/download
https://nodejs.org/dist/latest-v24.x/node-v24.14.0-linux-x64.tar.gz
1、建议安装lts长期支持版本，直接使用已编译好的包，可以直接下载解压后使用
mkdir -p /data/server/ #创建目录
tar zxvf node-v24.14.0-linux-x64.tar.gz -C /data/server/ #解压
cd /data/server/
mv node-v24.14.0-linux-x64 node #重命名
cd node
./bin/node -v #查看版本
2、添加系统环境变量
vi /etc/profile
#set node environment
export NODE_HOME=/data/server/node
export PATH=$NODE_HOME/bin:$PATH
:wq! #保存退出
source /etc/profile #使配置生效
#查看版本
node -v #node 是 Node.js 的运行时环境
npm -v #npm 是 Node.js 自带的包管理工具
二、安装OpenClaw
官方网站：
https://openclaw.ai/
####################################################
#使用一键脚本安装（需要科学上网才可以）
#apt-get install git curl make cmake g++ build-essential python3 python3-dev
#curl -fsSL https://openclaw.bot/install.sh | bash
####################################################
#修改DNS地址，有时候DNS解析问题也会导致连接失败
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf
#安装依赖包
apt-get install git curl make cmake g++ build-essential python3 python3-dev
#我们使用npn国内镜像源安装
#配置npm国内镜像源
npm config set registry https://registry.npmmirror.com
npm config get registry
#使用npm安装openclaw
#强制 Git 使用 HTTPS，每当遇到 ssh://git@github.com/ 开头的地址时，自动将其替换为 https://github.com/
git config --global url."https://github.com/".insteadOf "ssh://git@github.com/"
npm install -g openclaw@latest #安装openclaw
#看到 added 696 packages in 2m 这一行
#说明 openclaw 及其所有依赖都已经成功下载并安装到了您的全局环境中
#查看版本号
openclaw --version
#查看帮助
openclaw --help
#初始化操作
openclaw onboard
###############################################################
配置项说明
I understand this is powerful and inherently risky. Continue?
选择 Yes
Onboarding mode
选择 QuickStart
Model/auth provider
选择 Skip for now（稍后配置百炼模型）
Filter models by provider
选择 All providers
Default model
选择 Keep current (default: anthropic/claude-opus-4-6)
Select channel (QuickStart)
选择 Skip for now（稍后配置渠道）
Configure skills now? (recommended)
选择 No
Enable hooks?
按空格键选中选项，按回车键进入下一步
How do you want to hatch your bot?
选择 Do this later
###############################################################
#如果上面的步骤做错了，可以恢复到安装完成的状态
#彻底清除旧配置 (恢复出厂设置)
#删除配置目录
rm -rf ~/.openclaw
#如果配置错误，可以重新初始化
openclaw onboard --flow quickstart
#查看token
cat ~/.openclaw/openclaw.json | grep -i token
"mode": "token",
"token": "7d22ce53e2f8fab662f5dbbc7198c0b8d055f064cbba2267"
#启动测试命令
openclaw gateway
#如果是在局域网内其它的电脑上访问，可以通告ssh代理，然后在自己电脑上访问
ssh -N -L 18789:127.0.0.1:18789 user@192.168.21.129
#拼接访问地址，在浏览器打开
http://127.0.0.1:18789/#token=7d22ce53e2f8fab662f5dbbc7198c0b8d055f064cbba2267
#使用openclaw gateway命令一般只用的测试，终端断开之后服务也就无法访问了
#我们现在添加系统自启动服务，使openclaw gateway在后台自启动运行
sudo nano /etc/systemd/system/openclaw.service
[Unit]
Description=OpenClaw Gateway Service
After=network.target
[Service]
#安装使用openclaw的用户和组
User=user
Group=user
WorkingDirectory=/home/user
#绝对路径调用 node 来运行 openclaw
ExecStart=/data/server/node/bin/node /data/server/node/bin/openclaw gateway
#设置环境变量 PATH，确保子进程也能找到 node 和其他工具
Environment="PATH=/data/server/node/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
Ctrl + O #保存
Ctrl + X #退出
#systemd 重新读取配置文件
sudo systemctl daemon-reload
#启动服务
sudo systemctl start openclaw
#检查状态
sudo systemctl status openclaw
#开启自启动
sudo systemctl enable openclaw
三、申请Qwen大模型key
https://bailian.console.aliyun.com/
登录阿里云百炼-模型-密钥管理-创建API Key
创建完成之后会得到一个API Key：sk-2****5552
记录下这个API Key后面添加模型要用到
四、申请飞书机器人
4.1打开飞书官方网站：https://www.feishu.cn/
下载飞书客户端：https://www.feishu.cn/download
下载pc版本和手机端，注册登录
4.2打开飞书开放平台：https://open.feishu.cn/
登录成功-开发者后台-创建企业自建应用
应用名称：openclaw
应用描述：openclaw
创建
创建好之后打开这个应用-基础信息-凭证与基础信息-应用凭证
App ID：cli_a89c25e4bdq3yujj
App Secret：vyCdNxmf9Npnm9cKVYKHxhM7aXxaAHum
记录下这两个值，后面添加飞书机器人要用到
4.3应用能力-添加应用能力-按能力添加-机器人-添加
添加完成后点配置-机器人配置-如何开始使用
openclaw助手
保存
4.4开发配置-权限管理-开通权限-输入：im 搜索
全选-确认开通权限
4.5继续打开权限管理，开通权限，搜索“获取通讯录基本信息” ，勾选，然后点击确认开通权限。
4.6开发配置-事件与回调-事件配置，订阅方式选择“使用 长连接 接收事件” 。然后点击保存。
4.7点击添加事件，搜索“接收消息”，勾选接收消息，点击确认添加。
4.8应用发布-版本管理与发布
五、在OpenClaw添加Qwen大模型
#设置大模型
openclaw config
Where will the Gateway run?
选择：Local (this machine)
Select sections to configure
选择： Model (Pick provider + credentials)
Model/auth provider
选择： Custom Provider (Any OpenAI or Anthropic compatible endpoint)
API Base URL
输入：https://dashscope.aliyuncs.com/compatible-mode/v1
Paste API key now (Stores the key directly in OpenClaw config)
回车
API Key (leave blank if not required)
输入：sk-22f188ebc1952fbbc285f91sc2
Endpoint compatibility
选择：OpenAI-compatible (Uses /chat/completions)
Model ID
输入：qwen3.5-plus
Endpoint ID
custom-dashscope-aliyuncs-com
回车
Model alias (optional)
e.g. local, ollama
回车
Select sections to configure
选择：Continue (Done)
模型配置完成
可以在浏览器的聊天里面对话
你是什么模型，请用中文回答？
回答：
我是运行在 OpenClaw 平台上的 AI 协作者，当前使用的语言模型是：
通义千问 Qwen-Plus（由阿里云 DashScope 提供的定制化版本）。
#也可以在命令行测试
#openclaw tui 是 OpenClaw 提供的终端用户界面 (Terminal User Interface) 模式
#可以直接在命令行里和 AI 对话，而不需要打开浏览器
openclaw tui
六、配置OpenClaw接入飞书机器人
#清理旧版飞书插件
sudo rm -rf ~/.openclaw/extensions/feishu
#安装飞书插件
openclaw plugins install @m1heng-clawd/feishu
#配置飞书插件
openclaw config
Where will the Gateway run?
选择：Local (this machine) (Gateway reachable (ws://127.0.0.1:18789))
Select sections to configure
选择： Channels (Link WhatsApp/Telegram/etc and defaults)
Channels
选择： Configure/link (Add/update channels; disable unselected accounts)
Select a channel
选择：Feishu/Lark (飞书) (plugin · install)
Install Feishu plugin?
选择：Use local plugin path (/home/user)
How do you want to provide this App Secret?
选择： Enter App Secret (Stores the credential directly in OpenClaw config)
Enter Feishu App Secret
输入：vyCdNxmfsjhnm8cKVWyHxhM7aXxaAHum
Enter Feishu App ID
输入：cli_acc25e4bd23dsg8
Feishu connection mode
选择：WebSocket (default)
Which Feishu domain?
选择：Feishu (feishu.cn) - China
Group chat policy
选择：Open - respond in all groups (requires mention)
Select a channel
选择：Finished (Done)
Configure DM access policies now? (default: pairing)
选择：No
Select sections to configure
选择：Continue (Done)
配置完成
#配对验证
#在飞书机器人聊天对话框获取配对码
#随意输入聊天内容
OpenClaw: access not configured.
Your Feishu user id: ou_8815f1bee482aaf0af47e25834ead773
Pairing code: 5KDG4Q9E
Ask the bot owner to approve with:
openclaw pairing approve feishu 5KDG4Q9E
#在命令行执行
openclaw pairing approve feishu 5KDG4Q9E
#现在就可以和飞书机器人对话了
至此，本地部署OpenClaw+Qwen大模型+接入飞书机器人完成。
②190706903 ③203744115
