养虾指南
OpenClaw System Guide

给虾喂上大脑、嘴巴和手脚

龙虾装好了,但它还不会说话也不会思考。你需要做三件事:① 配一个大模型 API Key 当大脑,② 接一个通信工具当嘴巴,③ 装上 Skills 当手脚。喂完这三样,你的虾就活了。

云平台一键部署的用户?

如果你是通过腾讯云、阿里云等云平台一键部署的,大模型和通信工具通常已经在部署流程中配置完成了。请直接回到你的云平台教程确认:

第一步:选一个大模型当大脑

OpenClaw 支持几乎所有主流大模型。国内用户推荐 DeepSeek 或 GLM-5 起步,海外用户选 Claude 或 GPT

不知道选哪个?

入门首选 DeepSeek——价格最低、中文效果好、注册送额度、配置最简单。先跑起来再说,后面随时可以换。

DeepSeek

性价比之王国内+海外

国产大模型新锐,价格极低、中文效果好,社区推荐的入门首选。新注册送免费额度

价格极低中文效果好新注册送额度OpenAI 兼容接口¥1/百万 token,新注册送额度

详细步骤

  1. 1访问 platform.deepseek.com,点击右上角「注册」
  2. 2使用手机号注册,完成短信验证
  3. 3进入控制台,左侧菜单选择「API Keys」
  4. 4点击「创建 API Key」,给 Key 取个名字(如 "我的龙虾")
  5. 5复制生成的 Key(格式:sk-xxxxxxxx),妥善保存,此 Key 只显示一次
  6. 6回到 OpenClaw,打开 .env 文件,填入下方配置

.env 配置

LLM_PROVIDER=deepseek
LLM_API_KEY=sk-your-deepseek-key
LLM_MODEL=deepseek-chat
去注册

GLM-5(智谱)

Agent 首选国内

智谱 AI 旗舰模型,Agent 长程规划和工具调用能力突出,中文理解能力强,养虾社区推荐度最高

Agent 规划强工具调用优秀中文理解好社区推荐度高按平台计费,新用户有免费体验额度

详细步骤

  1. 1访问 open.bigmodel.cn,点击「开始使用」注册账号
  2. 2完成实名认证(需身份证,约 1-2 分钟通过)
  3. 3认证通过后进入控制台,点击左侧「API Keys」
  4. 4点击「创建 API Key」,复制生成的 Key
  5. 5注意接口基址为 open.bigmodel.cn/api/paas/v4/(与 OpenAI 格式不同)
  6. 6打开 OpenClaw 的 .env 文件,填入下方配置

.env 配置

LLM_PROVIDER=zhipu
LLM_API_KEY=your-glm-api-key
LLM_MODEL=glm-5
LLM_API_BASE=https://open.bigmodel.cn/api/paas/v4/
去注册

MiniMax 2.5

响应快国内

MiniMax 最新模型,响应速度快、兼容 OpenAI 接口格式,通用 Agent 场景表现稳定

响应速度快OpenAI 兼容通用 Agent 稳定接入简单按平台计费,有免费体验额度

详细步骤

  1. 1访问 platform.minimaxi.com,注册账号
  2. 2完成实名认证
  3. 3进入控制台,找到「API Key 管理」
  4. 4创建新的 API Key 并复制
  5. 5确认接口基址为 api.minimaxi.com/v1
  6. 6打开 OpenClaw 的 .env 文件,填入下方配置

.env 配置

LLM_PROVIDER=minimax
LLM_API_KEY=your-minimax-key
LLM_MODEL=minimax-2.5
LLM_API_BASE=https://api.minimaxi.com/v1
去注册

Qwen-Max(通义千问)

阿里生态国内

阿里云旗下大模型,中文理解能力强,适合企业场景,与阿里云生态深度集成

中文理解强企业级稳定阿里云生态价格合理¥2/百万 token

详细步骤

  1. 1访问 dashscope.console.aliyun.com,用阿里云账号登录(没有则注册)
  2. 2开通「模型服务灵积」(DashScope),同意服务协议
  3. 3进入控制台,点击「API Key 管理」
  4. 4点击「创建新的 API Key」,复制生成的 Key(sk-xxxxxxxx 格式)
  5. 5打开 OpenClaw 的 .env 文件,填入下方配置

.env 配置

LLM_PROVIDER=openai
LLM_API_KEY=sk-your-qwen-key
LLM_MODEL=qwen-max
LLM_API_BASE=https://dashscope.aliyuncs.com/compatible-mode/v1
去注册

Claude Opus 4.6 / Sonnet 4.6

代码最强海外

Anthropic 最新模型系列,代码能力和复杂推理业界领先。Opus 4.6 旗舰级,Sonnet 4.6 性价比高

代码能力最强复杂推理优秀长文本理解双版本可选按平台计费,国内需代理访问

详细步骤

  1. 1访问 console.anthropic.com,点击「Sign Up」注册账号
  2. 2完成邮箱验证和手机号验证
  3. 3进入控制台,点击左侧「API Keys」
  4. 4点击「Create Key」,给 Key 命名
  5. 5复制生成的 Key(格式:sk-ant-api03-xxxxxxxx),此 Key 只显示一次
  6. 6注意:国内用户可能需要 API 代理,或选择国产模型替代
  7. 7打开 OpenClaw 的 .env 文件,填入下方配置

.env 配置

LLM_PROVIDER=anthropic
LLM_API_KEY=sk-ant-api03-your-key
LLM_MODEL=claude-opus-4-6
# 或性价比之选:LLM_MODEL=claude-sonnet-4-6
国内用户访问可能需要 API 代理服务。如嫌麻烦,建议直接用 DeepSeek 或 GLM-5 等国产模型,中文效果更好、延迟更低。
去注册

GPT-5.2

全球通用海外

OpenAI 最新模型,多模态能力强,全球开发者生态最成熟,海外场景首选

多模态能力生态最成熟海外首选插件丰富按平台计费,国内需代理访问

详细步骤

  1. 1访问 platform.openai.com,注册或登录账号
  2. 2进入「API keys」页面
  3. 3点击「Create new secret key」,给 Key 命名
  4. 4复制生成的 Key(格式:sk-proj-xxxxxxxx),此 Key 只显示一次
  5. 5注意:国内用户可能需要 API 代理,或选择国产模型替代
  6. 6打开 OpenClaw 的 .env 文件,填入下方配置

.env 配置

LLM_PROVIDER=openai
LLM_API_KEY=sk-proj-your-openai-key
LLM_MODEL=gpt-5.2
国内用户访问可能需要 API 代理服务。如嫌麻烦,建议直接用 DeepSeek 或 GLM-5 等国产模型,中文效果更好、延迟更低。
去注册

验证模型连接

配置好 .env 后,运行测试命令确认 API 连接正常:

cd openclaw
python -m openclaw.test_connection

看到类似输出就说明成功了:

✅ 连接成功!模型: deepseek-chat
   响应: "你好!我是 DeepSeek,很高兴为你服务。"
   耗时: 1.2s
   Token 用量: 输入 12 / 输出 18

第二步:接一个通信工具当嘴巴

选一个你日常使用的通信工具接上,这样你就能在聊天窗口里直接跟龙虾对话、下指令

不知道选哪个?

国内用户推荐飞书——配置简单、文档完善、个人免费用。海外用户推荐 Telegram——只需要一个 Token,30 秒搞定。

飞书

推荐难度:简单国内

字节系办公平台,机器人能力完善,企业用户和个人开发者均可使用。配置流程简单,社区教程多

配置简单企业/个人均可文档丰富社区推荐

详细步骤

  1. 1访问 open.feishu.cn,登录你的飞书账号
  2. 2点击「创建企业自建应用」,填写应用名称(如 "我的龙虾")
  3. 3在应用详情页,找到「凭证与基础信息」,复制 App ID 和 App Secret
  4. 4左侧菜单选择「机器人」,点击开启机器人能力
  5. 5在「事件订阅」中配置回调地址为你的 OpenClaw 地址(如 http://你的IP:3210/api/feishu)
  6. 6获取 Verification Token(事件订阅页面可见)
  7. 7打开 OpenClaw 的 .env 文件,填入下方配置
  8. 8发布应用版本,在飞书中搜索你的机器人名称,发消息测试

.env 配置

# 飞书机器人
FEISHU_APP_ID=cli_your_app_id
FEISHU_APP_SECRET=your_app_secret
FEISHU_VERIFICATION_TOKEN=your_verification_token
FEISHU_ENCRYPT_KEY=your_encrypt_key  # 可选,开启加密时填写
去配置

企业微信

企业首选难度:中等国内

腾讯企业通讯平台,适合已有企业微信的团队。可直接在工作台对话,成员管理方便

企业级安全成员管理方便与微信互通工作台集成

详细步骤

  1. 1访问 work.weixin.qq.com,使用管理员账号登录企业微信管理后台
  2. 2进入「应用管理」→「自建」,点击「创建应用」
  3. 3填写应用名称和 Logo,选择可见范围(建议先选少量测试人员)
  4. 4创建完成后,在应用详情页找到 AgentID 和 Secret
  5. 5在「我的企业」页面找到企业 ID(CorpID)
  6. 6在应用设置中配置「接收消息」的回调 URL(如 http://你的IP:3210/api/wecom)
  7. 7设置 Token 和 EncodingAESKey(系统自动生成,记录下来)
  8. 8打开 OpenClaw 的 .env 文件,填入下方配置

.env 配置

# 企业微信
WECOM_CORP_ID=your_corp_id
WECOM_AGENT_ID=your_agent_id
WECOM_SECRET=your_secret
WECOM_TOKEN=your_callback_token
WECOM_ENCODING_AES_KEY=your_encoding_aes_key
去配置

钉钉

阿里系难度:中等国内

阿里系办公平台,企业内部应用接入,适合已使用钉钉的团队,支持群机器人和单聊

企业内部应用群机器人单聊支持阿里云集成

详细步骤

  1. 1访问 open.dingtalk.com,用钉钉扫码登录开放平台
  2. 2点击「创建应用」,选择「企业内部应用」→「机器人」
  3. 3填写应用名称和描述,完成创建
  4. 4在应用详情页,找到 AppKey 和 AppSecret
  5. 5进入「机器人与消息推送」,开启机器人配置
  6. 6配置消息接收地址为 OpenClaw 回调地址(如 http://你的IP:3210/api/dingtalk)
  7. 7在「权限管理」中添加需要的权限(至少:企业内机器人发送消息)
  8. 8打开 OpenClaw 的 .env 文件,填入下方配置

.env 配置

# 钉钉机器人
DINGTALK_APP_KEY=your_app_key
DINGTALK_APP_SECRET=your_app_secret
去配置

微信(个人号)

进阶难度:较高国内

通过 wcferry 等桥接工具接入微信个人号。配置相对复杂,有封号风险,建议有经验后再尝试

个人微信直聊需桥接工具有一定风险建议进阶用户

详细步骤

  1. 1确认你有一个不太重要的微信号用于测试(有封号风险,不建议用主号)
  2. 2安装 wcferry 桥接工具(需要 Windows 环境或 Windows 虚拟机)
  3. 3下载 wcferry 对应版本的微信客户端(版本必须匹配)
  4. 4启动 wcferry 服务,登录微信
  5. 5在 OpenClaw 中配置 wcferry 连接地址
  6. 6打开 .env 文件,填入下方配置
  7. 7给你的微信号发消息测试是否正常回复

.env 配置

# 微信接入(需配合 wcferry 桥接工具)
WECHAT_ENABLED=true
WECHAT_WCFERRY_API=http://localhost:10086
微信个人号接入存在封号风险,请使用不重要的小号测试。入门用户强烈建议先用飞书或企微。
去配置

Telegram

海外首选难度:简单海外

全球最流行的即时通讯之一,Bot API 开放成熟,配置最简单——只需要一个 Token

配置最简单只需一个 TokenBot 生态成熟海外用户首选

详细步骤

  1. 1在 Telegram 中搜索 @BotFather,开始对话
  2. 2发送 /newbot,按提示设置机器人名称和用户名
  3. 3BotFather 会返回一个 Bot Token(格式:123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
  4. 4复制这个 Token,妥善保存
  5. 5打开 OpenClaw 的 .env 文件,填入下方配置
  6. 6重启 OpenClaw,在 Telegram 中找到你的 Bot,发消息测试

.env 配置

# Telegram Bot
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz
去配置

第三步:装上 Skills 当手脚

Skills 是龙虾的能力插件——搜索网页、操作文件、发消息、跑自动化,都靠 Skills 实现。没有 Skills 的虾只会聊天

入门推荐安装的 Skills

先装这几个最常用的:网页搜索(search)、文件操作(file-manager)、代码执行(code-runner)。装完就能覆盖 80% 的日常场景。

如何安装 Skills

OpenClaw 的 Skills 通过命令行安装,一行命令搞定。也可以在 OpenClaw 管理面板的技能商店中一键安装。

命令行安装示例

安装搜索技能

openclaw skill install @openclaw/search

安装文件管理技能

openclaw skill install @openclaw/file-manager

查看已安装的技能

openclaw skill list

想浏览更多 Skills?去技能商店看看全部 5400+ 可用技能,按分类筛选、一键安装:

浏览全部技能 →

喂好了!去看看别人怎么养虾

你的龙虾已经有了大脑、嘴巴和手脚——能思考、能说话、能干活了。去看看真实案例,了解别人都在用龙虾做什么:自动运营小红书、邮件自动处理、代码审查……找到属于你的养虾姿势。