rayclaw

One-command setup for a fully-featured OpenClaw environment. Installs all dependencies, tools, MCP servers, skills, and workspace templates so you can get running by just filling in your API keys and logging into OAuth providers.

Quick Start

bash <(curl -sL https://raw.githubusercontent.com/YOU/rayclaw/main/install.sh)

Or clone and run locally:

git clone https://github.com/YOU/rayclaw.git
cd rayclaw
bash install.sh

What Gets Installed

System Runtimes

• Node.js 22+ (via n)
• pnpm (package manager)
• Go 1.24+
• Python 3.11+ with packages: llama_cpp_python, fastapi, diskcache, distro, uvicorn, httpx, pydantic
• Ollama with models: glm-5:cloud, kimi-k2.5:cloud

Global npm Packages

Package	Purpose
openclaw	Multi-channel AI gateway
firecrawl-cli	Web scraping/crawling
mcporter	MCP server/tool CLI
n8n	Workflow automation
clawdhub	Skill registry CLI
pinchtab	(utility)
@google/gemini-cli	Google Gemini CLI
@kilocode/cli	KiloCode CLI
@openai/codex	OpenAI Codex CLI
@steipete/oracle	Oracle knowledge tool
vercel	Vercel deployment CLI

OpenClaw Extensions

• openclaw-web-search — Web search via Ollama

Skills (39 personal + bundled)

All your personal skills from ~/.agents/skills/ including:

• mcp-builder — Create MCP servers
• firecrawl — Web scraping skill
• autopilot, ralph, ecomode, pipeline — Agent modes
• frontend-design, frontend-ui-ux, web-artifacts-builder — UI tools
• canvas-design, algorithmic-art — Visual design
• git-master, code-review, security-review — Dev tools
• saas-builder, build-fix, deepinit — Project tools
• And 20+ more

Workspace Templates

Blank templates scaffolded to ~/clawd/:

• AGENTS.md — Agent behavior and conventions
• SOUL.md — Identity and capabilities
• TOOLS.md — Available tools and groups
• USER.md — Your profile (fill in)
• IDENTITY.md — System identity and providers
• MEMORY.md — Memory system config

Post-Setup Checklist

After running the installer, complete these steps:

1. Configure API Keys

Edit ~/.openclaw/openclaw.json and replace all YOUR_* placeholders:

// ZAI provider
"zai": { "apiKey": "YOUR_ZAI_API_KEY" }

// Skills
"skills": {
  "entries": {
    "openai-whisper-api": { "apiKey": "YOUR_OPENAI_API_KEY" },
    "sag": { "apiKey": "YOUR_SAG_API_KEY" }
  }
}

2. OAuth Logins

Run these once per provider to authenticate:

openclaw login --provider qwen-portal
openclaw login --provider google-gemini-cli
openclaw login --provider minimax-portal

3. Copilot Proxy

The copilot-proxy provider expects a proxy running on localhost:3000. Set this up separately. The config points to http://localhost:3000/v1.

4. Telegram

1. Create a bot via @BotFather
2. Set the token in channels.telegram.botToken
3. Add your Telegram user ID to channels.telegram.allowFrom
4. Verify: openclaw channels status --probe

5. Tailscale (Optional)

For remote access:

tailscale login
tailscale up

Then set gateway.tailscale.mode to "funnel" or "serve" in openclaw.json.

6. Verify

openclaw --version
openclaw doctor
openclaw gateway run --bind loopback --port 18789

Config Template

A sanitized config template is at config/openclaw.template.json. All secrets are replaced with YOUR_* placeholders. Copy it to ~/.openclaw/openclaw.json and fill in your values.

Updating OpenClaw

OpenClaw itself is installed from npm. Update with:

npm install -g openclaw@latest

Or if you cloned the source repo, pull from upstream:

cd ~/openclaw && git pull origin main && pnpm install && pnpm build

Directory Structure

rayclaw/
├── install.sh                 # One-liner setup script
├── README.md                  # This file
├── .env.example               # Environment variables template
├── config/
│   └── openclaw.template.json # Sanitized config template
├── workspace/
│   ├── AGENTS.md
│   ├── SOUL.md
│   ├── TOOLS.md
│   ├── USER.md
│   ├── IDENTITY.md
│   └── MEMORY.md
├── skills/                    # Personal skills (39 total)
│   ├── mcp-builder/
│   ├── firecrawl/
│   ├── autopilot/
│   └── ...
└── extensions/
    └── openclaw-web-search/   # Web search extension

License

MIT