OpenClaw 入门指南：从零开始搭建个人 AI 助手

Openclaw2026

2549人浏览 · 2026-03-23 17:00:00

Openclaw2026 · 2026-03-23 17:00:00 发布

还在为无法随时随地调用 AI 能力而烦恼吗？想要一个能24小时在线、处理各种任务的智能助手？OpenClaw 正是为你打造的下一代开源 AI 助手框架。本文将带你从零开始，深入了解并掌握 OpenClaw 的核心功能，快速搭建属于你自己的个人 AI 助手。

一、引言：什么是 OpenClaw，为什么需要它

1.1 OpenClaw 是什么

OpenClaw 是一款功能强大的开源 AI 助手框架，它能够将各种大语言模型（LLM）的能力通过多种即时通讯渠道（如微信、企业微信、钉钉）开放给用户。与传统的 AI 聊天机器人不同，OpenClaw 不仅仅是一个简单的对话界面，它是一个完整的多代理协作系统，支持定时任务、插件扩展、自动化工作流等多种高级功能。

从技术架构角度来看，OpenClaw 构建在 Node.js 之上，利用其异步非阻塞的特性，能够高效处理大量并发请求。它采用插件化设计，这意味着你可以根据自己的需求灵活地添加或移除功能模块。无论是个人用户想要一个私人助理，还是团队需要一个协作工具，OpenClaw 都能提供完善的解决方案。

1.2 为什么你需要 OpenClaw

在日常生活中，你是否遇到过这些场景：想要查询信息但不想打开浏览器搜索、需要在特定时间提醒自己做某事、希望有一个 AI 能帮你总结长文或者翻译内容？这些需求 OpenClaw 都能满足。

更重要的是，OpenClaw 让你能够完全掌控自己的数据和隐私。与那些将数据上传到第三方服务器的 AI 服务不同，OpenClaw 可以部署在你自己的服务器上，所有的对话数据都保存在本地。你还可以自由选择想要使用的大语言模型提供商，无论是 OpenAI、Anthropic Claude，还是国产的通义千问、文心一言，都可以灵活配置。

1.3 OpenClaw 的核心特性

多渠道支持：同时连接微信、企业微信、钉钉等多个通讯平台
多代理架构：支持创建多个专业化的 AI 代理，分工协作
插件系统：丰富的插件生态，满足各种扩展需求
定时任务：支持 Cron 表达式，可设置自动化执行的任务
完全开源：代码透明可定制，社区活跃支持

二、环境准备：系统要求与 Node.js 安装

2.1 系统要求

在开始安装 OpenClaw 之前，我们需要确保你的计算机满足以下基本要求：

配置项	最低要求	推荐配置
操作系统	Ubuntu 18.04+ / macOS 10.15+ / Windows 10+	Ubuntu 20.04+ / macOS 12+
Node.js	>= 22.x (必需)	22.x LTS
内存	1GB RAM	2GB RAM 或以上
存储空间	至少 500MB 可用空间	2GB 或以上（用于模型缓存）
网络	稳定互联网连接	稳定互联网连接（需要访问 OpenAI API 等服务）

💡 重要提示：OpenClaw 要求 Node.js >= 22，这是强制要求，不满足将无法运行。

如果你是使用云服务器（如 AWS、阿里云、腾讯云）部署，建议选择位于网络条件良好地区的服务器，以确保与各通讯平台的连接稳定。

💡 Windows 用户特别提示：如果你在 Windows 10/11 上运行，建议启用 WSL2（Windows Subsystem for Linux）来获得更好的兼容性和性能。具体的 WSL2 安装教程可以在微软官方文档中找到。

2.2 Node.js 安装

OpenClaw 基于 Node.js 构建，要求 Node.js >= 22。推荐安装 LTS（长期支持）版本。

在 macOS 上安装

最简单的方式是使用 Homebrew 包管理器。如果你还没有安装 Homebrew，请先在终端中运行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装好 Homebrew 后，执行以下命令安装 Node.js 22：

brew install node@22

安装完成后，验证 Node.js 是否安装成功：

node --version
# 应该输出 v22.x.x 或类似版本号

npm --version
# 应该输出 10.x.x 或类似版本号

在 Ubuntu/Debian 上安装

对于 Ubuntu 或 Debian 系的 Linux 发行版，我们可以使用 NodeSource 仓库来安装 Node.js 22：

# 添加 NodeSource 仓库（Node.js 22）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

在 Windows 上安装

如果你使用 WSL2，可以按照上述 Ubuntu 的方法进行安装。如果直接在 Windows 上运行，建议下载 Node.js 官方安装包：

访问 https://nodejs.org/zh-cn/ 下载 LTS 版本的 Windows 安装包
运行安装程序，勾选“Add to PATH”选项
按照安装向导完成安装
打开 PowerShell 或命令提示符，验证安装

2.3 推荐安装 Git

Git 是版本控制工具，也是后续管理 OpenClaw 代码的必备工具。检查一下你的系统是否已经安装：

git --version

如果没有安装，macOS 用户可以使用 brew install git，Ubuntu 用户可以使用 sudo apt-get install git。

三、安装 OpenClaw：快速入门

3.1 标准安装（推荐）

OpenClaw 提供一键安装脚本，这是最推荐的安装方式：

macOS / Linux 标准安装

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

安装完成后，验证安装：

openclaw --version

Windows 安装 (PowerShell)

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))

Beta 版本安装

如果你想体验最新功能，可以使用 Beta 版本：

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

开发者安装（从源码）

如果你想要最新功能或者想要定制 OpenClaw，可以从 GitHub 克隆源码：

# 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git

# 进入项目目录
cd openclaw

# 安装依赖（推荐使用 pnpm）
pnpm install

# 编译项目
pnpm build

# 首次运行自动安装 UI 依赖
pnpm ui:build

💡 提示：官方推荐使用 pnpm 作为包管理器，不推荐使用 npm。

3.2 目录结构初识

安装完成后，OpenClaw 会在你的主目录下创建一个 .openclaw 文件夹作为工作目录。其结构大致如下：

~/.openclaw/
├── openclaw.json       # 主配置文件 (JSON5 格式)
├── workspace/          # 工作空间目录
│   ├── memory/         # 记忆数据
│   └── sessions/       # 会话数据
├── data/               # 数据存储目录
├── logs/               # 日志目录
└── plugins/            # 插件目录

⚠️ 注意：配置文件位于 ~/.openclaw/openclaw.json，不是 config.yaml。

四、初始配置：onboard 向导

4.1 启动初始化向导

第一次运行 OpenClaw 时，系统会自动启动初始化配置向导。这个向导会引导你完成基本的设置，即使你是技术新手也能轻松上手。

# 启动初始化向导
openclaw onboard

启动后，你会在终端看到初始化向导的界面。向导会依次询问以下内容：

语言选择：选择界面语言（支持中文和英文）
AI 模型配置：选择使用哪个大语言模型
渠道配置：选择要连接的通讯平台
管理员设置：设置管理员账号和密码

如果你想同时安装系统服务（开机自启），可以使用：

openclaw onboard --install-daemon

4.2 配置文件说明

OpenClaw 使用 JSON5 格式的配置文件 ~/.openclaw/openclaw.json。以下是一些配置示例：

最小配置

{
  agent: { workspace: "~/.openclaw/workspace" },
  channels: { "wechat-work": { allowFrom: ["user-id-001"] } },
}

完整配置示例

{
  // 身份设置
  identity: {
    name: "Clawd",
    theme: "helpful assistant",
    emoji: "🦞",
  },

  // 日志配置
  logging: {
    level: "info",
    file: "/tmp/openclaw/openclaw.log",
    consoleLevel: "info",
    consoleStyle: "pretty",
    redactSensitive: "tools",
  },

  // 会话行为
  session: {
    scope: "per-sender",
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 60,
    },
  },

  // 工具配置
  tools: {
    allow: ["exec", "process", "read", "write", "edit"],
    deny: ["browser", "canvas"],
    exec: {
      backgroundMs: 10000,
      timeoutSec: 1800,
    },
  },

  // 网关配置
  gateway: {
    mode: "local",
    port: 18789,
    bind: "loopback",
    controlUi: { enabled: true, basePath: "/openclaw" },
  },
}

五、渠道连接：微信/企业微信/钉钉配置

OpenClaw 支持同时连接多个通讯平台，这一节我们将详细介绍国内主流通讯平台的配置方法。

⚠️ 注意：以下配置中，微信/企业微信/钉钉的集成属于社区方案，需要通过 Webhook 或第三方库实现。OpenClaw 官方主要支持海外平台，国内平台配置请根据实际情况调整。

5.1 企业微信配置

企业微信是国内最常用的企业通讯工具之一，通过企业微信应用可以方便地集成 OpenClaw。

第一步：创建企业微信应用

登录企业微信管理后台
进入「应用管理」-「创建应用」
填写应用名称（如 “OpenClaw AI 助手”）并上传头像
设置应用可见范围（选择可以使用该应用的成员或部门）
创建完成后，进入应用详情页面

第二步：获取 CorpID 和 Secret

在企业微信管理后台的「我的企业」页面，可以找到 CorpID（企业ID）
在应用详情页面，点击「查看」获取应用的 Secret（应用密钥）
记录好 CorpID 和 Secret

第三步：配置应用接收消息

在应用详情页面，找到「接收消息」部分
点击「设置 API 接收」
填写以下信息：
- URL：你的服务器地址（如 https://your-domain.com/wework-webhook）
- Token：用于验证的 Token
- EncodingAESKey：消息加密密钥（可选）
保存设置

第四步：配置 OpenClaw

📝 社区方案：由于 OpenClaw 官方尚未原生支持企业微信，建议使用以下方案之一：

方案 A：使用 Webhook 中转（推荐）

{
  channels: {
    webhook: {
      enabled: true,
      path: "/webhook/wework",
      secret: "your-webhook-secret",
    },
  },
}

方案 B：使用企业微信 SDK 插件

社区开发者提供了企业微信集成插件，可以参考 OpenClaw 插件市场获取。

# 安装企业微信插件（社区方案）
clawhub install wechat-work

配置示例：

{
  channels: {
    "wechat-work": {
      enabled: true,
      corpId: "YOUR_CORP_ID",
      corpSecret: "YOUR_CORP_SECRET",
      agentId: "YOUR_AGENT_ID",
      dmPolicy: "pairing",
      allowFrom: ["your-user-id"],
    },
  },
}

💡 提示：企业微信的 user_id 可在「通讯录」中查看成员的详情页面获取。

第五步：启动网关

# 启动网关
openclaw gateway

# 查看渠道状态
openclaw channels status

📌 图片占位符：[图1：企业微信应用创建流程]

5.2 微信配置

微信是国内用户量最大的通讯工具。由于微信对个人号有较严格的机器人限制，推荐使用以下方案之一：

方案一：使用微信公众号（推荐）

微信公众号提供了相对开放的 API，适合用于接收和回复消息。

第一步：注册微信公众号

访问微信公众平台注册订阅号或服务号
完成认证（个人订阅号无需认证但功能受限）

第二步：获取公众号 API 凭证

在公众平台后台进入「设置与开发」-「基本配置」
记录 AppID 和 AppSecret
配置服务器地址（URL）

第三步：配置 OpenClaw

社区提供了微信公众号插件：

# 安装微信公众号插件（社区方案）
clawhub install wechat-mp

{
  channels: {
    "wechat-mp": {
      enabled: true,
      appId: "YOUR_APP_ID",
      appSecret: "YOUR_APP_SECRET",
      token: "YOUR_TOKEN",
      encodingAesKey: "YOUR_AES_KEY",
    },
  },
}

方案二：使用企业微信个人号

如果已有企业微信账号，可以使用企业微信的「自建应用」功能（见 5.1 节）。

方案三：使用 WeChatFerry（高级方案）

WeChatFerry 是一个开源的微信机器人框架，支持 HTTP API。

第一步：安装 WeChatFerry

# 安装 WeChatFerry RPC 服务
docker pull wechatferry/wcf:latest
docker run -d --name wcf -p 5555:5555 -v $(pwd)/wcf:/home/wcf/.wcf wechatferry/wcf

第二步：配置 OpenClaw

# 安装微信插件
clawhub install wechat-ferry

{
  channels: {
    "wechat-ferry": {
      enabled: true,
      rpcUrl: "http://localhost:5555",
      dmPolicy: "pairing",
      allowFrom: ["your-wechat-id"],
    },
  },
}

⚠️ 注意：微信对机器人有严格限制，请确保遵守微信使用规范，避免账号被封禁。

5.3 钉钉配置

钉钉是阿里巴巴推出的企业通讯工具，提供了完善的开发者 API。

第一步：创建钉钉应用

登录钉钉开放平台
进入「应用开发」-「企业内部开发」
点击「创建应用」
填写应用名称和描述，上传应用图标
创建完成后进入应用详情

第二步：获取 AppKey 和 AppSecret

在应用详情页的「凭证与密钥」部分
记录 AppKey 和 AppSecret

第三步：配置机器人

在应用详情页进入「消息推送」
开启「接收消息」
设置回调地址（服务器 URL）

第四步：配置 OpenClaw

方案 A：使用钉钉 Webhook（社区方案）

# 安装钉钉插件
clawhub install dingtalk

{
  channels: {
    dingtalk: {
      enabled: true,
      appKey: "YOUR_APP_KEY",
      appSecret: "YOUR_APP_SECRET",
      agentId: "YOUR_AGENT_ID",
      dmPolicy: "pairing",
      allowFrom: ["your-user-id"],
    },
  },
}

方案 B：使用自定义机器人

如果你只需要简单的群消息推送，可以使用自定义机器人：

在钉钉群设置中添加「智能群助手」
选择「添加机器人」-「自定义机器人」
设置机器人名称和头像
复制 Webhook 地址和加签密钥

{
  channels: {
    "dingtalk-webhook": {
      enabled: true,
      webhookUrl: "https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN",
      secret: "YOUR_SECRET",
    },
  },
}

第五步：启动网关

# 启动网关
openclaw gateway

# 查看渠道状态
openclaw channels status

💡 钉钉用户 ID 获取：在钉钉开放平台的「通讯录」中可以查看企业成员的 userId。

📌 图片占位符：[图2：钉钉应用创建流程]

5.4 安全机制：SecretRef 管理敏感信息

重要：切勿将敏感 Token 明文存储在配置文件中！OpenClaw 提供了 SecretRef 安全机制来管理敏感信息。

使用环境变量

在终端中设置环境变量：

export WECOM_CORP_SECRET="your-wechat-work-corp-secret"
export DINGTALK_APP_SECRET="your-dingtalk-app-secret"
export WECHAT_MP_SECRET="your-wechat-mp-secret"
export OPENAI_API_KEY="your-openai-api-key"

使用 SecretRef 配置

你可以通过命令设置敏感信息：

# 设置企业微信 Secret
openclaw config set channels.wechat-work.corpSecret --ref-provider default --ref-source env --ref-id WECOM_CORP_SECRET

# 设置钉钉 App Secret
openclaw config set channels.dingtalk.appSecret --ref-provider default --ref-source env --ref-id DINGTALK_APP_SECRET

# 设置微信公众号 AppSecret
openclaw config set channels.wechat-mp.appSecret --ref-provider default --ref-source env --ref-id WECHAT_MP_SECRET

# 设置完成后启用渠道
openclaw config set channels.dingtalk.enabled true --strict-json

这样 Token 不会明文存储在配置文件中，更安全。

⚠️ 重要提醒：API 密钥就像密码一样重要，切勿将其提交到公开的代码仓库中！

六、基础使用：发送消息、查看会话与基本命令

6.1 开始对话

配置好渠道后，你就可以开始与 OpenClaw 对话了。不同渠道的触发方式略有不同：

企业微信/钉钉：直接在聊天中 @机器人或使用命令前缀

/ask 请帮我总结一下这篇文档的主要内容

微信：直接发送消息即可

请帮我总结一下这篇文档的主要内容

6.2 状态检查

OpenClaw 提供了丰富的状态检查命令：

# 快速状态检查
openclaw status

# 完整状态报告
openclaw status --all

# 深度检查
openclaw status --deep

# 网关健康检查
openclaw health --json

# 详细健康信息
openclaw health --verbose

6.3 诊断与修复

使用 doctor 命令诊断和修复常见问题：

openclaw doctor

这会自动检测并修复配置问题、依赖问题等。

6.4 日志查看

# 查看实时日志
openclaw logs --follow

# 直接查看日志文件
tail -f /tmp/openclaw/openclaw-*.log

6.5 基本命令一览

OpenClaw 提供了一系列内置命令，以下是一些最常用的：

命令	说明
`openclaw status`	查看系统状态
`openclaw health`	检查网关健康
`openclaw doctor`	诊断和修复问题
`openclaw gateway`	启动网关
`openclaw gateway start`	启动网关服务
`openclaw gateway stop`	停止网关服务
`openclaw gateway restart`	重启网关服务
`openclaw gateway status`	查看网关状态
`openclaw channels status`	查看渠道状态
`openclaw channels status --probe`	深度探测渠道

6.6 进阶对话技巧

多轮对话

OpenClaw 支持多轮对话，会自动记住对话上下文。你不需要每次都重复背景信息：

你：帮我写一个 Python 函数来计算斐波那契数列
AI：[生成代码]

你：能加上错误处理吗？
AI：[在原有代码基础上添加错误处理]

使用提示词定制回复风格

你可以通过系统提示词来定制 AI 的回复风格：

/system 你是一位专业的技术作家，回答问题时喜欢用简洁的语言和代码示例。

七、更新与维护

7.1 更新 OpenClaw

# 更新到最新版本
openclaw update

# 检查更新状态
openclaw update status

# 切换到稳定版
openclaw update --channel stable

# 切换到测试版
openclaw update --channel beta

# 切换到开发版
openclaw update --channel dev

7.2 技能管理：ClawHub

ClawHub 是 OpenClaw 的技能管理系统，可以安装和管理各种技能：

# 安装技能
clawhub install <skill-slug>

# 更新所有技能
clawhub update --all

# 列出可用技能
clawhub list

7.3 定期维护

建议定期运行以下命令保持系统健康：

# 诊断检查
openclaw doctor

# 查看完整状态
openclaw status --all

# 更新到最新版本
openclaw update

八、简单自动化：定时任务与 Cron 配置

OpenClaw 的定时任务功能可以让你设置在特定时间自动执行某些操作，这对于提醒、摘要、自动化报告等场景非常有用。

8.1 理解 Cron 表达式

Cron 是类 Unix 系统中常用的定时任务表达式，它由5个字段组成：

┌───────────── 分钟 (0 - 59)
│ ┌───────────── 小时 (0 - 23)
│ │ ┌───────────── 日期 (1 - 31)
│ │ │ ┌───────────── 月份 (1 - 12)
│ │ │ │ ┌───────────── 星期 (0 - 6，0 = 周日)
│ │ │ │ │
* * * * *

一些常用示例：

Cron 表达式	含义
`0 9 * * *`	每天早上 9 点
`0 9 * * 1-5`	工作日早上 9 点
`0 /2 * *`	每隔 2 小时
`0 0 1 * *`	每月 1 日午夜
`/15 * * *`	每 15 分钟

8.2 定时任务命令

# 列出定时任务
openclaw cron list

# 强制运行任务
openclaw cron run <jobId> --force

# 查看任务运行记录
openclaw cron runs --id <jobId>

九、进阶技巧：多 Agent 协作与插件系统

9.1 多 Agent 协作

OpenClaw 支持创建多个专业化的 AI 代理，每个代理可以有不同的角色、技能和知识领域。这种设计让你可以构建一个完整的 AI 团队。

代理管理命令

# 添加新代理
openclaw agents add <name>

# 列出代理
openclaw agents list

当用户发送请求时，协调者代理会分析任务需求，自动调用合适的专业代理。

9.2 插件系统

OpenClaw 的插件系统是其最强大的扩展功能。通过插件，你可以添加全新的功能，比如天气查询、股票信息、翻译服务等。

注意：具体的插件管理命令和配置方法请参考官方文档。

十、常见问题与解决方案

10.1 安装问题

问题：安装后 openclaw 命令无法识别

解决方案： 1. 将 npm 全局 bin 目录添加到 PATH 2. 重新加载 shell 配置：source ~/.bashrc 或 source ~/.zshrc 3. 检查安装是否成功：which openclaw

问题：安装卡住

解决方案：使用 verbose 模式查看详细信息：

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

10.2 连接问题

问题：企业微信机器人无响应

排查步骤： 1. 确认 CorpID 和 Secret 正确 2. 检查是否正确启动了企业微信渠道 3. 查看日志中的错误信息：openclaw logs --follow | grep wechat 4. 运行诊断：openclaw doctor 5. 检查企业微信后台的 API 回调是否配置正确

问题：微信连接断开

解决方案：

openclaw doctor
openclaw logs --follow

# 如需重新登录（如使用 WeChatFerry）:
openclaw channels login --channel wechat-ferry

问题：钉钉机器人无响应

排查步骤： 1. 确认 AppKey 和 AppSecret 正确 2. 检查是否正确启动了钉钉渠道 3. 查看日志中的错误信息：openclaw logs --follow | grep dingtalk 4. 运行诊断：openclaw doctor 5. 检查钉钉开放平台的回调地址是否可访问

10.3 网关问题

问题：网关无法启动

排查步骤：

openclaw status           # 查看状态
openclaw doctor           # 运行诊断
openclaw logs --follow    # 查看日志

10.4 API 相关问题

问题：API 返回 429 错误

原因：表示配额/速率限制已用完 解决方案： 1. 等待配额重置 2. 升级 API 订阅计划 3. 设置 fallback 模型

十一、总结与资源链接

11.1 本指南小结

恭喜你！通过本文的学习，你已经掌握了 OpenClaw 的核心概念和基本使用方法。我们从什么是 OpenClaw 讲起，涵盖了环境准备、安装配置、渠道连接、日常使用、自动化任务、进阶功能以及常见问题的解决。

现在，你应该能够： - ✅ 在自己的服务器上成功部署 OpenClaw - ✅ 配置至少一个通讯渠道（微信/企业微信/钉钉） - ✅ 连接大语言模型 API 并进行对话 - ✅ 创建定时任务实现自动化 - ✅ 使用 SecretRef 安全机制管理敏感信息 - ✅ 排查和解决常见问题

11.2 下一步探索

掌握基础后，你可以继续探索以下高级主题：

深入学习代理系统：构建复杂的多代理工作流
开发自定义插件：将你的创意变成可分享的插件
集成更多服务：连接日历、邮件、云存储等服务
性能优化：针对大规模使用进行优化
社区贡献：参与 OpenClaw 社区，贡献代码和插件

11.3 资源链接

资源	链接
官方网站	https://openclaw.ai
GitHub 仓库	https://github.com/openclaw/openclaw
官方文档	https://docs.openclaw.ai
技能市场	https://clawhub.com
钉钉社区	https://page.dingtalk.com/wow/dingtalk/act/index
问题反馈	https://github.com/openclaw/openclaw/issues

11.4 快速命令速查表

# 初始化与配置
openclaw onboard                    # 初始化向导
openclaw configure                  # 重新配置
openclaw dashboard                  # 打开控制面板

# 网关管理
openclaw gateway                    # 启动网关
openclaw gateway start              # 启动网关服务
openclaw gateway stop               # 停止网关服务
openclaw gateway restart            # 重启网关服务
openclaw gateway status             # 查看网关状态

# 状态检查
openclaw status                     # 快速状态检查
openclaw status --all               # 完整状态报告
openclaw health --json              # 网关健康检查
openclaw doctor                     # 诊断和修复

# 渠道管理
openclaw channels status            # 渠道状态
openclaw channels login --channel wechat-work  # 登录企业微信
openclaw channels login --channel dingtalk      # 登录钉钉
openclaw channels logout --channel <name>       # 退出渠道

# 配对管理
openclaw pairing list wechat-work          # 列出企业微信配对请求
openclaw pairing approve wechat-work <CODE> # 批准企业微信配对

# 日志
openclaw logs --follow              # 实时查看日志

# 更新与维护
openclaw update                     # 更新到最新版本
openclaw update status              # 检查更新状态

# 技能管理
clawhub install <skill>             # 安装技能
clawhub update --all                # 更新所有技能
clawhub list                        # 列出可用技能

# 定时任务
openclaw cron list                  # 列出定时任务
openclaw cron run <jobId> --force   # 强制运行任务

本指南会随着 OpenClaw 版本更新而持续更新。

祝你使用愉快！ 🚀

AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

AI降噪+消回音+定向拾音：AU-60 全面破解矿山井下语音“听不清、叫不应”难题

AI Agent技术社区

企业400热线融合AI语音机器人：全流程客服提效技术落地解析

AI Agent技术社区

AI语音机器人双引擎实战：接听+外呼联动，搭配号码认证+闪信提升外呼有效率

AI Agent技术社区

所有评论(0)

查看更多评论

Openclaw2026

@Openclaw2026

已为社区贡献11条内容

OpenClaw 入门指南：从零开始搭建个人 AI 助手

Openclaw2026

一、引言：什么是 OpenClaw，为什么需要它

1.1 OpenClaw 是什么

1.2 为什么你需要 OpenClaw

1.3 OpenClaw 的核心特性

二、环境准备：系统要求与 Node.js 安装

2.1 系统要求

2.2 Node.js 安装

在 macOS 上安装

在 Ubuntu/Debian 上安装

在 Windows 上安装

2.3 推荐安装 Git

三、安装 OpenClaw：快速入门

3.1 标准安装（推荐）

macOS / Linux 标准安装

Windows 安装 (PowerShell)

Beta 版本安装

开发者安装（从源码）

3.2 目录结构初识

四、初始配置：onboard 向导

4.1 启动初始化向导

4.2 配置文件说明

最小配置

推荐入门配置

完整配置示例

五、渠道连接：微信/企业微信/钉钉配置

5.1 企业微信配置

第一步：创建企业微信应用

第二步：获取 CorpID 和 Secret

第三步：配置应用接收消息

第四步：配置 OpenClaw

第五步：启动网关

5.2 微信配置

方案一：使用微信公众号（推荐）

方案二：使用企业微信个人号

方案三：使用 WeChatFerry（高级方案）

5.3 钉钉配置

第一步：创建钉钉应用

第二步：获取 AppKey 和 AppSecret

第三步：配置机器人

第四步：配置 OpenClaw

第五步：启动网关

5.4 安全机制：SecretRef 管理敏感信息

使用环境变量

使用 SecretRef 配置

六、基础使用：发送消息、查看会话与基本命令

6.1 开始对话

6.2 状态检查

6.3 诊断与修复

6.4 日志查看

6.5 基本命令一览

6.6 进阶对话技巧

多轮对话

使用提示词定制回复风格

七、更新与维护

7.1 更新 OpenClaw

7.2 技能管理：ClawHub

7.3 定期维护

八、简单自动化：定时任务与 Cron 配置

8.1 理解 Cron 表达式

8.2 定时任务命令

九、进阶技巧：多 Agent 协作与插件系统

9.1 多 Agent 协作

代理管理命令

9.2 插件系统

十、常见问题与解决方案

10.1 安装问题

问题：安装后 openclaw 命令无法识别

问题：安装卡住

10.2 连接问题

问题：企业微信机器人无响应

问题：微信连接断开

问题：钉钉机器人无响应

10.3 网关问题

问题：网关无法启动

10.4 API 相关问题

问题：API 返回 429 错误

十一、总结与资源链接

11.1 本指南小结