跳转到内容

快速开始 — 5 分钟上手你的第一个 AI Agent

  • Node.js 18+(运行 node -v 检查)
  • 一个消息平台账号(Telegram、Discord、飞书等)
  • 一个 LLM API Key(OpenAI、Anthropic、智谱、Kimi 等均可)
Terminal window
npm install -g openclaw

验证安装:openclaw --version

Terminal window
openclaw init

这会创建 ~/.openclaw/ 目录,包含:

  • openclaw.json — 主配置文件
  • workspace/ — Agent 工作空间(AGENTS.md、SOUL.md、MEMORY.md)
Terminal window
# 方案 A:OpenAI
openclaw config set model '"gpt-4o"' --json
export OPENAI_API_KEY="你的密钥"
# 方案 B:Anthropic
openclaw config set model '"claude-sonnet-4"' --json
export ANTHROPIC_API_KEY="你的密钥"
# 方案 C:国内模型(智谱 GLM)
openclaw config set model '"glm-4"' --json
openclaw config set provider.baseUrl '"https://open.bigmodel.cn/api/paas/v4"' --json
# 方案 D:任意 OpenAI 兼容 API(中转站等)
openclaw config set provider.baseUrl '"https://your-relay.com/v1"' --json
Terminal window
openclaw channels add
# 选择平台 → 按提示操作
平台上手难度指南
Telegram⭐⭐⭐ 最简单Telegram 配置
飞书 / Lark⭐⭐⭐ 推荐飞书配置
Discord⭐⭐⭐Discord 配置
WhatsApp⭐⭐WhatsApp 配置
网页版内置openclaw gateway → 访问 localhost
Terminal window
openclaw gateway

向你的 Bot 发一条消息,你会收到配对码:

Terminal window
openclaw pairing list <channel>
openclaw pairing approve <channel> <配对码>

搞定了! 你的 AI Agent 已上线。🎉