2.7 KiB
2.7 KiB
Ubuntu OpenClaw 技术笔记
本文件记录 Ubuntu 服务器上 OpenClaw 的安装、配置和管理命令。
环境概述
- 系统: Ubuntu 20.04 / 22.04
- 安装方式: npm 用户级全局安装
- CLI 路径:
/home/shenwei/.npm-global/bin/openclaw - 配置目录:
/home/shenwei/.openclaw - systemd 服务:
/home/shenwei/.config/systemd/user/openclaw-gateway.service
PATH 配置
# 临时生效
export PATH=$HOME/.npm-global/bin:$PATH
# 永久生效（添加到 ~/.bashrc）
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
安装 OpenClaw
# 安装
npm install -g openclaw clawhub
# 初始化
openclaw onboard
Gateway 管理
# 启动/停止/重启
systemctl --user start openclaw-gateway
systemctl --user stop openclaw-gateway
systemctl --user restart openclaw-gateway
# 查看状态
systemctl --user status openclaw-gateway
# 开机自启
systemctl --user enable openclaw-gateway
# 查看日志
journalctl --user -u openclaw-gateway -n 50 --no-pager
# 修改配置后重载
systemctl --user daemon-reload
Agent 管理
创建 Agent
openclaw agents add <agent_name> --non-interactive --workspace /home/shenwei/.openclaw/workspace-agent-<agent_name> --model MiniMax-M2.5
示例：
openclaw agents add yunhan --non-interactive --workspace /home/shenwei/.openclaw/workspace-agent-yunhan --model MiniMax-M2.5
列出 Agent
openclaw agents list
删除 Agent
openclaw agents delete <agent_name> --force
Telegram Bot 绑定
绑定 Bot 到 Agent
openclaw agents bind --agent <agent_id> --bind telegram:<account_name>
示例：
openclaw agents bind --agent yunhan --bind telegram:yunhan
绑定后需重启 Gateway：
systemctl --user restart openclaw-gateway
删除 Bot
openclaw channels remove --channel telegram --account <account_name> --delete
常用命令
| 命令 | 功能 |
|---|---|
openclaw --version |
查看版本 |
openclaw status |
查看状态 |
openclaw onboard |
初始化 |
openclaw doctor --fix |
修复配置 |
openclaw logs --follow |
查看日志 |
注意事项
- 不要用 root 运行 - 会生成
/root/.openclaw，权限混乱 - 统一使用普通用户 (shenwei) 安装和运行
- 通过 systemctl 管理 Gateway，不要用 tmux
- Telegram Bot 限制 - 每个账号最多 20 个 bot
Ubuntu 服务器列表
| 服务器 | 内网 IP | 说明 |
|---|---|---|
| ubuntu1 | 192.168.3.47 | - |
| ubuntu2 | 192.168.3.45 | - |
最后更新: 2026-03-16