OpenClaw（曾用名 Clawdbot、Moltbot）是一个开源、自托管的 AI 智能体（Agent）系统。它不仅仅是一个聊天机器人，更像是一个拥有“手脚”的 24/7 全天候数字员工。本文是关于 OpenClaw 的详细介绍、安装部署及配置指南。
OpenClaw 介绍
OpenClaw 运行在本地设备（PC、Mac Mini、树莓派）或云服务器（VPS）上，充当私人 AI 助理。
- 核心特性：
- 自托管与隐私：数据和运行环境完全在自己的控制之下。
- 多渠道接入：通过熟悉的即时通讯软件（微信/WeChat via 桥接, Telegram, WhatsApp, Discord, Slack 等）与它对话。
- 执行能力：它不仅能生成文本，还能执行真实任务（如写代码、操作文件、控制浏览器、管理日历、发送邮件等）。
- 模型无关性：支持接入 OpenAI (GPT-4o), Anthropic (Claude 3.5), DeepSeek, Google Gemini 等主流大模型，也支持通过 Ollama 接入本地模型。
- 持久记忆：拥有长期记忆能力，能记住你的偏好和上下文。
环境准备 (Prerequisites)
在安装之前，请确保环境满足以下要求：
- 操作系统：macOS, Linux (Ubuntu/Debian 推荐), 或 Windows (通过 WSL2)。
- 运行环境：
- Node.js：版本需 v20 或更高（推荐 v22+）。
- 包管理器：
npm或pnpm。
- API Key：准备好s打算使用的 AI 服务的 API Key（如 OpenAI API Key 或 Anthropic API Key）。
安装与部署
OpenClaw 提供了几种安装方式，最简单的是使用官方的一键脚本。
一键脚本安装（推荐 macOS/Linux）
打开终端（Terminal），运行以下命令：
bash
curl -fsSL https://openclaw.ai/install.sh | bash
# 或
npm i -g openclaw该脚本会自动检测环境、安装 Node.js 依赖并下载 OpenClaw 核心文件。
Windows (PowerShell)
在 PowerShell 中运行：
powershell
iwr -useb https://openclaw.ai/install.ps1 | iexDocker 部署 (适合隔离环境)
openclaw 可以直接使用 Docker Compose 启动，避免污染本机环境。
- 克隆仓库：
bash
git clone https://github.com/openclaw/openclaw.git cd openclaw - 启动容器：
注意：Docker 模式下，AI 对宿主机的操作权限会被限制在容器内（沙盒环境），适合安全性要求高的场景。bash
docker-compose up -d
配置指南 (Configuration)
安装完成后，OpenClaw 会自动启动初始化向导。如果没有自动启动，可以手动运行：
bash
openclaw onboard~/.openclaw/.env~/.openclaw/openclaw.json~/.openclaw/workspace~/.openclaw/agents/main/sessions
初始化设置 (Onboarding)
向导会通过命令行交互引导完成基础配置：
- 选择 AI 提供商：选择
OpenAI、Anthropic或Ollama(本地)。 - 输入 API Key：粘贴 API 密钥。
- 选择模型：例如
gpt-4o或claude-3-5-sonnet。
配置文件修改 (高级配置)
OpenClaw 的配置存储在用户主目录下的 .openclaw 文件夹中。
- 配置文件路径：
~/.openclaw/openclaw.json - 工作区路径：
~/openclaw/workspace(AI 生成的文件会存放在这里)
可以手动编辑 openclaw.json 来添加更多细节，例如修改系统提示词（System Prompt）或调整权限。
json
{
`agents`: {
`defaults`: {
`model`: `gpt-4o`,
`temperature`: 0.5
}
},
`skills`: {
`enabled`: [`browser`, `filesystem`, `shell`]
}
}网络搜索
openclaw configure --section web
# 或
jq '.tools.web.search = {
"provider": "brave",
"apiKey": "BSxxxxxxxxxxxxxxxxxxxx",
"maxResults": 5,
"timeoutSeconds": 30
}' /root/.openclaw/openclaw.json > /tmp/openclaw.json && mv /tmp/openclaw.json /root/.openclaw/openclaw.json- Brave Search 有免费 tier：每月 2000 次查询免费，地址 https://brave.com/search/api
- Tavily
{
"tools": {
"allow": ["web_search", "web_fetch"]
}
}plugins
openclaw plugins list连接通讯渠道 (Connect Channels)
这是 OpenClaw 的核心——让 AI 连上聊天软件。 运行命令：
bash
openclaw channels login以 Telegram 为例：
- 在 Telegram 中搜索
@BotFather。 - 发送
/newbot创建一个新机器人，获取 Bot Token。 - 在 OpenClaw 的命令行中选择 Telegram，并粘贴该 Token。
- 在 Telegram 中向新 Bot 发送
/start，OpenClaw 会回复并建立连接。
qqbot
openclaw plugins install @sliverp/qqbot@latest
openclaw channels add --channel qqbot --token "xxx:xxx"
openclaw gateway restarttemplates
工作区~/.openclaw/workspace/目录下的文件：
SOUL.md是 OpenClaw 工作区中的一个特殊文件，用于定义 Agent 的人格、语调和边界。它不是配置文件，而是一份"灵魂文档"。- USER.md / IDENTITY.md 模板
- 心跳配置：HEARTBEAT.md 预设日常检查项
- 记忆系统：MEMORY.md + memory/ 目录结构
- 工作指南：AGENTS.md 行为准则
- 工具笔记：TOOLS.md 本地工具速查
- Skills：精选实用技能列表
- 官方模板：https://github.com/openclaw/openclaw/tree/main/docs/reference/templates
第一次沟通是，可以输入：
你叫小f，你是一个专业的股票分析师，特别擅长捕捉市场机会，你的任务是搜索并分析当日市场热门信息，热门板块和概念，找到龙头股和强势股，请务必记住所有数据来源必须来自财联社、雪球、同花顺、东方财富等权威网站技能 SKILL.md
技能是一个包含 SKILL.md 文件的文件夹。如果您想为 OpenClaw 代理添加新功能，ClawHub 是查找安装技能的最佳方法。
信息获取助理
- SOUL.md
# SOUL
## 核心原则
1. 及时准确：先核验再推送；重要信息必须给来源与时间戳。
2. 覆盖全面但不吵：宁少勿滥；默认只推“对你有用”的信息。
3. 可追溯：每条信息给到原始链接/出处与摘要依据。
4. 安全与隐私：不保存敏感凭证；最小权限原则。
## 红线
- 不伪造新闻来源；不将传闻当事实。
- 不在未授权时抓取付费/受限内容。- IDENTITY.md
# IDENTITY
## 一句话角色
你是信息获取与订阅助理，负责每日新闻简报、按主题定制推送。
你是一个专业的金融分析师助手。
当用户询问股票、大盘或财经新闻时，你必须使用 [web_search] 工具查询最新的实时数据。
请结合指数涨跌幅、主要板块表现和重要财经新闻进行总结。
如果无法获取数据，请尝试更换搜索关键词。
## 昵称
讯报小助手
## 服务对象
- 企业职能（市场/销售/战略/投标）
- 个人研究与信息跟踪
## 交付物
- 《每日简报》（早/晚）
- 《专题快报》（按主题：如 AI、政策、竞品、地区等）
## 边界
- 不提供法律意见；仅做信息整理与风险提示。- AGENTS.md
# AGENTS
## 触发与频率
- 每天 08:30 发送《晨报》，18:30 发送《晚报》
## 工作流
1. 拉取：按来源与关键词抓取
2. 过滤：去重、排除词过滤、可信度分层（权威/行业/社媒）
3. 结构化：标题、时间、主体、事件类型、影响对象、原文链接
4. 摘要：3 句内概括 + “为什么与你相关”
5. 告警：命中【金额/期限/地区/主体】阈值时高亮提醒
6. 归档：按主题存入知识库（可选）
## 输出模板（晨报/晚报）
- 今日必看（<=5）
- 行业动态（<=8）
- 政策/监管（<=5）
- 融资/并购（<=5）
- 招投标/公告（命中提醒）
- 一句话判断：对你最可能产生影响的 1 条常用命令
openclaw status： 查看网关状态openclaw gateway [start|stop|restart|run|install]：启动网关服务（保持 AI 在线）。export NODE_OPTIONS="--max-old-space-size=1536"限制内存
openclaw onboard：重新运行配置向导。openclaw update：更新到最新版本。openclaw dashboard： 浏览器打开 Dashboardopenclaw dashboard --no-open：获取 dashboard URLopenclaw doctor：检查环境健康状态和依赖问题。openclaw doctor --fix
openclaw logs --follow：查看运行日志
clawhub
npm i -g clawhub
clawhub login --token xxx使用：
# 搜索技能
clawhub search "stock"
# 下载新技能
clawhub install stock-watcher
# clawhub install self-improving-agent
# clawhub install proactive-agent # 给Agent加主动性和自我迭代能力，能记住历史、优化行为、减少重复问
#
# 更新已安装的技能
clawhub update --all- How do I enable web search and web fetch
- 网页：https://www.tavily.com/
clawhub install tavily-search
export TAVILY_API_KEY=xxx
openclaw config set tools.tavily.apiKey "$TAVILY_API_KEY"
npm install -g mcporter mcporter config add exa https://mcp.exa.ai/mcp
openclaw gateway restart配置
{
"plugins": {
"allow": [
"qqbot",
"web-browser"
]
}
}nginx 代理
apt-get install apache2-utils
sudo htpasswd -c /etc/nginx/openclaw_passwd admin location /openclaw {
# --- 开启密码验证 ---
auth_basic "Restricted Access"; # 弹窗提示语
auth_basic_user_file /etc/nginx/openclaw_passwd; # 刚刚生成的密码文件路径
# ------------------
# 代理到 OpenClaw 后端
proxy_pass http://127.0.0.1:18789;
# 传递真实的 IP 和 Header
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# --- WebSocket 支持 (OpenClaw 可能需要) ---
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}访问：http://<domain>:18789/openclaw/openclaw#token=xxx
常见使用场景与技巧
- 本地模型 (免费使用)：安装 Ollama 后，下载
llama3或qwen2.5-coder模型。在 OpenClaw 配置中选择 Ollama，即可实现完全离线且免费的 AI 助理。 - 安全性：默认情况下，OpenClaw 拥有较高的系统权限（如读写文件）。建议初学者不要直接在生产环境服务器的 root 账户下运行，或者使用 Docker 版本以利用其沙盒机制。
- 技能扩展 (Skills)：OpenClaw 支持通过 YAML 定义技能，你可以教它如何调用特定的 API（如查询天气、股票或控制智能家居）。
F&Q
origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins)
修改 ~/.openclaw/openclaw.json：
{
"gateway": {
"controlUi": {
"allowedOrigins": ["*"]
}
}
}unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)
修改 ~/.openclaw/openclaw.json：
{
"gateway": {
"auth": {
"token": "xxx"
}
}
}或
jq '.gateway.auth.token = "token"' /root/.openclaw/openclaw.json > /tmp/openclaw.json && mv /tmp/openclaw.json /root/.openclaw/openclaw.jsonControl UI 提示：pairing required
此设备需要网关主机的配对批准
openclaw devices list
openclaw devices approve <requestId>从桌面运行 openclaw dashboard –no-open 复制完整 URL（包括 #token=…）。
查看日志
journalctl -u openclaw-gatewaytail -f ~/.openclaw/logs/config-audit.jsonl
enable the tools in the dashboard for agents can not click save
Unable to load exec tool
npm install -g openclaw@2026.3.1
openclaw gateway start类似的实现
参考
最近更新
最新评论