First Run - profClaw

Start the Server

Standard
Daemon
Docker

profclaw serve

Starts the HTTP server at http://localhost:3000. Output includes connected providers and chat channels.

profclaw daemon start

Runs profClaw as a background service that persists after you close the terminal. Check status with profclaw daemon status.

docker start profclaw

Or if using Docker Compose: docker compose up -d

Access the Web UI

Open http://localhost:3000 in your browser. You will see the profClaw web chat interface (WebChat provider).

If the port is already in use, set a different one with PORT=3001 profclaw serve or via the PORT environment variable in your configuration.

Send Your First Message

Type a message in the chat input:

What can you help me with?

profClaw responds with its capabilities based on your configured tools and providers. The response varies by deployment mode - pro mode has access to all 77+ tools, while pico mode provides a focused essential set.

Try the CLI Chat

Interact directly from your terminal without opening a browser:

profclaw chat

This opens an interactive terminal session:

profClaw v2.x.x - Interactive Chat
Type /help for commands, /exit to quit
--------------------------------------

You: Summarize the README.md in this directory

Agent: I'll read the README.md file and summarize it for you.

[Tool: read_file] Reading README.md...

Here's a summary of the README:
...

Pass a one-shot message without entering the interactive session:

profclaw chat "What is the current directory?"

Try the TUI

For a richer terminal experience with panels and syntax highlighting:

profclaw tui

The TUI provides a split-pane view with the conversation on one side and tool execution output on the other.

Use Tools

profClaw agents have access to tools. Try asking:

List the files in the current directory
Search for TODO comments in my codebase
Create a new file called hello.txt with "Hello World"
Run my test suite
Fetch the content of https://example.com

Tools are subject to your security policy. In standard mode, destructive operations like shell execution require explicit approval before they run. Use profclaw config set security.mode permissive for unrestricted local development only.

See Tools Overview for the full list of available tools and how model-aware tier routing works.

Use Skills

Skills are pre-built expertise modules invoked with slash commands:

/commit
/review-pr 42
/summarize src/
/web-research "Hono middleware patterns"

See Skills Overview for all 50 built-in skills and how to create your own.

API Access

Send messages programmatically via the REST API:

curl -X POST http://localhost:3000/api/chat/message \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello profClaw", "provider": "anthropic"}'

The API returns a streaming JSON response with tool calls and the final message. See the API Reference for full documentation.

Next Steps

Deployment Modes

Understand pico, mini, and pro modes and what each enables.

Tools Overview

Explore the 77+ built-in tools and how execution works.

AI Providers

Configure additional AI providers and model aliases.

Chat Providers

Connect Slack, Discord, Telegram, or other chat channels.

​Start the Server

​Access the Web UI

​Send Your First Message

​Try the CLI Chat

​Try the TUI

​Use Tools

​Use Skills

​API Access

​Next Steps

Deployment Modes

Tools Overview

AI Providers

Chat Providers

Start the Server

Access the Web UI

Send Your First Message

Try the CLI Chat

Try the TUI

Use Tools

Use Skills

API Access

Next Steps