OpenClaw
GitHub立即开始
深度配置

OpenClaw 配置教程 - AI 模型与聊天渠道设置

已经安装了 OpenClaw？了解如何配置 AI 模型、网关设置、聊天渠道等

OpenClaw 配置项

选择你要配置的内容，快速跳转到对应章节

OpenClaw 配置总览

OpenClaw 将所有配置存储在 ~/.openclaw 目录中。了解这个结构有助于你管理和备份设置。

文件结构

~/.openclaw/openclaw.json主配置文件
~/.openclaw/workspace/技能、提示词、记忆
~/.openclaw/credentials/OAuth 和 API 凭证
~/.openclaw/agents/多代理配置
~/.openclaw/credentials/oauth.jsonOAuth 令牌（Claude 等）

OpenClaw AI 模型配置

必须

OpenClaw 支持多种 AI 提供商。选择你偏好的提供商并按照步骤完成设置。

当前配置:Anthropic - API Key

最适合：标准 API 访问和使用量计费。在 Anthropic 控制台创建您的 API 密钥。

1

获取 API 密钥

在 Anthropic 控制台创建 API 密钥

打开 Anthropic 控制台
2

CLI 设置

运行配置向导或使用非交互模式

交互式（推荐）

$ openclaw onboard
# choose: Anthropic API key

非交互式

$ openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

配置文件结构

配置完成后，openclaw.json 中的相关配置如下：

~/.openclaw/openclaw.json
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}

提示缓存（仅限 API）

OpenClaw 不会覆盖 Anthropic 的默认缓存 TTL，除非你设置它。订阅认证不遵守 TTL 设置。

~/.openclaw/openclaw.json
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": {
          params: { cacheControlTtl: "5m" }, // or "1h"
        },
      },
    },
  },
}

验证配置

$ openclaw models status

运行此命令确认认证配置是否生效

推荐使用 Anthropic Claude 以获得最佳体验。支持的模型：anthropic/claude-opus-4-5、anthropic/claude-sonnet-4-20250514、anthropic/claude-haiku 等。
注意：认证是按代理（agent）独立的，新建代理需要单独配置凭证。

OpenClaw 网关配置

必须

网关是 OpenClaw 的核心服务，负责处理 AI 和聊天平台之间的所有消息路由。

默认设置

端口
18789
绑定地址
127.0.0.1
认证方式
token / password

常用命令

安装守护进程（macOS/Linux 自动识别）

$ openclaw gateway install

检查网关状态

$ openclaw gateway status

查看实时日志

$ openclaw logs --follow

远程访问

通过 SSH 隧道安全访问远程服务器上的网关：

$ ssh -N -L 18789:127.0.0.1:18789 user@host
查看完整网关文档

OpenClaw 聊天渠道配置

至少一个

将 OpenClaw 连接到你喜欢的聊天平台。每个渠道都有自己的设置流程。

当前配置:WhatsApp
1

WhatsApp 账户管理

登录或登出 WhatsApp 账户

登录（生成二维码）

$ openclaw channels login whatsapp

登出（需要重新连接时使用）

$ openclaw channels logout whatsapp
2

扫描二维码

打开手机上的 WhatsApp，进入「设置 → 已连接设备」，扫描二维码

二维码

使用 WhatsApp 手机应用扫描

3

批准配对

你的第一条消息会收到一个配对码。批准它即可开始聊天。

$ openclaw pairing list whatsapp
$ openclaw pairing approve whatsapp [CODE]
请使用专用手机号码。不推荐使用 VoIP 号码，因为它们容易被封禁。
凭证存储在 ~/.openclaw/credentials/whatsapp/ 目录中。
查看完整 WhatsApp 配置文档

OpenClaw 技能管理

可选

技能扩展了 OpenClaw 的能力。安装和管理技能来增强你的 AI 助手。

列出可用技能

$ openclaw skills list

安装技能

$ openclaw skills install <skill-name>

启用技能

$ openclaw skills enable <skill-name>

热门技能

网络搜索

搜索网络并总结结果

web-search
代码解释器

在沙盒环境中执行代码

code-interpreter
文件管理器

读取、写入和管理文件

file-manager
日历

管理日历事件和提醒

calendar
查看完整技能配置文档

OpenClaw 高级配置

可选

为复杂设置和自动化提供的高级功能。

多代理设置

为不同场景创建独立的代理（工作、个人等）。每个代理都有自己的工作区、会话和凭证。

$ openclaw agents add work
$ openclaw agents list
$ openclaw agents switch work

非交互模式

在脚本或 CI/CD 流水线中自动化 OpenClaw 设置。

$ openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback

定时任务

使用 cron 风格的调度设置自动化消息和任务。

cron.json
# ~/.openclaw/cron.json
{
  "jobs": [
    {
      "schedule": "0 9 * * *",
      "action": "send",
      "channel": "telegram",
      "message": "Good morning! Here's your daily briefing..."
    }
  ]
}
查看完整高级配置文档

配置完成！

你的 OpenClaw 已完全配置好了。开始与你的 AI 助手聊天吧。

下一步