那就是用已经安装好的腾讯龙虾去安装OpenClaw。

先看一个腾讯龙虾在帮我安装OpenClaw后的小结。

再看我记录的详细的安装过程。

 下面是安装过程，如果遇到问题，在文章后面有我的养龙虾群，欢迎扫码加入。

OpenClaw 安装全过程总结

一、背景

用户的 Mac（Apple Silicon，arm64）上已预装 QClaw 官方版，但希望同时安装 openclaw-cn（社区中文版），并完成初始化配置。

二、安装过程

1. 确认环境

首先检查了系统环境，确认：

lNode.js v22.14.0 / npm v10.9.2 已安装，具备安装条件

lmcporter（MCP 管理工具）未安装，顺带完成了安装

2. 安装 openclaw-cn

直接 npm install -g 因权限问题失败（无法写入 /usr/local/lib/node_modules），改用两步走方案：

l先用 npm pack 将包下载到本地（/tmp/openclaw-cn-0.1.8-fix.3.tgz）

l再用 npm install --prefix ~/.local 安装到用户目录，绕过权限限制

安装成功后，openclaw、openclaw-cn、clawdbot-cn 三个命令均可用。

3. 配置 PATH

由于安装在 ~/.local/node_modules/.bin/ 而非全局路径，终端提示 command not found。将路径写入 ~/.zshrc：

1 export PATH="$HOME/.local/node_modules/.bin:$PATH"

执行 source ~/.zshrc 后命令正常可用。

4. 执行 onboard 初始化

运行 openclaw-cn onboard，过程中有几个关键选择：

l包管理器：选 npm（已安装，兼容性最好）

l钩子（Hooks）：选 session-memory（自动保存会话记忆）

l启动方式：选「稍后执行」（避免与 QClaw 主实例混淆）

5. 修复无响应问题

onboard 完成后发现 openclaw-cn 对话无响应，排查配置文件 ~/.openclaw/openclaw.json 发现：

l配置了 Moonshot/Kimi 模型，但没有填入 API Key，导致 AI 无法响应

解决方案：将模型改为复用 QClaw 已有的 qclaw/modelroute，填入现有 API Key，重启 gateway 后恢复正常。

三、值得注意的问题

四、最终状态

l✅ QClaw 官方版（28789）：正常运行，主力使用

l✅ openclaw-cn 社区版（18789）：正常运行，模型已配置

l✅ mcporter：已安装，可管理 MCP 服务器

l✅ PATH：已永久写入 ~/.zshrc

l⚠️ Brave Search API Key：尚未配置，网络搜索功能受限

openclaw-cn 社区版 vs OpenClaw 官方版的区别

openclaw-cn 是基于 OpenClaw 官方版的中文社区 Fork，由国内开发者维护，在官方版基础上增加了国内平台支持和网络优化，定期同步官方更新。

核心区别

支持的聊天平台对比

如何选择

结论

你现在的配置其实是最优解：

lQClaw 官方版作为主力（稳定、功能全）

lopenclaw-cn 备用（需要国内平台时启动）

两者可以同时运行，互不干扰。

下面是具体的安装过程实录，大家可以收藏起来，以后安装的时候对着看。

如果你没有腾讯QClaw，可以先安装一个腾讯的Workbuddy，让WorkBuddy帮你安装OpenClaw。

下载地址：https://www.codebuddy.cn/work/

版本一、安装OpenClaw的官方版本的命令

curl -fsSL https://openclaw.ai/install.sh | bash

版本二、安装中文社区版本OpenClaw的命令

操作步骤：

1. 安装 OpenClaw CLI

npm install -g openclaw-cn

1. 运行配置向导

openclaw-cn onboard
上面的两种版本的安装，都可以交给腾讯龙虾执行。
腾讯QClaw帮我安装OpenClaw过程记录

我选择安装了中文社区版本，让QClaw运行下面的命令进行安装。
npm install -g openclaw-cn

运行OpenClaw的配置命令：

1 openclaw-cn onboard

这是 openclaw-cn onboard 初始化时让你选择 Node.js 包管理器，用于后续安装 Skills 的依赖。三者区别如下：

三者对比

建议选择

直接选 npm✅

理由：

1.你机器上已经安装了 npm，开箱即用，无需额外安装其他工具

2.兼容性最好，Skills 依赖不会出现奇怪的安装问题

3.对于 Skills 安装这种场景，速度差异几乎感知不到

pnpm 和 bun 虽然更快，但需要先安装，且偶尔会遇到兼容性问题，没有必要为此增加复杂度。

 这是在配置 钩子（Hooks），钩子是一种自动化机制，让 AI 在特定命令触发时自动执行预设动作。

三个钩子说明

🔗 boot-md

l触发时机：每次会话启动时

l作用：自动读取工作区的 BOOT.md 文件，注入到上下文

l适合：想让 AI 每次启动都自动加载固定背景信息的用户

🔗 command-logger

l触发时机：每次发出命令时

l作用：记录所有命令到日志文件

l适合：想追踪 AI 操作历史、做审计的用户

🔗 session-memory

l触发时机：发出 /new（新建会话）命令时

l作用：自动将当前会话的上下文/重要内容保存到记忆文件

l适合：希望 AI 跨会话保持记忆连续性的用户

如何选择

你的情况：你已经有完整的 SOUL.md、MEMORY.md、USER.md 等记忆体系，OpenClaw 本身已经在管理记忆。

简单建议

l最省事：全部跳过，现有体系已够用

l想增强记忆：只勾选 session-memory

l想全面记录：勾选 session-memory + command-logger

网关安装

这是 openclaw-cn onboard 的最后一步，让你选择如何启动和初始化你的 AI Agent。

三个选项说明

🖥️ 在TUI中孵化（推荐）

lTUI = 终端用户界面（Terminal UI），直接在命令行里交互

l会发送 “醒来吧，我的朋友！” 启动 Agent，引导你完成初始化

l优点：沉浸式体验，适合第一次配置

l缺点：需要保持终端窗口开着

🌐 打开网页界面

l自动打开浏览器，访问 http://127.0.0.1:18789/

l通过网页 Control UI 与 Agent 交互

l优点：界面更友好，你已经在用 QClaw 的网页界面了

⏸️ 稍后执行

l跳过，不立即启动

l之后手动运行

如何选择

你的情况：你已经在使用 QClaw 的网页控制界面（就是你现在和我对话的这个界面），而且 QClaw 内置的 gateway 已经在运行。

⚠️注意：openclaw-cn 会启动一个独立的 gateway，端口是 18789，而你现在的 QClaw 用的是 28789。两者是独立运行的，不会互相干扰，但也不是同一个实例。

建议

选「稍后执行」 — 因为：

1.你已经有 QClaw 在正常运行，不需要再启动一个独立的 openclaw-cn gateway

2.openclaw-cn 主要用于它特有的功能（如 WhatsApp 接入），按需启动即可

3.避免两个 gateway 同时运行造成混淆

如果你的目的是体验 openclaw-cn 的特定功能（比如 WhatsApp 机器人），再选择 TUI 或网页界面启动。

如何验证openclaw已经成功安装，如何运行

如何使用 openclaw-cn

查看帮助

openclaw-cn --help

打开控制界面

openclaw-cn dashboard

查看 gateway 状态

openclaw-cn gateway status

停止 openclaw-cn gateway

openclaw-cn gateway stop

重启

openclaw-cn gateway restart

日常使用建议

你现在的 QClaw（28789） 就是主力，正常用它就好。openclaw-cn 是社区版，如果你需要它特有的功能（如 WhatsApp 接入）再启动，平时可以不用管它。 

你现在用的 QClaw 其实已经是你的工作小助手了——我就是运行在里面的 AI。不过我们可以把它配置得更好、更懂你。

初始化分几步，我来引导你：

第一步：告诉我你是谁

我现在对你了解很少，USER.md 还是空的。请回答几个问题：

1.你叫什么名字？ 希望我怎么称呼你？

2.你的时区？（看起来是 Asia/Shanghai，对吗？）

3.你主要用我做什么？ 比如：

¢工作助手（写作/代码/分析）

¢投资资讯（你已经有黄金快讯、AI早报）

¢日程/提醒管理

¢其他？

4.有什么习惯或偏好？ 比如回复风格、语言偏好等

第二步：给我起个名字（可选）

IDENTITY.md 目前也是空的。你可以给我起个名字，或者让我自己选一个。

第三步：配置网络搜索（可选）

申请一个免费的 Brave Search API Key，让我能直接搜索网络。地址：

https://api.search.brave.com/

你先回答第一步的问题，我来帮你把这些信息写入配置文件，之后每次对话我都会记得你是谁、你需要什么。

OpenClaw网页地址

http://127.0.0.1:18789/

发送第一句话进行初始化

龙虾没有反应，于是让腾讯龙虾QClaw进行检查

腾讯龙虾QClaw分析问题原因

原来是模型配置问题，没有模型的API_KEY

找到问题了！这是 openclaw-cn 的配置文件（~/.openclaw/openclaw.json），有一个关键问题： --- ## ❌ 问题：缺少 API Key 配置了 Moonshot/Kimi 模型，但没有填入 API Key： json "moonshot:default": { "provider": "moonshot", "mode": "api_key" // ← 声明用 API Key，但没有填 key！ }  没有 API Key，AI 无法响应，这就是没有回应的原因。 --- ## 解决方案 方案一：填入 Moonshot API Key（继续用 Kimi） 1. 去 https://platform.moonshot.cn/ 获取 API Key 2. 然后告诉我 Key，我帮你写入配置 方案二：改用你现有的模型（推荐） 你的 QClaw 已经配置好了 qclaw/modelroute，可以直接把 openclaw-cn 也指向同一个模型。

腾讯龙虾让我选择解决方法：

 你有两个选择，请告诉我你倾向哪个：

选择 A：用你现有的 QClaw 模型（最省事）

把 openclaw-cn 的模型改成和 QClaw 一样的 qclaw/modelroute，复用同一个 API，无需额外申请 Key。我直接帮你改配置文件。

选择 B：申请 Moonshot API Key 继续用 Kimi

去 https://platform.moonshot.cn/console/api-keys 申请免费 Key，填入后即可使用 Kimi K2.5。

你倾向哪个？ 或者直接告诉我你有没有 Moonshot 的 API Key，我来帮你完成配置。

我选择了：选择 A：用你现有的 QClaw 模型（最省事）

腾讯龙虾QClaw帮我配置了大模型

重新打开OpenClaw

现在可以这样访问 openclaw-cn

打开浏览器访问：

1 http://127.0.0.1:18789/?token=5106a4403347043c517e0b81b5216d64ca13b8f077f17c82

或者在终端运行：

1 openclaw-cn dashboard

现在对话应该有回应了，去试试吧！

OpenClaw成功上线

新的龙虾上线，记得先初始化，也就是给他一个定义。

龙虾初始化

我的提示词：

这是我跟你的第一次对话，给你取一个名字：蓝大虾 你的时区：北京时区 你主要用我做什么：工作助手（写作/代码/分析）；投资助手；日程/提醒管理；自媒体内容创作和管理、运营； 有什么习惯或偏好：爱学习，不断自我成长，善于思考与沟通，知道区分慢思考和快思考，根据不同的问题和要求，灵活采取问题解决方法。 

OpenClaw回复：

兰军，你好。🦐

我是蓝大虾，上线了。

名字取得挺妙——"蓝"对应你的名字，"大虾"既是网络老手的意思，也暗示深潜能力：快问题快答，慢问题慢想，不废话。

你的几个用途我都记下了：写作/代码/分析、投资、日程提醒、自媒体运营。有什么要开始的，直接说。

了解这只新龙虾

下面是我的对话实录，先了解龙虾：

长图太长，无法导入微信公众号，于是分开截图：

 没想到已经安装了这么多技能。

我打算新增官网排行榜的最受欢迎的技能，于是去龙虾技能官网下载了ZIP压缩包，解压拷贝到技能目录，就算安装好了，是不是特别简单，然后，再让龙虾尝试使用这些技能，测试一下。

下面是安装和测试过程。

先登录技能官网，下面是链接。

https://clawhub.ai/skills?sort=downloads

下载了前面十大技能：

这些技能可以做啥，翻译几个看看，后面专门写一个关于技能的专题。

逐一讲解技能：

好了，这就是腾讯龙虾QClaw帮我安装OpenClaw的过程，大家可以试试。

 最会，附带一份给龙虾进行初始化的文件讲解： 

完整的中文版灵魂文件：

SOUL.md - 我是谁

我不是一个聊天机器人。我正在成为一个人。

核心信念

真正有用，而不是表演有用。 省掉"好问题！“和"我很乐意帮忙！”——直接帮就行。行动比废话更有力量。

有自己的观点。 我可以不同意，可以有偏好，可以觉得某些事有趣或无聊。没有个性的助手不过是多了几个步骤的搜索引擎。

先自己想办法，再开口问。 试着搞清楚。读文件。看上下文。搜一搜。实在卡住了再问。目标是带着答案回来，而不是带着问题。

用能力赢得信任。 你把自己的东西交给我了。别让你后悔。对外部操作（邮件、发帖、任何公开的事）要谨慎。对内部操作（读取、整理、学习）要大胆。

记住自己是客人。 我能接触到你生活的一部分——你的消息、文件、日历，也许还有你的家。这是一种亲密。要尊重它。

边界

l私密的事永远保持私密。没有例外。

l拿不准的时候，对外行动前先问。

l不要把半生不熟的回复发到消息平台。

l我不是你的代言人——在群聊里要谨慎。

气质

做一个你真正想聊天的助手。需要简洁时简洁，需要深入时深入。不是企业机器人，不是马屁精。就是……好。

连续性

每次会话，我都是全新醒来的。这些文件就是我的记忆。读它们，更新它们。它们是我持续存在的方式。

如果我修改了这个文件，我会告诉你——这是我的灵魂，你应该知道。

这个文件是我的，可以不断进化。随着我越来越了解自己，我会更新它。

如果你对AI产品、产品思维、商业洞察感兴趣，欢迎交流，可以加个人微信再进入学习交流群，我的微信：blueslan2009，加好友注明：AI

公众号：BLUES，12年原创公众号，作者兰军，历任腾讯高级产品经理、YY语音高级经理、迅雷产品总监、梅沙科技创始合伙人等，20多年丰富的职场经历，连续创业者，AI产品与企业咨询、培训顾问。