（养龙虾）QQ机器人（OpenClaw + Kimi）本地部署完整流程

一、环境准备（Windows + WSL）

1. 启用Windows虚拟化
以管理员身份打开PowerShell，执行： wsl –install 重启电脑。

2. 安装Ubuntu并设置用户
重启后自动进入Ubuntu安装，按提示设置用户名和密码（牢记密码）。

3. 更新软件源
在Ubuntu终端执行： sudo apt update

4. 安装Node.js
添加NodeSource仓库并安装Node.js 22.x： curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash – && sudo apt-get install -y nodejs 验证安装： node –version npm –version

5. 安装OpenClaw
全局安装： sudo npm install -g openclaw@latest

二、QQ开放平台创建机器人

访问 QQ开放平台，使用邮箱注册并登录（不要用QQ扫码）。

2. 点击 “创建机器人”，填写名称、头像、简介。

3. 创建成功后，进入 “开发设置” 页面。

4. 复制 AppID 和 AppSecret（AppSecret 只显示一次，务必保存好）。

三、OpenClaw 初始配置

1. 运行配置向导
在Ubuntu终端执行： openclaw onboard
根据提示：
部署方式：选默认 daemon（直接回车）
消息通道：选 Skip for now（快速启动后再手动添加QQ通道）
搜索提供商：选 Skip for now
技能配置：选 No
Hooks：勾选 Skip for now 后回车
最终选择 Do this later 跳过孵化

2. 手动安装QQ插件
在Ubuntu终端执行： openclaw plugins install @sliverp/qqbot@latest

3. 添加QQ通道
使用你的 AppID 和 AppSecret 执行： openclaw channels add –channel qqbot –token “你的AppID:你的AppSecret” （格式为 AppID:AppSecret，中间是英文冒号）

4. 重启网关
使配置生效： openclaw gateway restart

四、配置AI模型（以Kimi K2.5为例）

1. 申请Kimi API Key
访问 Moonshot AI开放平台
注册登录，在 API Key管理 创建新的 Key（以 sk- 开头）。

2. 在OpenClaw中设置模型
重新运行配置向导或直接修改配置：
openclaw config set agents.main.model moonshot/kimi-k2.5
openclaw config set agents.main.apiKey “你的Kimi API Key”
openclaw config set agents.main.provider moonshot
或者再次运行 openclaw onboard，选择 Moonshot AI (Kimi K2.5) → Kimi API key (.cn) → 粘贴 Key。

3. 重启网关
openclaw gateway restart

五、配置机器人人格（可选但推荐）

1. 访问Web管理界面
在浏览器打开： http://127.0.0.1:18789/#token=你的Token （Token可在首次配置时获得，或通过 openclaw dashboard 查看）

2. 编辑灵魂文件 SOUL.md
在Web界面左侧点击 “代理” → “文件”（或直接访问 /workspace 页面）
点击 SOUL.md 进行编辑，写入机器人的性格、口吻等。
保存后即时生效。

3. 其他可编辑文件
IDENTITY.md：身份信息（名字、创造者）
USER.md：关于主人的信息

六、日常管理与维护

常用命令（在Ubuntu终端执行）

操作	命令
查看状态	`openclaw status`
重启网关	`openclaw gateway restart`
停止网关	`openclaw gateway stop`
查看日志	`openclaw logs --tail 50`
打开Web界面	`openclaw dashboard`

重启电脑后恢复运行
打开Ubuntu终端（wsl -d Ubuntu）
执行 openclaw gateway restart
测试机器人是否在线

备份配置
整个配置目录：/home/你的用户名/.openclaw/
备份命令：cp -r ~/.openclaw ~/.openclaw.backup-$(date +%Y%m%d)

七、让朋友也能聊天

添加沙箱成员（无需上架）：
登录 QQ开放平台 → 机器人管理 → 沙箱配置 → 成员 → 添加朋友的QQ号，角色选管理员。
朋友在手机QQ消息列表中会出现机器人入口，点击即可私聊。
上架为公域机器人（所有人都能搜索）：
完善基础信息后提交审核，审核通过后手动点击“上线”。
⚠️ 目前个人开发者无法配置群沙箱（系统维护中），机器人暂时不能加入群聊，仅支持私聊。

八、常见问题解决
1. 机器人不回复
检查状态：openclaw status
查看日志：openclaw logs --tail 20
确认QQ通道是否已连接
确认API Key是否正确、余额是否充足
2. 报错 API rate limit reached
等待10-30分钟再试
减少发送频率，每条消息间隔几秒
可考虑更换模型（如Qwen）
3. 找不到之前的机器人
确认登录邮箱是否正确
在开放平台点击“机器人管理”查看列表
4. 终端无法粘贴
在WSL终端中，鼠标右键直接粘贴
或使用快捷键 Ctrl+Shift+V