OpenClaw安装与使用指导

一、OpenClaw 简介

OpenClaw（🦞）是一款开源的个人 AI 助手平台，由 GitHub 10万+ Stars 的社区驱动开发。它运行在你自己的设备上，通过 WhatsApp、Telegram、Discord、Slack 等主流聊天应用与你的 AI 助手交互，帮你处理邮件、日历、文件等日常事务。

核心特性

本地优先: 网关（Gateway）完全本地运行，数据隐私可控
多平台支持: 支持 WhatsApp、Telegram、Discord、Slack、Google Chat、Signal、iMessage、飞书等 10+ 通讯平台
多模型支持: 支持 Anthropic Claude、OpenAI GPT 等主流 LLM
语音交互: 支持 macOS/iOS/Android 的语音唤醒和对话模式
实时画布: 支持 AI 驱动的可视化工作区（Canvas）
技能扩展: 通过 ClawHub 安装各种技能插件

二、安装指南

2.1 环境要求

Node.js: >= 22（必须）
操作系统: macOS、Linux、Windows（通过 WSL2，强烈推荐）
包管理器: npm、pnpm 或 bun

检查 Node.js 版本：

bash

node -v

2.2 官方版本安装

推荐安装方式（使用 npm）：

bash

# 全局安装 OpenClaw
npm install -g openclaw@latest

# 或使用 pnpm
pnpm add -g openclaw@latest

启动初始化向导（推荐）：

bash

openclaw onboard --install-daemon

--install-daemon 参数会自动安装网关守护进程（launchd/systemd 用户服务），确保 OpenClaw 始终运行。

2.3 中文汉化版安装

对于中文用户，社区提供了全中文界面的汉化版本，CLI 命令行和 Dashboard 网页控制台均已深度汉化。安装命令：

bash

npm install -g @qingchencloud/openclaw-zh@latest

特点： 🕐 每小时自动同步官方更新，汉化版延迟 < 1 小时 🌐 全中文界面：Dashboard、CLI、文档全面汉化 📚 中文文档：完整的中文搭建教程和排错指南

2.4 Window用户打包安装

社区提供了 Windows 用户的打包安装版本，免去环境配置烦恼。下载地址：https://claw.ver0.cn/

三、快速上手

3.1 初始化配置

运行 onboard 向导完成初始化：

bash

openclaw onboard --install-daemon

向导会引导你完成：选择 AI 模型（推荐 Anthropic Claude Pro/Max）配置 API 密钥（支持 OAuth 和 API Key 两种方式）设置聊天通道（WhatsApp、Telegram 等）安装守护进程（保持后台运行）

3.2 启动网关

bash

# 启动网关（默认端口 18789）
openclaw gateway --port 18789 --verbose

3.3 基本使用

发送消息测试：

bash

openclaw message send --to +1234567890 --message "Hello from OpenClaw"

与 AI 助手对话：

bash

openclaw agent --message "帮我总结今天的邮件" --thinking high

打开 Web 控制台：

启动网关后，浏览器会自动打开 Dashboard 控制台（http://localhost:18789）。

四、通道配置详解

4.1 Telegram 配置

json

{
  "channels": {
    "telegram": {
      "botToken": "123456:ABCDEF",
      "allowFrom": ["your_telegram_id"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

环境变量方式：

bash

export TELEGRAM_BOT_TOKEN="123456:ABCDEF"

4.2 Discord 配置

json

{
  "channels": {
    "discord": {
      "token": "your_discord_bot_token",
      "dm": {
        "policy": "pairing",
        "allowFrom": []
      },
      "guilds": {
        "your_guild_id": {
          "channels": ["*"]
        }
      }
    }
  }
}

4.3 飞书（Feishu/Lark）配置

安装飞书插件：

bash

openclaw plugins install @m1heng-clawd/feishu

基础配置：

bash

openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw config set channels.feishu.enabled true

完整配置示例：

yaml

channels:
  feishu:
    enabled: true
    appId: "cli_xxxxx"
    appSecret: "secret"
    domain: "feishu"  # 国内版用 "feishu"，国际版用 "lark"
    connectionMode: "websocket"  # 推荐，无需公网地址
    dmPolicy: "pairing"  # 私聊策略：pairing | open | allowlist
    groupPolicy: "allowlist"  # 群聊策略
    requireMention: true  # 群聊是否需要 @机器人
    renderMode: "auto"  # 渲染模式：auto | raw | card

飞书权限申请清单：

权限	说明
`im:message`	发送和接收消息
`im:message.p2p_msg:readonly`	读取私聊消息
`im:message.group_at_msg:readonly`	接收群聊 @消息
`im:message:send_as_bot`	以机器人身份发送
`im:resource`	上传下载媒体文件

重要：必须在飞书开放平台后台配置事件订阅，添加 im.message.receive_v1 事件，否则机器人无法接收消息。

五、模型配置

5.1 推荐模型配置

编辑 ~/.openclaw/openclaw.json：

json

{
  "agent": {
    "model": "anthropic/claude-opus-4-6",
    "thinkingLevel": "high"
  },
  "models": {
    "anthropic": {
      "provider": "anthropic",
      "auth": {
        "type": "oauth"
      }
    }
  }
}

5.2 支持的模型提供商

Anthropic: Claude Pro/Max（推荐，长上下文、抗提示注入能力强）
OpenAI: ChatGPT、Codex
其他: 支持任意兼容 OpenAI API 的模型

5.3 模型故障转移

配置多个模型实现自动故障转移：

json

{
  "models": {
    "failover": [
      "anthropic/claude-opus-4-6",
      "openai/gpt-4"
    ]
  }
}

六、安全与隐私

6.1 默认安全设置

DM 配对模式: 未知发送者会收到配对码，需手动批准后才能对话
批准命令: openclaw pairing approve channel code
安全检查: 运行 openclaw doctor 检查风险配置

6.2 沙盒模式

对于群组/频道消息，建议启用 Docker 沙盒：

json

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

这会为非主会话（群组/频道）创建独立的 Docker 沙盒环境。

6.3 Tailscale 远程访问

配置 Tailscale 实现安全的远程访问：

json

{
  "gateway": {
    "tailscale": {
      "mode": "serve",  // serve（仅 tailnet）或 funnel（公开）
      "resetOnExit": false
    },
    "auth": {
      "mode": "password",
      "password": "your_secure_password"
    }
  }
}

七、技能系统（Skills）

7.1 ClawHub 技能市场

ClawHub 是 OpenClaw 的官方技能注册中心，支持自动搜索和安装技能。访问地址：https://clawhub.ai/skills

7.2 飞书技能集

仓库: m1heng/clawdbot-feishu 飞书插件提供以下工具能力：

工具	功能
`feishu_doc`	读取、创建、编辑飞书文档（支持 Markdown）
`feishu_wiki`	知识库管理：列出空间、搜索、创建/移动节点
`feishu_drive`	云空间管理：文件夹操作、文件上传下载
`feishu_bitable`	多维表格：记录增删改查、字段管理
`feishu_task_*`	任务管理：创建、更新、删除、查询任务

权限申请注意事项：

云空间访问: 机器人没有自己的"我的空间"，必须将文件夹分享给机器人
知识库访问: 必须将机器人添加为知识库成员
多维表格访问: 必须将表格分享给机器人

7.3 自定义技能开发

技能文件位于 ~/.openclaw/workspace/skills/{skill}/SKILL.md。

技能配置文件示例：

json

{
  "skills": {
    "enabled": ["feishu", "browser", "canvas"],
    "feishu": {
      "version": "latest",
      "autoUpdate": true
    }
  }
}

八、高级功能

8.1 语音交互（Voice Wake + Talk Mode）

支持平台: macOS、iOS、Android
功能: 语音唤醒、连续对话、语音播报
配置: 需要 ElevenLabs API 密钥

8.2 实时画布（Canvas）

AI 驱动的可视化工作区，支持：
代码渲染与执行
图像生成与编辑
数据可视化
交互式 UI 组件

8.3 浏览器自动化

json

{
  "browser": {
    "enabled": true,
    "color": "#FF4500"
  }
}

OpenClaw 会管理独立的 Chrome/Chromium 实例，支持截图、点击、表单填写等操作。

8.4 会话管理

常用命令：

/status - 查看会话状态（模型、Token、费用）
/new 或 /reset - 重置会话
/compact - 压缩会话上下文
/think {level} - 设置思考深度（off/minimal/low/medium/high/xhigh）
/verbose on|off - 开关详细输出

九、故障排查

9.1 诊断工具

bash

# 运行健康检查
openclaw doctor

# 查看日志
openclaw logs --follow

# 检查配置
openclaw config validate

9.2 常见问题

Q: 机器人收不到消息？

检查事件订阅配置（飞书/Discord/Telegram 都需要配置 webhook 或长连接）确认权限已申请并审核通过检查 allowFrom 白名单设置

Q: 飞书返回 403 错误？

确认 im:message:send_as_bot 权限已申请检查应用是否已发布（至少测试版本）

Q: Windows 安装报错 spawn npm ENOENT？

bash

# 手动下载安装
curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
openclaw plugins install ./feishu-0.1.3.tgz

Q: 如何升级 OpenClaw？

bash

# 检查更新
openclaw update --channel stable  # stable | beta | dev

# 或直接重装
npm install -g openclaw@latest

十、相关资源

官方资源

官网: https://openclaw.ai
GitHub: https://github.com/openclaw/openclaw
文档: https://docs.openclaw.ai
Discord 社区: https://discord.gg/openclaw

中文社区资源

中文镜像: https://github.com/1186258278/OpenClawChineseTranslation
飞书插件: https://github.com/m1heng/clawdbot-feishu
技能市场: https://clawhub.ai/skills

配置模板

AGENTS.md: 代理行为配置
SOUL.md: 个性化身份设定
TOOLS.md: 工具使用说明
MEMORY.md: 持久化记忆存储

十一、最佳实践

模型选择: 强烈推荐使用 Anthropic Claude Pro/Max (100/200) + Opus 4.6，长上下文能力强，抗提示注入能力更好
安全设置:

生产环境务必设置 dmPolicy: "pairing"
群组使用 requireMention: true 避免误触发
定期运行 openclaw doctor 检查配置

性能优化:

使用 WebSocket 模式（飞书/Discord）减少延迟
启用 dynamicAgentCreation 实现多用户隔离
合理设置 mediaMaxMb 限制媒体文件大小

备份策略:

定期备份 ~/.openclaw/ 目录
重要技能文件使用 Git 管理
配置文件使用 JSON Schema 验证

Happy Clawing! 🦞

本文档基于 OpenClaw 官方文档和中文社区实践整理，如有更新请以官方文档为准。

OpenClaw安装与使用指导 ​

一、OpenClaw 简介 ​

核心特性 ​

二、安装指南 ​

2.1 环境要求 ​

2.2 官方版本安装 ​

2.3 中文汉化版安装 ​

2.4 Window用户打包安装 ​

三、快速上手 ​

3.1 初始化配置 ​

3.2 启动网关 ​

3.3 基本使用 ​

四、通道配置详解 ​

4.1 Telegram 配置 ​

4.2 Discord 配置 ​

4.3 飞书（Feishu/Lark）配置 ​

五、模型配置 ​

5.1 推荐模型配置 ​

5.2 支持的模型提供商 ​

5.3 模型故障转移 ​

六、安全与隐私 ​

6.1 默认安全设置 ​

6.2 沙盒模式 ​

6.3 Tailscale 远程访问 ​

七、技能系统（Skills） ​

7.1 ClawHub 技能市场 ​

7.2 飞书技能集 ​

7.3 自定义技能开发 ​

八、高级功能 ​

8.1 语音交互（Voice Wake + Talk Mode） ​

8.2 实时画布（Canvas） ​

8.3 浏览器自动化 ​

8.4 会话管理 ​

九、故障排查 ​

9.1 诊断工具 ​

9.2 常见问题 ​

十、相关资源 ​

十一、最佳实践 ​

OpenClaw安装与使用指导

一、OpenClaw 简介

核心特性

二、安装指南

2.1 环境要求

2.2 官方版本安装

2.3 中文汉化版安装

2.4 Window用户打包安装

三、快速上手

3.1 初始化配置

3.2 启动网关

3.3 基本使用

四、通道配置详解

4.1 Telegram 配置

4.2 Discord 配置

4.3 飞书（Feishu/Lark）配置

五、模型配置

5.1 推荐模型配置

5.2 支持的模型提供商

5.3 模型故障转移

六、安全与隐私

6.1 默认安全设置

6.2 沙盒模式

6.3 Tailscale 远程访问

七、技能系统（Skills）

7.1 ClawHub 技能市场

7.2 飞书技能集

7.3 自定义技能开发

八、高级功能

8.1 语音交互（Voice Wake + Talk Mode）

8.2 实时画布（Canvas）

8.3 浏览器自动化

8.4 会话管理

九、故障排查

9.1 诊断工具

9.2 常见问题

十、相关资源

十一、最佳实践