📖 简介

OpenClaw（小龙虾） 是一个开源、可自托管的个人 AI 智能体（AI Agent），由 openclaw.ai 团队开发，MIT 协议开源。你可以把它理解为一个运行在自己设备上的 AI 助理，通过你日常使用的聊天软件和你交互。

它能做什么？

• 多平台聊天：接入 WhatsApp、Telegram、Discord、微信、QQ、飞书、钉钉等 20+ 平台
• 自动处理任务：清理收件箱、发送邮件、管理日历、网页搜索
• 自定义 Skills：安装社区技能插件，扩展无限能力
• 多模型支持：支持 OpenAI、Anthropic、Ollama、通义千问、DeepSeek 等 30+ 模型提供商
• 自动化工作流：Cron 定时任务、Webhook 触发、Slash 命令

适用场景

🔧 环境准备

硬件要求

软件要求

• Node.js：Node 24（推荐）或 Node 22.19+
• npm / pnpm / bun（任选其一）
• 一个 LLM API Key（OpenAI / Anthropic / DeepSeek / 通义千问 等）

检查环境

1
2
3
4
5
6
7

# 检查 Node 版本（需 ≥ 22.19）
node --version

# 检查 npm 版本
npm --version

# 如果没有 Node.js，先去 https://nodejs.org 安装 v24+

📦 安装 OpenClaw

方式一：一键脚本安装（推荐）

这是最快的方式，自动安装 Node.js（如果缺失）和 OpenClaw：

1
2
3
4
5

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

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

方式二：npm 全局安装

如果你已经装好了 Node.js：

1
2
3
4

npm install -g openclaw@latest

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

方式三：Docker 安装

适合服务器部署：

1
2
3
4
5
6

docker pull openclaw/openclaw:latest
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

验证安装

1
2
3
4

# 查看版本
openclaw --version

# 应该能看到版本号输出

🚀 初始化配置（Onboarding）

装完后运行初始化向导，它会带你完成核心配置：

1

openclaw onboard --install-daemon

--install-daemon 参数会安装系统服务（macOS 用 launchd，Linux 用 systemd user service），让 Gateway 保持后台运行。

向导会问你什么？

1. 选择模型提供商 — 选你有的 API Key 对应的厂商
2. 输入 API Key — 粘贴你的 Key
3. 选择模型 — 默认选旗舰模型就好
4. Gateway 端口 — 默认 18789，一般不用改

手动配置（跳过向导）

Onboarding 生成的配置文件在 ~/.openclaw/config.yaml，你可以直接编辑：

1
2
3
4
5
6
7
8
9
10

# ~/.openclaw/config.yaml 示例
gateway:
  port: 18789
  host: 0.0.0.0

models:
  default:
    provider: openai
    model: gpt-4o
    apiKey: sk-xxxxx

✅ 验证运行状态

检查 Gateway

1

openclaw gateway status

如果正常运行，你应该看到：

1

Gateway is running on port 18789

打开仪表盘（Web UI）

1

openclaw dashboard

这会自动在浏览器打开控制台界面。如果能加载出来，说明一切正常。

诊断检查

1

openclaw doctor

运行健康检查，会输出各部分的状态：

1
2
3
4
5

✔ Node.js version: 24.x
✔ OpenClaw version: latest
✔ Gateway: running (port 18789)
✔ Config: valid
✔ API key: configured

💬 基础使用

发送第一条消息

在仪表盘 Web UI 的聊天框里输入消息，AI 会回复你。

命令行发送

1
2
3
4
5

# 直接提问
openclaw agent --message "帮我写一封邮件"

# 设置推理强度
openclaw agent --message "分析这份数据" --thinking high

通过渠道消息发送

1
2

# 发送到指定手机号（需先配对）
openclaw message send --target +861234567890 --message "你好，小龙虾！"

🔌 接入聊天平台

OpenClaw 支持 20+ 平台，这里列几个常见的：

Telegram（最快接入）

只需要一个 Bot Token，几分钟搞定：

1. 在 Telegram 搜 @BotFather，创建 Bot，拿到 Token
2. 把 Token 填到 OpenClaw 配置的 channels 里
3. 给你的 Bot 发消息，AI 直接回复

微信 / QQ

微信接入需要企业微信通道，QQ 通过 QQ Bot API 接入。具体看官方文档。

Discord / Slack

• Discord：创建 Bot 应用 → 获取 Token → 邀请进服务器
• Slack：创建 Slack App → 配置 Event Subscriptions → 安装到工作区

🧩 Skills（技能系统）

Skills 是 OpenClaw 的插件系统，让 Agent 能做更多事情：

查看已安装技能

1

openclaw skills list

安装技能

1
2
3
4
5

# 从 ClawHub 安装
openclaw skills install web-search

# 安装多个
openclaw skills install weather calendar email

社区技能

• ClawHub（官方市场）：https://clawhub.ai/
• SkillsBot 中文镜像站：国内用户可用的中文资源站

常用技能推荐

⚙️ 进阶配置

多模型配置

支持按场景配置不同模型，并设置故障切换：

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

models:
  chat:
    provider: openai
    model: gpt-4o
    apiKey: sk-xxx
  coding:
    provider: anthropic
    model: claude-sonnet-4
    apiKey: sk-ant-xxx
  fallback:
    provider: deepseek
    model: deepseek-chat
    apiKey: sk-xxx

Cron 定时任务

1
2

# 每天早上 8 点推送天气
openclaw cron create --schedule "0 8 * * *" --task "查询今日天气并推送到 Telegram"

Gateway 公网暴露

如果想让 OpenClaw 能从外网访问，建议配合 Tailscale 或 Cloudflare Tunnel：

1
2
3
4
5

# Tailscale
tailscale serve --bg 18789

# Cloudflare Tunnel
cloudflared tunnel --url http://localhost:18789

❓ 常见问题

Q：安装报错 Permission denied

1
2
3

# 不要用 sudo 装 npm 包，而是配置 npm 前缀
npm config set prefix ~/.npm
export PATH="$HOME/.npm/bin:$PATH"

Q：Gateway 启动失败

1
2
3
4
5
6
7
8

# 检查端口占用
lsof -i :18789

# 查看详细日志
openclaw gateway --verbose

# 更换端口
openclaw gateway --port 18790

Q：模型 API 连接不上

1. 确认 API Key 正确且有余额
2. 国内环境需要代理或使用国内模型（通义千问 / DeepSeek）
3. 在配置中设置代理：

1
2

gateway:
  proxy: http://127.0.0.1:7890

Q：如何更新 OpenClaw？

1
2

npm update -g openclaw
openclaw doctor  # 检查更新后状态

Q：中文支持怎么样？

完美支持。Onboarding 向导有中文提示，文档有完整中文版（感谢 鱼皮 翻译），配置里可以直接用中文描述。

Q：占用资源大吗？

空载时约 200-400MB 内存，调用模型时增加。树莓派 4B 可以流畅运行。

📚 相关链接

📚 参考来源

本文部分内容参考了以下官方资料：