OpenClaw配置教程 - API与消息平台接入指南

本教程详细讲解 OpenClaw 的配置方法,包括 AI 模型 API Key 设置、飞书/微信/企业微信等消息平台接入、联网搜索配置以及实用 Skills 推荐,帮你完成从安装到可用的最后一步。


配置 AI 模型 API Key

运行 openclaw config 打开配置文件,在 llm 部分设置:

Claude(Anthropic)

llm:
  provider: anthropic
  model: claude-sonnet-4-6
  api_key: sk-ant-xxxxxxxxxxxxx

API Key 从 Anthropic Console 获取

GPT(OpenAI)

llm:
  provider: openai
  model: gpt-4o
  api_key: sk-xxxxxxxxxxxxx

API Key 从 OpenAI Platform 获取

本地模型(Ollama)

llm:
  provider: ollama
  model: llama3:8b
  base_url: http://localhost:11434

需先安装 Ollama 并下载模型

环境变量方式:也可以通过环境变量设置 API Key,避免明文写入配置文件:export OPENCLAW_LLM_API_KEY=你的Key

接入消息平台

在配置文件的 transports 部分添加平台配置:

飞书

transports:
  feishu:
    enabled: true
    app_id: cli_xxxxxxxxxxxxx
    app_secret: xxxxxxxxxxxxx
    verification_token: xxxxxxxxxxxxx

飞书开放平台创建机器人应用获取凭据

企业微信

transports:
  wecom:
    enabled: true
    corp_id: ww_xxxxxxxxxxxxx
    agent_id: 1000002
    secret: xxxxxxxxxxxxx
    token: xxxxxxxxxxxxx
    encoding_aes_key: xxxxxxxxxxxxx

企业微信管理后台创建自建应用获取

Telegram

transports:
  telegram:
    enabled: true
    bot_token: 123456789:ABCdefGHIjklMNOpqrSTUvwxyz

通过 Telegram 的 @BotFather 创建 Bot 获取 Token

WhatsApp

transports:
  whatsapp:
    enabled: true

启动后会显示二维码,用 WhatsApp 扫码即可连接

Skills 安装与配置

通过命令行安装 Skills,部分 Skill 需要额外配置 API Key:

联网搜索

openclaw skills install web-search
skills:
  web-search:
    provider: searxng
    base_url: https://searx.example.com

支持 Google/Bing API 或自托管 SearXNG

代码执行

openclaw skills install code-runner

安装后即可使用,支持 Python、JavaScript、Shell

浏览器自动化

openclaw skills install browser-auto

需要本地安装 Chrome/Chromium 浏览器

查看所有已安装 Skills

openclaw skills list

配置完成后运行 openclaw start 启动服务 | 更多使用方法请参考 使用教程

配置最佳实践

让 OpenClaw 运行更稳定、更安全

🔑
API Key 安全
推荐使用环境变量而非明文写入配置文件来管理 API Key,防止意外泄露。生产环境可使用密钥管理服务
🔗
多模型备用
在 llm.models 中配置多个模型作为备用方案,当主模型 API 不可用时自动切换,确保服务不中断
💰
成本控制
为不同任务类型分配不同模型:简单问答用轻量模型节省成本,复杂推理才用高端模型。可设置每日 Token 使用上限
👤
权限管控
配置 allowed_users 白名单限制使用人员,为不同用户设置不同的 Skill 权限,防止敏感操作被滥用

消息平台接入对比

选择最适合你的消息平台接入方案

💬
飞书
企业级首选,官方 API 稳定可靠,支持富文本、卡片消息。适合团队协作场景,需要飞书开放平台账号
📬
企业微信
国内企业用户首选,与微信互通,官方 API 稳定。适合已使用企业微信的团队,需要管理员权限创建应用
Telegram
海外用户首选,Bot API 开放自由,无需审核。配置最简单,一个 Token 即可连接,适合个人使用
📱
WhatsApp
全球用户量最大的消息平台,扫码即可连接。适合海外个人用户,但非官方接入方式稳定性需关注

常见问题

OpenClaw 配置相关疑问

OpenClaw如何配置AI模型的API Key?
运行 openclaw config 打开配置文件,在 llm 部分填入API Key。以Claude为例:设置 provider 为 anthropic,model 为 claude-sonnet-4-6,api_key 填入从Anthropic官网获取的Key。支持多模型配置,可在 llm.models 数组中添加多个模型,OpenClaw会根据任务类型自动选择。也支持通过环境变量设置:export OPENCLAW_LLM_API_KEY=你的Key
OpenClaw如何接入飞书?
接入飞书需要三步:1)在飞书开放平台创建机器人应用,获取App ID和App Secret;2)在应用中配置消息接收地址(云服务器部署时填服务器公网地址+端口)和事件订阅(接收消息等事件);3)在OpenClaw配置文件的 transports.feishu 部分填入App ID、App Secret和Verification Token。启动后在飞书中搜索机器人名称即可开始对话。
OpenClaw如何接入微信?
OpenClaw接入个人微信有两种方式:方式一是通过微信网页版协议(需安装wechat-transport Skill),启动后扫码登录即可,但微信可能限制部分账号的网页版功能。方式二是通过企业微信自建应用接入(更稳定推荐)。在配置文件的 transports.wechat 部分设置相关参数。注意:接入微信属于非官方方式,建议使用小号测试。
OpenClaw如何配置联网搜索功能?
OpenClaw通过Skills实现联网搜索。推荐安装web-search Skill:运行 openclaw skills install web-search 安装。安装后还需要配置搜索API:支持Google Search API、Bing Search API或SearXNG(开源搜索引擎,可自托管)。在配置文件的 skills.web-search 部分填入搜索API的Key即可。配置完成后,向OpenClaw提问时它会自动判断是否需要联网搜索。
有哪些值得安装的OpenClaw Skills推荐?
推荐以下实用Skills:web-search(联网搜索,必装)、code-runner(代码执行)、file-manager(文件管理)、browser-auto(浏览器自动化)、image-gen(图片生成,需配置DALL-E或SD API)、email-sender(邮件发送)、calendar(日历管理)、translator(多语言翻译)。运行 openclaw skills search 关键词 可以在ClawHub搜索更多Skills,目前已有超过13000个社区贡献的技能插件。

相关工具

OpenClaw - 更多实用工具