养虾日记:OpenClaw 新手入门指南

欢迎加入 OpenClaw！这是一份为零基础用户准备的完整入门教程，预计 30 分钟即可完成配置。

📖 目录

1. OpenClaw 是什么？
2. 安装前的准备
3. 一键安装
4. 初始化配置
5. 飞书渠道接入
6. 核心概念速览
7. 新手常见问题
8. 进阶学习资源

OpenClaw 是什么？

OpenClaw 是一款开源个人 AI 助手，可以帮你：

• ✅ 自动化处理任务 - 日程管理、数据整理、文档撰写
• ✅ 多平台消息集成 - 飞书、Telegram、微信等统一接入
• ✅ AI 模型协作 - 支持阿里云百炼、Claude、OpenAI 等多种模型
• ✅ 技能扩展 - 通过 Skill 系统无限扩展能力

适合谁用？

• 想提升工作效率的职场人
• 需要处理大量信息和消息的用户
• 想要个性化 AI 助手的人

安装前的准备

① 检查 Node.js 版本

OpenClaw 需要 Node.js ≥ 22.0.0

# 检查当前版本
node --version

# 如果版本过低，使用 nvm 升级（推荐）
nvm install 22
nvm use 22

② 准备 AI 模型 API Key

国内用户推荐：阿里云百炼

• 新用户有免费额度
• 访问：https://bailian.console.aliyun.com/
• 注册后在「API-KEY 管理」中创建密钥

海外用户可选：

• Anthropic Claude: https://console.anthropic.com/
• OpenAI: https://platform.openai.com/

本地模型（无需 API Key）：

• 使用 Ollama 运行本地模型
• 适合对隐私要求高的场景

③ 网络环境（国内用户）

建议配置代理或使用国内镜像源，避免依赖下载失败。

一键安装 🚀

最快方式（推荐）

macOS / Linux / WSL2：

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

Windows（PowerShell）：

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

📦 NPM 安装（备选）

npm install -g openclaw

# 验证安装
openclaw --version

🐳 Docker 部署（高级用户）

# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器（挂载本地配置目录）
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

初始化配置

安装完成后，运行 openclaw 启动初始化向导：

openclaw

向导会引导你完成：

1. 模型配置 - 输入 AI 模型 API Key
2. 消息渠道 - 选择要接入的平台（飞书/Telegram 等）
3. 凭证管理 - OAuth 授权（自动完成）

配置完成后，系统会自动打开新手引导聊天会话，AI 助手将自我介绍并指导后续操作。

飞书渠道接入

方式一：命令行向导（推荐新手）

openclaw channels add

按提示操作：

1. 选择渠道类型：Feishu（国内）或 Lark（国外）
2. 输入飞书应用的 App ID 和 App Secret
3. 选择连接模式：推荐 WebSocket 长连接（内网适用）
4. 配置私聊/群聊策略

方式二：手动修改配置文件

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "YOUR_APP_ID",
      "appSecret": "YOUR_APP_SECRET",
      "connectionMode": "websocket"
    }
  }
}

方式三：命令行逐项设置

openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId YOUR_APP_ID
openclaw config set channels.feishu.appSecret YOUR_APP_SECRET
openclaw config set channels.feishu.connectionMode websocket

核心概念速览

Skills（技能）

OpenClaw 通过 Skill 系统扩展功能，每个 Skill 是独立的功能模块。

Agents（代理）

Agents 是执行具体任务的 AI 实体，可以调用 Skills 完成复杂任务。

Memory（记忆）

OpenClaw 具有持久化记忆功能，跨会话保持上下文连贯性。

新手常见问题

Q: 安装失败怎么办？

A: 检查 Node.js 版本是否 ≥ 22.0.0，确保网络连接稳定。

Q: 如何查看日志？

A: 运行 openclaw logs 查看实时日志。

Q: 飞书连接不稳定？

A: 建议使用 WebSocket 模式，避免 Webhook 模式可能的网络问题。

进阶学习资源

• 官方文档：https://docs.openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
• Discord 社区：https://discord.gg/clawd

🦞 如果遇到问题，欢迎在评论区提问