Skip to content

Commit bb3ef76

Browse files
committed
feat: Rename clawdbot to openclaw
1 parent b75be9f commit bb3ef76

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+929
-929
lines changed

AGENTS.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
## Project Overview
44

5-
Ansible playbook for automated, hardened Clawdbot installation on Debian/Ubuntu systems.
5+
Ansible playbook for automated, hardened OpenClaw installation on Debian/Ubuntu systems.
66

77
## Key Principles
88

@@ -16,14 +16,14 @@ Ansible playbook for automated, hardened Clawdbot installation on Debian/Ubuntu
1616
### Task Order
1717
Docker must be installed **before** firewall configuration.
1818

19-
Task order in `roles/clawdbot/tasks/main.yml`:
19+
Task order in `roles/openclaw/tasks/main.yml`:
2020
```yaml
2121
- tailscale.yml # VPN setup
2222
- user.yml # Create system user
2323
- docker.yml # Install Docker (creates /etc/docker)
2424
- firewall.yml # Configure UFW + daemon.json (needs /etc/docker to exist)
2525
- nodejs.yml # Node.js + pnpm
26-
- clawdbot.yml # Container setup
26+
- openclaw.yml # Container setup
2727
```
2828
2929
Reason: `firewall.yml` writes `/etc/docker/daemon.json` and restarts Docker service.
@@ -110,16 +110,16 @@ Keep docs concise. No progress logs, no refactoring summaries.
110110

111111
### Host System
112112
```
113-
/opt/clawdbot/ # Installation files
114-
/home/clawdbot/.clawdbot/ # Config and data
115-
/etc/systemd/system/clawdbot.service
113+
/opt/openclaw/ # Installation files
114+
/home/openclaw/.openclaw/ # Config and data
115+
/etc/systemd/system/openclaw.service
116116
/etc/docker/daemon.json
117117
/etc/ufw/after.rules
118118
```
119119
120120
### Repository
121121
```
122-
roles/clawdbot/
122+
roles/openclaw/
123123
├── tasks/ # Ansible tasks (order matters!)
124124
├── templates/ # Jinja2 configs
125125
├── defaults/ # Variables
@@ -141,7 +141,7 @@ SSH is exposed to the internet. Fail2ban automatically bans IPs after 5 failed a
141141
Security patches should be applied promptly. Automatic security-only updates reduce vulnerability windows.
142142
143143
### Why Scoped Sudo?
144-
The clawdbot user only needs to manage its own service and Tailscale. Full root access would be dangerous if the app is compromised.
144+
The openclaw user only needs to manage its own service and Tailscale. Full root access would be dangerous if the app is compromised.
145145
146146
### Why Localhost Binding?
147147
Defense in depth. If DOCKER-USER fails, localhost binding prevents external access.
@@ -160,7 +160,7 @@ Clean lifecycle, auto-start, logging integration.
160160
## Making Changes
161161
162162
### Adding a New Task
163-
1. Add to appropriate file in `roles/clawdbot/tasks/`
163+
1. Add to appropriate file in `roles/openclaw/tasks/`
164164
2. Update main.yml if new task file
165165
3. Test with `--check` first
166166
4. Verify idempotency (can run multiple times safely)
@@ -185,5 +185,5 @@ Clean lifecycle, auto-start, logging integration.
185185
186186
## Support Channels
187187
188-
- Clawdbot issues: https://github.com/clawdbot/clawdbot
189-
- This installer: https://github.com/pasogott/clawdbot-ansible
188+
- OpenClaw issues: https://github.com/openclaw/openclaw
189+
- This installer: https://github.com/openclaw/openclaw-ansible

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2025 Clawdbot Contributors
3+
Copyright (c) 2025 OpenClaw Contributors
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 58 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
1-
# Clawdbot Ansible Installer
1+
# OpenClaw Ansible Installer
22

33
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4-
[![Lint](https://github.com/pasogott/clawdbot-ansible/actions/workflows/lint.yml/badge.svg)](https://github.com/pasogott/clawdbot-ansible/actions/workflows/lint.yml)
4+
[![Lint](https://github.com/openclaw/openclaw-ansible/actions/workflows/lint.yml/badge.svg)](https://github.com/openclaw/openclaw-ansible/actions/workflows/lint.yml)
55
[![Ansible](https://img.shields.io/badge/Ansible-2.14+-blue.svg)](https://www.ansible.com/)
66
[![Multi-OS](https://img.shields.io/badge/OS-Debian%20%7C%20Ubuntu%20%7C%20macOS-orange.svg)](https://www.debian.org/)
77

8-
Automated, hardened installation of [Clawdbot](https://github.com/clawdbot/clawdbot) with Docker, Homebrew, and Tailscale VPN support for Linux and macOS.
8+
Automated, hardened installation of [OpenClaw](https://github.com/openclaw/openclaw) with Docker, Homebrew, and Tailscale VPN support for Linux and macOS.
99

1010
## Features
1111

@@ -18,7 +18,7 @@ Automated, hardened installation of [Clawdbot](https://github.com/clawdbot/clawd
1818
- 🌐 **Multi-OS Support**: Debian, Ubuntu, and macOS
1919
- 🚀 **One-command install**: Complete setup in minutes
2020
- 🔧 **Auto-configuration**: DBus, systemd, environment setup
21-
- 📦 **pnpm installation**: Uses `pnpm install -g clawdbot@latest`
21+
- 📦 **pnpm installation**: Uses `pnpm install -g openclaw@latest`
2222

2323
## Quick Start
2424

@@ -27,7 +27,7 @@ Automated, hardened installation of [Clawdbot](https://github.com/clawdbot/clawd
2727
Install the latest stable version from npm:
2828

2929
```bash
30-
curl -fsSL https://raw.githubusercontent.com/pasogott/clawdbot-ansible/main/install.sh | bash
30+
curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash
3131
```
3232

3333
### Development Mode
@@ -36,11 +36,11 @@ Install from source for development or testing:
3636

3737
```bash
3838
# Clone the installer
39-
git clone https://github.com/pasogott/clawdbot-ansible.git
40-
cd clawdbot-ansible
39+
git clone https://github.com/openclaw/openclaw-ansible.git
40+
cd openclaw-ansible
4141

4242
# Install in development mode
43-
ansible-playbook playbook.yml --ask-become-pass -e clawdbot_install_mode=development
43+
ansible-playbook playbook.yml --ask-become-pass -e openclaw_install_mode=development
4444
```
4545

4646
## What Gets Installed
@@ -49,21 +49,21 @@ ansible-playbook playbook.yml --ask-become-pass -e clawdbot_install_mode=develop
4949
- UFW firewall (SSH + Tailscale ports only)
5050
- Docker CE + Compose V2 (for sandboxes)
5151
- Node.js 22.x + pnpm
52-
- Clawdbot on host (not containerized)
52+
- OpenClaw on host (not containerized)
5353
- Systemd service (auto-start)
5454

5555
## Post-Install
5656

57-
After installation completes, switch to the clawdbot user:
57+
After installation completes, switch to the openclaw user:
5858

5959
```bash
60-
sudo su - clawdbot
60+
sudo su - openclaw
6161
```
6262

6363
Then run the quick-start onboarding wizard:
6464

6565
```bash
66-
clawdbot onboard --install-daemon
66+
openclaw onboard --install-daemon
6767
```
6868

6969
This will:
@@ -75,50 +75,50 @@ This will:
7575

7676
```bash
7777
# Configure manually
78-
clawdbot configure
78+
openclaw configure
7979

8080
# Login to provider
81-
clawdbot providers login
81+
openclaw providers login
8282

8383
# Test gateway
84-
clawdbot gateway
84+
openclaw gateway
8585

8686
# Install as daemon
87-
clawdbot daemon install
88-
clawdbot daemon start
87+
openclaw daemon install
88+
openclaw daemon start
8989

9090
# Check status
91-
clawdbot status
92-
clawdbot logs
91+
openclaw status
92+
openclaw logs
9393
```
9494

9595
## Installation Modes
9696

9797
### Release Mode (Default)
98-
- Installs via `pnpm install -g clawdbot@latest`
98+
- Installs via `pnpm install -g openclaw@latest`
9999
- Gets latest stable version from npm registry
100-
- Automatic updates via `pnpm install -g clawdbot@latest`
100+
- Automatic updates via `pnpm install -g openclaw@latest`
101101
- **Recommended for production**
102102

103103
### Development Mode
104-
- Clones from `https://github.com/clawdbot/clawdbot.git`
104+
- Clones from `https://github.com/openclaw/openclaw.git`
105105
- Builds from source with `pnpm build`
106-
- Symlinks binary to `~/.local/bin/clawdbot`
106+
- Symlinks binary to `~/.local/bin/openclaw`
107107
- Adds helpful aliases:
108-
- `clawdbot-rebuild` - Rebuild after code changes
109-
- `clawdbot-dev` - Navigate to repo directory
110-
- `clawdbot-pull` - Pull, install deps, and rebuild
108+
- `openclaw-rebuild` - Rebuild after code changes
109+
- `openclaw-dev` - Navigate to repo directory
110+
- `openclaw-pull` - Pull, install deps, and rebuild
111111
- **Recommended for development and testing**
112112

113-
Enable with: `-e clawdbot_install_mode=development`
113+
Enable with: `-e openclaw_install_mode=development`
114114

115115
## Security
116116

117117
- **Public ports**: SSH (22), Tailscale (41641/udp) only
118118
- **Fail2ban**: SSH brute-force protection (5 attempts → 1 hour ban)
119119
- **Automatic updates**: Security patches via unattended-upgrades
120120
- **Docker isolation**: Containers can't expose ports externally (DOCKER-USER chain)
121-
- **Non-root**: Clawdbot runs as unprivileged user
121+
- **Non-root**: OpenClaw runs as unprivileged user
122122
- **Scoped sudo**: Limited to service management (not full root)
123123
- **Systemd hardening**: NoNewPrivileges, PrivateTmp, ProtectSystem
124124

@@ -129,8 +129,8 @@ Verify: `nmap -p- YOUR_SERVER_IP` should show only port 22 open.
129129
For high-security environments, audit before running:
130130

131131
```bash
132-
git clone https://github.com/openclaw/clawdbot-ansible.git
133-
cd clawdbot-ansible
132+
git clone https://github.com/openclaw/openclaw-ansible.git
133+
cd openclaw-ansible
134134
# Review playbook.yml and roles/
135135
ansible-playbook playbook.yml --check --diff # Dry run
136136
ansible-playbook playbook.yml --ask-become-pass
@@ -163,7 +163,7 @@ ansible-playbook playbook.yml --ask-become-pass
163163
### Common (All OS)
164164
- Homebrew package manager
165165
- Node.js 22.x + pnpm
166-
- Clawdbot via `pnpm install -g clawdbot@latest`
166+
- OpenClaw via `pnpm install -g openclaw@latest`
167167
- Essential development tools
168168
- Git, zsh, oh-my-zsh
169169

@@ -187,8 +187,8 @@ ansible-playbook playbook.yml --ask-become-pass
187187
sudo apt update && sudo apt install -y ansible git
188188

189189
# Clone repository
190-
git clone https://github.com/pasogott/clawdbot-ansible.git
191-
cd clawdbot-ansible
190+
git clone https://github.com/openclaw/openclaw-ansible.git
191+
cd openclaw-ansible
192192

193193
# Install Ansible collections
194194
ansible-galaxy collection install -r requirements.yml
@@ -203,43 +203,43 @@ Build from source for development:
203203

204204
```bash
205205
# Same as above, but with development mode flag
206-
./run-playbook.sh -e clawdbot_install_mode=development
206+
./run-playbook.sh -e openclaw_install_mode=development
207207

208208
# Or directly:
209-
ansible-playbook playbook.yml --ask-become-pass -e clawdbot_install_mode=development
209+
ansible-playbook playbook.yml --ask-become-pass -e openclaw_install_mode=development
210210
```
211211

212212
This will:
213-
- Clone clawdbot repo to `~/code/clawdbot`
213+
- Clone openclaw repo to `~/code/openclaw`
214214
- Run `pnpm install` and `pnpm build`
215-
- Symlink binary to `~/.local/bin/clawdbot`
215+
- Symlink binary to `~/.local/bin/openclaw`
216216
- Add development aliases to `.bashrc`
217217

218218
## Configuration Options
219219

220-
All configuration variables can be found in [`roles/clawdbot/defaults/main.yml`](roles/clawdbot/defaults/main.yml).
220+
All configuration variables can be found in [`roles/openclaw/defaults/main.yml`](roles/openclaw/defaults/main.yml).
221221

222222
You can override them in three ways:
223223

224224
### 1. Via Command Line
225225

226226
```bash
227227
ansible-playbook playbook.yml --ask-become-pass \
228-
-e clawdbot_install_mode=development \
229-
-e "clawdbot_ssh_keys=['ssh-ed25519 AAAAC3... user@host']"
228+
-e openclaw_install_mode=development \
229+
-e "openclaw_ssh_keys=['ssh-ed25519 AAAAC3... user@host']"
230230
```
231231

232232
### 2. Via Variables File
233233

234234
```bash
235235
# Create vars.yml
236236
cat > vars.yml << EOF
237-
clawdbot_install_mode: development
238-
clawdbot_ssh_keys:
237+
openclaw_install_mode: development
238+
openclaw_ssh_keys:
239239
- "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGxxxxxxxx user@host"
240240
- "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAB... user@host"
241-
clawdbot_repo_url: "https://github.com/YOUR_USERNAME/clawdbot.git"
242-
clawdbot_repo_branch: "feature-branch"
241+
openclaw_repo_url: "https://github.com/YOUR_USERNAME/openclaw.git"
242+
openclaw_repo_branch: "feature-branch"
243243
tailscale_authkey: "tskey-auth-xxxxxxxxxxxxx"
244244
EOF
245245

@@ -249,39 +249,39 @@ ansible-playbook playbook.yml --ask-become-pass -e @vars.yml
249249

250250
### 3. Edit Defaults Directly
251251

252-
Edit `roles/clawdbot/defaults/main.yml` before running the playbook.
252+
Edit `roles/openclaw/defaults/main.yml` before running the playbook.
253253

254254
### Available Variables
255255

256256
| Variable | Default | Description |
257257
|----------|---------|-------------|
258-
| `clawdbot_user` | `clawdbot` | System user name |
259-
| `clawdbot_home` | `/home/clawdbot` | User home directory |
260-
| `clawdbot_install_mode` | `release` | `release` or `development` |
261-
| `clawdbot_ssh_keys` | `[]` | List of SSH public keys |
262-
| `clawdbot_repo_url` | `https://github.com/clawdbot/clawdbot.git` | Git repository (dev mode) |
263-
| `clawdbot_repo_branch` | `main` | Git branch (dev mode) |
258+
| `openclaw_user` | `openclaw` | System user name |
259+
| `openclaw_home` | `/home/openclaw` | User home directory |
260+
| `openclaw_install_mode` | `release` | `release` or `development` |
261+
| `openclaw_ssh_keys` | `[]` | List of SSH public keys |
262+
| `openclaw_repo_url` | `https://github.com/openclaw/openclaw.git` | Git repository (dev mode) |
263+
| `openclaw_repo_branch` | `main` | Git branch (dev mode) |
264264
| `tailscale_authkey` | `""` | Tailscale auth key for auto-connect |
265265
| `nodejs_version` | `22.x` | Node.js version to install |
266266

267-
See [`roles/clawdbot/defaults/main.yml`](roles/clawdbot/defaults/main.yml) for the complete list.
267+
See [`roles/openclaw/defaults/main.yml`](roles/openclaw/defaults/main.yml) for the complete list.
268268

269269
### Common Configuration Examples
270270

271271
#### SSH Keys for Remote Access
272272

273273
```bash
274274
ansible-playbook playbook.yml --ask-become-pass \
275-
-e "clawdbot_ssh_keys=['ssh-ed25519 AAAAC3... user@host']"
275+
-e "openclaw_ssh_keys=['ssh-ed25519 AAAAC3... user@host']"
276276
```
277277

278278
#### Development Mode with Custom Repository
279279

280280
```bash
281281
ansible-playbook playbook.yml --ask-become-pass \
282-
-e clawdbot_install_mode=development \
283-
-e clawdbot_repo_url=https://github.com/YOUR_USERNAME/clawdbot.git \
284-
-e clawdbot_repo_branch=feature-branch
282+
-e openclaw_install_mode=development \
283+
-e openclaw_repo_url=https://github.com/YOUR_USERNAME/openclaw.git \
284+
-e openclaw_repo_branch=feature-branch
285285
```
286286

287287
#### Tailscale Auto-Connect
@@ -297,5 +297,5 @@ MIT - see [LICENSE](LICENSE)
297297

298298
## Support
299299

300-
- Clawdbot: https://github.com/clawdbot/clawdbot
301-
- This installer: https://github.com/pasogott/clawdbot-ansible/issues
300+
- OpenClaw: https://github.com/openclaw/openclaw
301+
- This installer: https://github.com/openclaw/openclaw-ansible/issues

0 commit comments

Comments
 (0)