官方文档：https://docs.openclaw.ai/zh-CN

目录

安装与升级

快速上手，搭建你的 OpenClaw 环境，完成基础依赖配置。

核心配置

连接大脑，配置 AI 模型参数与消息渠道，实现基础对话。

高级功能

深度定制，通过技能编排与人格调教，打造个性化智能体。

部署与安全

安全运行，选择隔离或云端部署方案，保障数据安全。

安装与升级（Windows / macOS）

一键安装

1
2
3
4

iwr -useb https://openclaw.ai/install.ps1 | iex

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

请确保您的系统已连接互联网，并拥有相应的执行权限。

为什么不推荐一键安装？

1. 无法指定安装位置
2. 依赖互联网，不支持内网
3. 脚本的行为难以掌控，有安全风险

手动安装 Node.js

阿里云镜像下载地址：https://registry.npmmirror.com/binary.html?path=node/v24.14.0/

建议下载长期支持版本（LTS，大版本号为偶数）以获得更稳定的运行环境。

Windows 下载 node-v24.14.0-x64.msi，macOS 下载 node-v24.14.0.pkg（不区分CPU）。

手动安装 Python、Git（可选）

Windows

安装 Python：智能体可编写 Python 脚本完成任务

https://registry.npmmirror.com/-/binary/python/3.14.3/python-3.14.3-amd64.exe

安装 Git：少数插件的安装依赖 Git

https://registry.npmmirror.com/-/binary/git-for-windows/v2.53.0.windows.2/Git-2.53.0.2-64-bit.exe

macOS

安装苹果官方 Command Line Tools（包含 Python、Git），直接执行以下命令，然后根据弹窗提示操作

1

xcode-select --install

或从苹果官网下载 dmg 格式安装包：<https://developer.apple.com/download/all/?q=command line tools>

手动安装 OpenClaw

Windows 用户搜索「命令提示符」- 右键 -「以管理员身份运行」

苹果用户搜索「终端」并打开

1
2
3
4
5
6
7
8

npm config set registry https://registry.npmmirror.com


npm i -g openclaw


openclaw onboard

模型配置（阿里 / 智谱）

免费选择

千问国际版：https://chat.qwen.ai

百炼：https://bailian.console.aliyun.com

私有部署：LM Studio（进阶，需要大内存或大显存）https://lmstudio.ai/

付费选择

智谱 Coding Plan：https://www.bigmodel.cn/glm-coding?ic=SQ9YZSPIR7

阿里 Coding Plan：https://www.aliyun.com/benefit/scene/codingplan

MiniMax: https://platform.minimaxi.com/docs/coding-plan/intro

字节：https://www.volcengine.com/activity/codingplan

腾讯：https://cloud.tencent.com/act/pro/codingplan

百度：https://cloud.baidu.com/product/codingplan.html

无问芯穹：https://cloud.infini-ai.com/platform/ai

消息渠道配置（飞书 / 微信 / QQ）

通过常用的聊天工具在外控制家里的「龙虾」

接入飞书

支持流式输出、耗时、状态展示，体验好

https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

npx -y @larksuite/openclaw-lark-tools install

npx -y @larksuite/openclaw-lark-tools update

openclaw config set channels.feishu.streaming true

openclaw config set channels.feishu.footer.elapsed true

openclaw config set channels.feishu.footer.status true

openclaw config set channels.feishu.threadSession true

openclaw gateway restart

/reasoning on

/verbose on

Windows 如果遇到二维码乱码
复制二维码内容，打开记事本，粘贴，再点「格式」-「字体」，选择字体「Consolas」，确定，即可正常显示

建议在飞书开发者后台中配置机器人菜单，增加以下四个常用命令：

1
2
3
4

/stop - 立即停止机器人当前的工作
/status - 机器人状态
/compact - 压缩上下文（输出变慢时使用）
/new - 创建新的会话

接入微信

有微信号即可接入，门槛低

需要更新到微信最新版本 8.0.69 (3040)，PC 端微信暂不支持

微信-8.0.69(3040).apk: https://pan.baidu.com/s/1RherbWdd0SCz1n3ahxM-GA?pwd=q3ij

1

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

然后扫描二维码即可绑定

Windows 如果遇到报错

1 2 3

[openclaw-weixin] 无法定位宿主 openclaw 包根目录，跳过 symlink 创建 [openclaw] Failed to start CLI: PluginLoadFailureError: plugin load failed: openclaw-weixin: Error: Cannot find module 'openclaw/plugin-sdk/channel-config-schema' [openclaw-weixin] 首次连接未完成，可稍后手动重试：

这是微信 OpenClaw 插件的 bug，需要额外执行以下命令

1 2	mklink /J %USERPROFILE%\.openclaw\extensions\openclaw-weixin\node_modules\openclaw %APPDATA%\npm\node_modules\openclaw openclaw channels login --channel openclaw-weixin

Windows 如果遇到二维码乱码
复制二维码内容，打开记事本，粘贴，再点「格式」-「字体」，选择字体「Consolas」，确定，即可正常显示

接入 QQ

有 QQ 号即可接入，门槛低

https://q.qq.com/qqbot/openclaw/index.html

1
2
3
4

openclaw plugins install @tencent-connect/openclaw-qqbot@latest
openclaw channels add --channel qqbot --token "AppID:AppSecret"

openclaw gateway restart

人格调教

官方中文提示词：https://docs.openclaw.ai/zh-CN/reference/templates/AGENTS

• AGENTS：入口
• BOOTSTRAP：初始化引导
• HEARTBEAT：心跳
• IDENTITY：龙虾的个人信息
• SOUL：龙虾的性格
• TOOLS：工具参数、环境信息
• USER：用户的个人信息
• AI 会自主决策创建更多文件

记忆

记忆是智能体工作空间中的纯 Markdown 文件。这些文件是唯一的事实来源；模型只”记住”写入磁盘的内容。

短期记忆：memory/YYYY-MM-DD.md

长期记忆：MEMORY.md

技能创建与技能市场

官方技能市场：https://clawhub.ai/

1

npm i -g clawhub

官方市场容易遇到限流（429），如果遇到限流就换成腾讯市场。

腾讯技能市场：https://skillhub.tencent.com/

1

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

SkillHub 不支持 Windows？
添加以下两个环境变量到 Path：

1 2	C:\Program Files\Git\bin %USERPROFILE%\.local\bin

然后到 Python 安装目录下复制一份 python.exe 并重命名为 python3.exe。
然后到 %USERPROFILE%\.local\bin 下创建一个文本文件 skillhub.cmd，内容是

1	bash skillhub %*

常用技能：

1
2
3
4
5
6
7
8
9
10

# 当用户询问"如何做某事"、"寻找某技能"或希望扩展功能时，帮助发现并安装智能体技能。适用于寻找可安装功能的场景。
skillhub install find-skills
# 记录学习经验、错误与修正，实现持续改进。
skillhub install self-improving-agent
# 基于Rust的快速无头浏览器自动化CLI，支持Node.js回退，允许AI代理通过结构化命令执行页面导航、点击、输入和快照操作。
skillhub install agent-browser
# AI优化网络搜索，通过Tavily API实现。为AI智能体提供简洁相关的结果。
skillhub install tavily-search
# 邮件收发
skillhub install imap-smtp-email

工具配置（浏览器控制、联网搜索）

浏览器控制：

1
2

npm i -g agent-browser
agent-browser install

示例：用 agent-browser 查一下现在的微博热搜前 5

联网搜索：https://app.tavily.com/home 每月免费 1000 次

设置环境变量 TAVILY_API_KEY=tvly-dev-***

示例：用 tavily-search 查一下伊朗最新新闻

创建新技能

天气：

申请高德 web 服务 API 类型 KEY：https://lbs.amap.com/dev/

写一个新 skill，查询当前电脑的 CPU 和内存使用情况

写一个新 skill，使用 https://restapi.amap.com/v3/weather/weatherInfo?key=***&city=城市编码&extensions=base 查询天气，这个接口的参数在这个文档里 https://lbs.amap.com/api/webservice/guide/api/weatherinfo

心跳与定时任务

心跳

让 AI 主动干活，主动发消息

最佳实践：跳过夜间，节省 token，避免打扰。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "agents": {
    "defaults": {
      "heartbeat": {
        "every": "30m",
        "target": "last",
        "activeHours": {
          "start": "07:00",
          "end": "22:00",
          "timezone": "Asia/Shanghai"
        }
      }
    }
  }
}

示例：你每天都会在随机时间主动给我发随机的 3-6 条消息，只能在我醒着的时间，即 7 点到 22 点之间发，可以但不限于聊天气、最近发生的事情、科技新闻等，我会回复你，是否对你的话题感兴趣。你需要通过我的反应不断地学习我的喜好，从而更加准确地发起我感兴趣的话题，你可以把这项规则写进心跳里

示例：帮我监控 https://item.jd.com/100235893165.html 的价格，降价了提醒我

示例：在心跳中检查邮箱中的邮件，总结成摘要发给我

定时任务

指定时间干活

示例：每天早上 7:20，如果郑州市金水区当天有雨，提醒我，否则不提醒

安全管控

• 运行环境隔离
  • 必须使用干净、隔离的操作系统环境，如龙虾迷你主机、虚拟机或独立的云服务器实例，避免影响主系统安全。
• Skill 查毒
  • 安装前扫描技能，检测恶意软件、间谍软件、挖矿程序及恶意代码模式，识别数据外泄、系统篡改、后门与混淆技术。
  • skillhub install skill-scanner
• 定期「换锁」
  • 本地网关认证——别让任何人都能连上你的 AI
  • 定期更换网关 token、大模型 key
• 防止提示词注入——别让 AI 被”催眠”

云端一键部署

本地客户端

• 腾讯 QClaw：本地客户端，免费，每天 4000 万 token
• 智谱 AutoClaw：本地客户端，模型收费，自定义模型不收费，有较强的浏览器操作能力
• 讯飞 Loomy：本地客户端，需邀请码，底层不是 OpenClaw

云端

大厂有钱就是任性：

• 阿里 JVSClaw：云端 + 手机 APP，免费，需邀请码，相当于一台装了原版 OpenClaw 的云电脑，能装软件、执行命令，自由度极高，token 无限，用完可以找客服免费续

收费门槛较高：

• 字节 ArkClaw：云端，收费每月 200
• 月之暗面 KimiClaw：云端，收费每月 199
• 飞书 OpenClaw：云端，免费每天 100 万 token，收费每月 69 但额度极少（大概不到 1000 万 token）

定价高到离谱：

• 网易 OpenClaw 云电脑：原版 OpenClaw，贵，一小时 2 元，模型调用还要另算，每轮对话 1~2 元，关机数据不保留

移动端

打通米家生态：

• 小米 MiClaw：手机 APP，免费，需邀请码，底层不是 OpenClaw，只支持小米 17 系列

总结

• 夯：阿里 JVSClaw、小米 MiClaw
• 顶级：智谱 AutoClaw、腾讯 QClaw
• 人上人：字节 ArkClaw、月之暗面 KimiClaw
• NPC：讯飞 Loomy、飞书 OpenClaw
• 拉完了：网易 OpenClaw 云电脑

卸载

停止运行并卸载网关

1
2

openclaw gateway stop
openclaw gateway uninstall

卸载 OpenClaw

1

npm uninstall -g openclaw

删除目录

1
2
3
4

rd /s /q %APPDATA%\npm
rd /s /q %APPDATA%\npm-cache
rd /s /q %USERPROFILE%\AppData\Local\npm-cache
rd /s /q %USERPROFILE%\.openclaw

最后到控制面板手动卸载 Node.js、Git、Python