全部文档
当前文档
最近更新时间：2026-03-10 20:25:20
OpenClaw（原Clawdbot/Moltbot）是一款开源的个人AI助手和Agent工具，旨在帮助用户通过日常消息平台（如飞书、企业微信、钉钉、Telegram、WhatsApp、Discord等）与AI进行交互，并自动执行任务、自动化工作流程、管理文件等操作。在云服务器上自托管部署，既保证数据和AI调用密钥的隐私安全，又支持7*24稳定运行与远程访问。同时可按需弹性扩展计算资源，运维升级便捷，是企业或个人高效使用AI助手的理想方案。
配置项 | 说明 | 示例 |
支持的地域 | 无地域限制，建议在海外节点创建实例和部署服务，降低网络延迟。 | 华北1（北京E） |
实例 | 推荐Linux云服务器，保证至少2核vCPU、4GB内存、20GB系统盘。 | 机型：高效型SE9 实例规格：SE9.2B |
镜像 | Linux发行版本镜像，建议使用Ubuntu/Debian标准镜像获得较好的兼容性。 | Ubuntu 22.04 |
网络 | 建议搭配公网弹性IP使用，确保可从外部访问WebUI/Gateway服务。 | 安全组须放行18789端口（TCP协议） |
API Key | OpenClaw通过AI模型生成对话、自动化任务和内容处理，需要调用大模型API。用户需提供有效API Key用于访问模型服务，实现智能对话和任务执行能力。 | OpenClaw当前支持的模型提供商包括OpenAI、Anthropic、MoonshotAI（Kimi）、MiniMax等，更多模型提供商请参考OpenClaw官网。推荐使用金山云星流模型API服务。 |
OpenClaw的运行环境为Node.js，需要保证系统已安装Node.js，且版本≥22。
1、检查系统环境
node -v2、安装node.js（若显示未安装）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs3、检查是否安装成功，安装成功时应返回版本号
node -v && npm -v4、安装OpenClaw（下载安装耗时较长，请耐心等待）
curl -fsSL https://openclaw.bot/install.sh | bash配置项 | 描述 | 建议配置 |
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? | OpenClaw提醒用户该功能默认用于个人环境，在多用户或共享环境下需要额外的安全加固。确认后才允许继续onboarding。 | 勾选“Yes”，确认理解相关安全风险。 |
Onboarding mode | 初始引导模式，用于快速完成OpenClaw的基础配置，例如模型、渠道和hooks等。 | 选择QuickStart模式，快速生成默认配置并完成基础初始化。 |
Model/auth provider | 选择大模型服务提供商及认证方式，用于OpenClaw调用模型API。 | 推荐使用金山云星流模型API服务，此处先选择“Skip for now”，后续再进行配置。 |
Filter models by provider | 是否仅显示所选提供商支持的模型，以避免误选不兼容模型。 | 选择"All providers"。 |
Default model | 设置OpenClaw启动后默认使用的模型。 | 使用默认配置。 |
Select channel (QuickStart) | 初始渠道选择，用于快速部署和测试OpenClaw消息收发。 | 选择“Skip for now”，后续进行配置。 |
Search provider | 是否配置搜索服务提供商，用于扩展检索能力。 | 选择“Skip for now”，后续进行配置。 |
Configure skills now? (recommended) | 是否立即配置Agent技能，例如自定义指令、工具链等能力。 | 选择“No”，后续进行配置。 |
Enable hooks? | 是否启用OpenClaw的扩展Hook，用于增强启动、日志、会话记忆等能力。 | 按方向键+空格选择需要启用的Hook，然后回车确认。推荐启用： •boot-md：启动时执行 •bootstrap-extra-files：注入额外的工作空间初始化文件 •command-logger：记录所有命令事件到审计日志 •session-memory：在 |
How do you want to hatch your bot? | 选择Bot的启动或管理方式，决定是在终端界面（TUI）中启动、通过Web UI管理，还是暂不启动，仅完成配置。 | 选择 “Do this later”，暂不启动 Bot，后续再根据需要通过TUI或Web UI进行管理和启动。 |
1、在金山云星流模型API服务平台，前往API Key管理，新建API Key。
请妥善保管API Key，一旦泄露，第三方可能冒用您的身份执行操作，导致意外的API调用费用。
2、根据建议配置创建一台云服务器并登录，输入以下命令进入配置页面。
openclaw onboard3、阅读安全须知后，选择Yes即可。
4、Onboarding模式选择QuickStart（快速开始）。
5、在Model/authprovider中选择Skip for now，后续进行配置。
6、在Filter models by provider中选择All providers。
7、在Default model中选择默认配置。
8、在Select channel中选择skip for now，后续进行配置。
9、在Search provider中选择skip for now，后续进行配置。
10、在Configure skills now中选择No，后续进行配置。
11、在Enable hooks中按照配置概览中的情况选择。
12、在How do you want to hatch your bot?中选择Do this later.
详细配置项介绍请参考OpenClaw官网文档：https://docs.openclaw.ai/zh-CN/gateway/configuration-examples
1、在终端中查看配置文件，保存查询到的token信息：
cat ~/.openclaw/openclaw.json2、修改配置文件
vim ~/.openclaw/openclaw.json{
"meta": {
"lastTouchedVersion": "[openclaw_version]",
"lastTouchedAt": "[timestamp]"
},
"wizard": {
"lastRunAt": "[timestamp]",
"lastRunVersion": "[openclaw_version]",
"lastRunCommand": "onboard",
"lastRunMode": "local"
},
"models": {
"providers": {
"starflow": {
"baseUrl": "[model_api_base_url]",
"apiKey": "[YOUR_API_KEY]",
"api": "openai-completions",
"authHeader": false,
"models": [
{
"id": "[model_id]",
"name": "[model_name]",
"api": "openai-completions",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
},
"bedrockDiscovery": {
"providerFilter": []
}
},
"agents": {
"defaults": {
"model": {
"primary": "starflow/[model_id]"
},
"workspace": "[agent_workspace_path]",
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
},
"messages": {
"ackReactionScope": "group-mentions"
},
"commands": {
"native": "auto",
"nativeSkills": "auto"
},
"hooks": {
"internal": {
"enabled": true,
"entries": {
"command-logger": {
"enabled": true
},
"session-memory": {
"enabled": true
}
}
}
},
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"auth": {
"mode": "token",
"token": "[YOUR_GATEWAY_TOKEN]"
},
"tailscale": {
"mode": "off",
"resetOnExit": false
},
"http": {
"endpoints": {
"responses": {
"enabled": false
}
}
}
}
}需要替换的字段：
占位符 | 说明 |
| 模型API服务地址 |
| 模型服务API Key |
| 模型ID |
| 模型名称 |
| Agent工作目录，默认配置无需修改 |
| Gateway访问Token，默认配置无需修改 |
| OpenClaw版本，默认配置无需修改 |
| 时间戳，默认配置无需修改 |
3、保存配置并重启
openclaw gateway restart4、检查所有已注册的模型
openclaw models list若模型已成功注册，显示如下：
openclaw agent --agent main --message "你好"OpenClaw提供一个基于浏览器的WebUI（Dashboard），用于可视化管理和配置agent、模型、命令和hooks。WebUI是可选功能，适合想通过浏览器直观管理OpenClaw的用户，也可以与纯配置文件方式结合使用。
1、通过SSH隧道建立连接
使用SSH隧道将远程服务器上的Gateway端口映射到本地端口，实现本地浏览器访问远程OpenClaw。示例命令：
ssh -i "<SSH密钥文件路径>" -N -L 18789:127.0.0.1:18789 ubuntu@<服务器公网IP>-i"<SSH密钥文件路径>"：指定SSH私钥文件
-N：不执行远程命令，仅建立隧道
-L18789:127.0.0.1:18789：将远程服务器18789端口映射到本地18789
ubuntu@<服务器公网IP>：远程服务器用户名和公网IP
2、在本地浏览器访问Dashboard
在终端中输入以下命令，点击DashboardURL后即可访问
openclaw dashboard3、注意事项
确保本地端口18789未被占用，否则可以修改隧道本地端口，例如-L8888:127.0.0.1:18789，然后访问http://localhost:8888/?token=YOUR_TOKEN。
隧道建立期间保持终端窗口打开，关闭窗口隧道即断开。
纯净模式