OpenClaw简单配置说明

本文档整理自实际使用经验，专注于OpenClaw配置项的说明和配置方法。

一、安装方式

npm安装

npm install -g openclaw@latest

卸载

npm uninstall -g openclaw

二、Onboard配置方式选择

Quick Start vs Manual Configuration

推荐选择：Manual Configuration（手动配置）

原因：

• Quick Start：一键连接官方云服务或预设的简单模型，灵活性不足

• Manual Configuration：完全掌控配置

三、模型/Provider配置

针对国内用户的推荐

国产模型（推荐）

• MiniMax：OpenClaw官方推荐，代码编写和逻辑推理能力强，国内访问速度快

• Moonshot AI (Kimi)：长文本处理能力出色，中文理解能力极佳

• Qwen (通义千问)：国内一线大模型，稳定性高，延迟低

• BytePlus (火山引擎)：国内一线大模型，性价比高

• Z.AI (智谱)：国内一线大模型，支持多种场景

国际模型

• Anthropic (Claude)：需要配置全局代理，风控严格，不推荐新手首选

• BytePlus：国内访问速度快，性价比高

• Chutes：去中心化推理，配置复杂

• Cloudflare AI Gateway：聚合网关，适合已有Cloudflare配置的用户

配置步骤

1. 选择模型提供商（如MiniMax、Moonshot AI等）

2. 去对应官网获取API Key

3. 在OpenClaw中输入API Key

四、Gateway认证配置

Token vs Password

推荐选择：Token（默认项）

选择Token的理由：

• 更安全：Token是一串很长的随机字符，难以暴力破解

• 方便API调用：代码中直接在URL后拼接token即可

• 符合OpenClaw设计逻辑：更适合”机器与机器”交互

配置后注意事项：

• 系统生成Token后，务必复制保存

• 登录地址格式：http://127.0.0.1:18789?token=oc_sk_xxxxxxxxx…

• 如需重置：openclaw config show 或重新运行 openclaw onboard

五、Tailscale暴露配置

Off vs Serve vs Funnel

推荐选择：Off（默认项）

选择Off的理由：

• 最安全：服务只监听127.0.0.1，外部网络完全无法触达

• 最省事：不需要注册Tailscale账号，装完即用

何时选Serve：

• 有远程访问需求（如公司笔记本访问家里电脑）

• 已有Tailscale账号

• 需要跨网络安全访问

何时选Funnel：

• 需要将服务暴露给整个互联网

• 极不推荐新手选择

六、聊天渠道配置

Configure chat channels now?

推荐选择：Yes

原因：

• 即时体验：配置网页聊天界面，安装后立即可用

• 可视化操作：网页版界面最直观，无需敲复杂命令行

可选渠道：

• Web UI：内置的网页聊天界面（最常用，推荐）

• Slack / Discord / Telegram / 飞书：接入这些聊天软件

七、飞书渠道配置

App Secret提供方式

推荐选择：Enter App Secret

原因：

• 简单直接：系统直接弹窗让你粘贴App Secret

• 适合本地环境：配置文件存储完全没问题

配置步骤：

1. 选择”Enter App Secret”

2. 系统弹窗提示输入

3. 粘贴从飞书开放平台复制的App Secret

4. 配置完成